Bt Builder: Editor

Main - News - Bt Builder vs. BTCS - Editor - Mailing List - GitHub


The editor for Bt Builder is very primative. To start the editor you simply press 'e' instead of pressing enter to play a module. From here you see the editor selection screen.

Depending on the file you select it loads the appropriate editor.

Map Editor

The map editor works similar to the BTCS. Unlike the BTCS the arrow keys move you in the specified direction. To change facing press End or PgDn for left or right respectively. In addition to 's', 'c', and 'l' from BTCS, it support 'r' to resize the map and 'p' for the preferences screen. If the map is too large to fit on one screen, the map will scroll when you move past the view section.

The preference screen allows you to set the name, type, light, and monster level of the map. Type specifies the tiles used for the map. Light is the amount of natural light for the map. Usually you would set this to 5 for the city or wilderness and 0 for other dungeons type. Values lower than 5 can be set but no testing has been done on the graphics. Levels higher than 5 don't do anything more than 5. Monster level determines the power of the wandering monsters. Finally you can add the percentage chance of encountering groups of monsters.

If you press 's', it brings up a list of specials. You can then place a special by finding the one you want and pressing enter. If instead you press 'e', you will open the special editor.

The special editor is fairly different from the BTCS version. It starts with name like BTCS. The next item is Flags. This allows you to specify that the square has darkness, anti-magic and other traits. Next comes the list of commands but in a different format. You will see "<New Operation>". Under if statements you also have the option to add new operations. Pressing insert will insert a new statement above the current statement. The delete key will remove the current line.

Editing a command does not prepopulate with the previous information. If you edit a print statement, you will need to select the print command again and reenter the entire text. There are no suggestions or error checking on values. To some degree this is due to Bt Builder having less restrictions but it does allow you to enter bad data.

Item Editor

Spell Editor

The Bt Builder spell editor has more flexibility than BTCS allowed. Multiple effects can be added to a spell. Each effect with a saving throw is saved separately. The properties on that effect are shown indented under the type of the effect. Not all properties are supported under the old BTCS file formats. Currently the editor will automatically convert the file to the Bt Builder format if the spells need that functionality. In the future there may be a mode to lock the functionality only to that available in the BTCS.

The damage and various bonus spells have new properties called Level Increment and Maximum. A Level Increment of zero does nothing. A higher level increment will cause the system to multiply the number of dice or bonus by the caster's level divided by the level increment. If maximum is not zero, it will cap the number of dice/bonus.

The following chart shows how to create spells available in BTCS.

BTCS TypeBt Builder EffectAdditional Settings
HealHealNone
ResurrectResurrectNone
Cure PoisonCure StatusStatus: Poisoned
Cure InsanityCure StatusStatus: Insane
YouthCure StatusStatus: Aged
DispossessCure StatusStatus: Possessed
Stone to FleshCure StatusStatus: Stoned
Cure ParalysisCure StatusStatus: Paralyzed
Restore Lost LevelsCure StatusStatus: Level drained
DamageDamageNone
KillDamageDamage: 0d2, Extra Damage: Critical hit
PoisonDamageDamage: 0d2, Extra Damage: Poison
Cause InsanityDamageDamage: 0d2, Extra Damage: Insanity
AgeDamageDamage: 0d2, Extra Damage: Aging
PossessDamageDamage: 0d2, Extra Damage: Possession
Flesh to StoneDamageDamage: 0d2, Extra Damage: Stoned
ParalyzeDamageDamage: 0d2, Extra Damage: Paralysis
Summon MonsterSummon MonsterNone
Summon IllusionSummon IllusionNone
Dispell IllusionDispell IllusionNone
Scry SightScry SightNone
LightLightIllumination: 5
Armor Class BonusArmor Class BonusNone
Hit BonusHit BonusNone
Trap DestructionTrap DestructionNone
Secret Door DetectionSecret Door DetectionNone
Phase DoorPhase DoorNone
Dispell MagicDispell MagicNone
Regenerate Bard SongRegenerate SkillSkill: Bard Song, Amount: 0d2+<value>
Damage by LevelDamageLevel Increment: 1

Monster Editor