Making a level for Battle Arena is mostly the same as making a level for any other episode. You can just save your level and its folder into the Battle Arena folder. However, in order to have it be playable in-game, you must also set up a config file.
In order to be playable, each level needs a file called "battleConfig.ini" in its folder and have the relevant fields set in it. An ini file can be edited using any standard text editor. You can see the included levels for examples on what these files look like.
Below is a list of all fields that can be set in a level's config file.
| Field | Description |
|---|---|
name |
The name displayed for the level in the level select menu. |
author |
The name displayed under the level's name for the level creator's name. |
mode1, mode2, etc. |
The modes that the level is playable on. The valid values are classic, stars, stone, and special. Special mode is explained later in this guide. |
useSeamlessWrap |
If true, enables seamless horizontal/vertical wrap. Seamless wrap only works on either horizontal or vertical wrap (not both at the same time), and has no effect in local split screen. |
minPlayers |
When set, the level will be greyed out and unselectable if there are fewer players in the room than this value. |
maxPlayers |
When set, the level will be greyed out and unselectable if there are more players in the room than this value. |
unplayableLocally |
If true, the level will be greyed out and unselectable when playing offline. |
unplayableOnline |
If true, the level will be greyed out and unselectable when playing online. |
musicCanSpeedUp |
If false, prevents the level's music from speeding up once somebody is close to winning or the time limit is nearly up. |
musicCanSpeedUp |
If false, prevents the level's music from speeding up once somebody is close to winning or the time limit is nearly up. |
musicSpedUpSpeed |
The speed the music plays at when sped up. Only affects streamed music formats (e.g. OGG). Defaults to 1.1, which means a 10% increase in speed. Note that an increase in speed also increases the pitch of the music. |
musicSpedUpTempo |
The tempo the music plays at when sped up. Only affects sequenced music formats (e.g. SPC or MIDI). Defaults to 1.3, which means a 30% increase in tempo. |
To add an icon that will be displayed on the level select screen, you just need to an image called "battleIcon.png" into your level's folder.
To match the icons of the default levels, this icon should be 160x100 pixels.
In order for your level to be played online, everyone in the room must have the level installed. Otherwise, it will be greyed out in the level selection.
Be aware that any custom script, NPC or block that you use must be multiplayer compatible. Some may also require modifications to work properly online. You should test that anything you use works both in local multiplayer and online before building your level around it.
For more, see the Script Writing Guide.
