diff --git a/Setting-up-the-config-file.md b/Setting-up-the-config-file.md index 74a3a29..0e40a5b 100644 --- a/Setting-up-the-config-file.md +++ b/Setting-up-the-config-file.md @@ -93,17 +93,16 @@ This section is by far the largest, and it is divided into several smaller branc ### settings ### The settings-branch is quite extensive, and besides the `world`-node, it is basically just a bunch of toggles (on/off, true/false), though a few are number-based. -* `enabled: [true|false]` - If false, players cannot join the arena. * `world: ` - The name of the world the arena resides in. +* `enabled: [true|false]` - If false, players cannot join the arena. * `protect: [true|false]` - If false, the arena will not be protected from explosions and players breaking the blocks. -* `logging: [true|false]` - If true, at every arena end, relevant information about the arena session will be appended to a file `plugins/MobArena/logs/.log`. Note that there is no sort of limit on how big this file can become, so keep an eye on it. +* `logging: [true|false]` - **This setting is currently bugged, do not set to true!** If true, at every arena end, relevant information about the arena session will be appended to a file `plugins/MobArena/logs/.log`. Note that there is no sort of limit on how big this file can become, so keep an eye on it. +* `entry-fee: [$|:]` - Follows the exact same notation as the class items and rewards. `$20` will subtract 20 of whatever currency you use from the players upon joining. `$5, stick:2` will require the player to have 5 currency units and 2 sticks to join the arena. The entry-fee will be refunded if the player leaves before the arena starts. * `clear-wave-before-next: [true|false]` - If true, no monsters will spawn before all monsters of the previous wave have been slain. -* `detonate-creepers: [true|false]` - If true, all Creepers in the arena will be detonated right before the next wave spawns. Will not work with `clear-wave-before-next: true`. -* `detonate-damage: [true|false]` - If false, players will not take damage from the Creeper detonations (but they will still take damage from normal Creeper explosions). Requires `detonate-creepers: true`. +* `clear-boss-before-next: [true|false]` - If true, no new waves will spawn before the current boss (if any) is dead. * `lightning: [true|false]` - If true, every spawnpoint will be struck by lightning (no damage) on special waves. * `auto-equip-armor: [true|false]` - If true, armor pieces will automatically be equipped upon class selection. Note that this does not work if a class has more than 1 of an armor piece type. -* `force-restore: [true|false]` - If true, the arena region is saved on arena start, and rebuilt on arena end. This is useful if the arena is encased in Obsidian, and server hosts want a destructible arena. Note that with a large arena region, the server will "lag" for a few seconds on arena end and arena start. This is because the region is saved to the harddrive. -* `soft-restore: [true|false]` - If true, all destroyed blocks will be saved in a "repair list", which will be used to restore blocks at arena end. This is different from `force-restore` in that no data is saved to the harddrive - it is also much faster (no lag). Note that this setting, if true, ignores both `force-restore` and `protect`. +* `soft-restore: [true|false]` - If true, all destroyed blocks will be saved in a "repair list", which will be used to restore blocks at arena end. No data is saved to the harddrive. Note that this setting, if true, ignores the `protect` flag. * `soft-restore-drops: [true|false]` - If true, blocks destroyed by players will drop as items like they normally do (using pickaxes, spades, etc.). Note that this makes it very easy for classes with pickaxes to "mine the arena" and build forts. * `require-empty-inv-join: [true|false]` - If false, players' inventories will be saved upon joining, and restored upon death/leaving. * `require-empty-inv-spec: [true|false]` - If false, players can spectate the arena without having to empty their inventories. @@ -112,16 +111,22 @@ The settings-branch is quite extensive, and besides the `world`-node, it is basi * `monster-infight: [true|false]` - If false, monsters will no longer damage each other. * `allow-teleporting: [true|false]` - If false, all warping to and from the arena region is blocked. Useful for preventing players from summoning other players into the arena for help. * `spectate-on-death: [true|false]` - If false, players will not get warped to the spectator area, but instead be "kicked" from the arena (essentially a forced /ma leave). +* `auto-respawn: [true|false]` - If false, players will be greeted with the typical death screen upon dying in the arena, and will have to click the respawn button to respawn. With this setting at false, players will actually die in the arena, meaning plugins like Heroes and mcMMO will properly trigger their resetting of internal data upon respawn. * `share-items-in-arena: [true|false]` - If false, players will not be able to drop items in the arena. -* `entry-fee: [$|:]` - Follows the exact same notation as the class items and rewards. `$20` will subtract 20 of whatever currency you use from the players upon joining. `$5, stick:2` will require the player to have 5 currency units and 2 sticks to join the arena. -* `max-players: ` - Gives an upper limit on how many players may join the arena. The default of `0` means no limit. * `min-players: ` - Gives a lower limit on how many players are required to start the arena. The default of `0` is the same as `1`, which means 1 or more players may start the arena. +* `max-players: ` - Gives an upper limit on how many players may join the arena. The default of `0` means no limit. * `max-join-distance: ` - The maximum distance (in blocks) from which players can join or spectate the arena. If 0 (default), there is no limit. Note that the distance is calculated from every corner of the arena region, and that players not in the arena world won't be able to join or spectate. -* `repair-delay: