======Battle Editor======
----

The **Battle Editor** allows you to set up any predefined [[battle|battles]] for your game. The only [[combat_systems|combat system]] currently available in RPG in a Box is a very basic tactical turn-based system, so there are only a few settings to configure for each [[battle]] until combat is built out some more.

To add a [[battle]], click the "New Battle" button ({{:wiki:new_resource.png?nolink|}}) on the Battle Editor toolbar. This will add a new [[battle]] to the list of [[battle|battles]] on the left. Selecting a [[battle]] from this list will allow you to configure its settings using the detail panel on the right. Refer to the table below for an explanation of each setting.

^Setting^Description^
|Name|Name of the [[battle]] (should be unique). This name is used when triggering a [[battle]] with the [[Start Battle]] scripting function.|
|Map|[[Map]] to use for the [[battle]]. This would typically be a small, standalone [[map]] designed specifically for combat. It will be loaded when the [[battle]] starts, then the player will be returned to the previous [[map]] once the [[battle]] is complete. The [[map]] should contain [[tile]] [[groups]] named "player_spawn" and "enemy_spawn" to define possible starting locations for the player and the [[enemy|enemies]].|
|Enemies in Battle|List of [[enemy]] types that will potentially spawn for the [[battle]]. These can be added by double-clicking an [[enemy]] type from the "Available Enemies" list. [[Enemy]] types are defined in the [[Enemy Editor]].|
|Minimum/Maximum|Determines how many of the selected [[enemy]] type will spawn. A random value between the minimum and maximum value is selected at the start of the [[battle]]. For example, a minimum of 2 and a maximum of 4 indicates that there will be no less than 2 and no more than 4 of that particular [[enemy]] type.|

{{:wiki:battle_editor.png?nolink|}}

~~NOTOC~~