Difference between revisions of "Wanted"
From SupaHam
(Changed Configuration column width) |
(Added config.yml documentation) |
||
Line 13: | Line 13: | ||
Note: For every period in the configuration's name as listed below, that means you indent it one level below the previous. | Note: For every period in the configuration's name as listed below, that means you indent it one level below the previous. | ||
+ | |||
+ | === config.yml === | ||
+ | |||
+ | {| class="wiki-table" | ||
+ | ! width="240"| Configuration | ||
+ | ! width="100"| Value | ||
+ | ! Description | ||
+ | |- | ||
+ | | lobby-mode || Boolean || Whether the plugin should enable it's lobby features, or all game features. | ||
+ | |- | ||
+ | | test-mode || Boolean || Whether the plugin should enable in testing mode and disable updating player stats, enabling test commands, etc. | ||
+ | |- | ||
+ | | mysql.ip || String || MySQL ip address to connect to. | ||
+ | |- | ||
+ | | mysql.port || String || MySQL port. | ||
+ | |- | ||
+ | | mysql.user || String || MySQL username. | ||
+ | |- | ||
+ | | mysql.pass || String || MySQL password. | ||
+ | |- | ||
+ | | mysql.database || String || MySQL database. | ||
+ | |- | ||
+ | | mysql.tables.players || String || MySQL Players table (stores player information, such as kills). | ||
+ | |- | ||
+ | | lobby.countdown || Integer || Duration (in seconds) until the game begins. | ||
+ | |- | ||
+ | | arena.max-time || Integer || Duration (in minutes) until the game ends. | ||
+ | |- | ||
+ | | points.name || String || Name of the in-game points system. | ||
+ | |- | ||
+ | | points.kill-reward || Integer || Amount of points to reward a player for getting a kill. | ||
+ | |- | ||
+ | | points.death-reward || Integer || Amount of points to reward a player for dying. | ||
+ | |- | ||
+ | | points.win-reward || Integer || Amount of points to reward a player for winning a game. | ||
+ | |- | ||
+ | | points.loss-reward || Integer || Amount of points to reward a player for losing a game. | ||
+ | |- | ||
+ | | listeners.enabled.chat-listener || Boolean || Whether this plugin should handle chat messages. | ||
+ | |- | ||
+ | | listeners.enabled.motd-listener || Boolean || Whether this plugin should handle server MOTD messages (changes according to the game state). | ||
+ | |- | ||
+ | | listeners.enabled.misc-listener || Boolean || Whether this plugin should handle default game mechanics, such as disabling rain, crafting, picking up/dropping items, etc. | ||
+ | |- | ||
+ | | group.<name>.color || String || Display name colors to assign to players in this group | ||
+ | |- | ||
+ | | group.<name>.multiplier || Double || The number to multiply any points players in this group receive by. | ||
+ | |- | ||
+ | | miscellaneous.message-prefix || String || The prefix to be displayed in certain messages. (Can be empty) | ||
+ | |- | ||
+ | | miscellaneous.max-players || Integer || The maximum amount of regular players allowed on the server. | ||
+ | |- | ||
+ | | miscellaneous.max-reserved || Integer || The amount of reserved slots on the server. | ||
+ | |- | ||
+ | | miscellaneous.minimum-players || Integer || The amount of players required for the game to begin. | ||
+ | |- | ||
+ | | miscellaneous.idle-kick || Integer || Duration (in seconds) before a player gets kicked for being dead too long. | ||
+ | |- | ||
+ | | miscellaneous.hub-command || String || Command to execute when the game is over. (Leave empty for no command) | ||
+ | |- | ||
+ | | miscellaneous.debug-messages || Boolean || Whether this plugin should output debug messages to the log. | ||
+ | |- | ||
+ | | miscellaneous.compass-scramble || Integer || The distance between a player and their target till their compass starts scrambling. | ||
+ | |- | ||
+ | | miscellaneous.cooldown || Integer || Duration (in seconds) before players can join again after a game has ended. | ||
+ | |} | ||
+ | |||
=== arenas.yml === | === arenas.yml === | ||
Revision as of 21:35, 18 August 2013
Format
Copied from: http://wiki.sk89q.com/wiki/WorldEdit/Configuration/Bukkit
The file is written in the YAML format and you must follow these guidelines:
- Do not use tabs. You MUST use spaces or Bukkit will complain. If you use an editor like Notepad++ (recommended for Windows users), you must configure it to "replace tabs with spaces." In Notepad++, this can be changed in Settings > Preferences > Language Menu.
- Don't get rid of the indents. They are indented so some entries are in categories (like "max-blocks-changed" is in the "limits" category.
- If you want to check the format of this file before putting it into WorldEdit, paste it into http://yaml-online-parser.appspot.com/ and see if it gives "ERROR:".
- Lines starting with # are comments and so they are ignored.
Configuration
Note: For every period in the configuration's name as listed below, that means you indent it one level below the previous.
config.yml
Configuration | Value | Description |
---|---|---|
lobby-mode | Boolean | Whether the plugin should enable it's lobby features, or all game features. |
test-mode | Boolean | Whether the plugin should enable in testing mode and disable updating player stats, enabling test commands, etc. |
mysql.ip | String | MySQL ip address to connect to. |
mysql.port | String | MySQL port. |
mysql.user | String | MySQL username. |
mysql.pass | String | MySQL password. |
mysql.database | String | MySQL database. |
mysql.tables.players | String | MySQL Players table (stores player information, such as kills). |
lobby.countdown | Integer | Duration (in seconds) until the game begins. |
arena.max-time | Integer | Duration (in minutes) until the game ends. |
points.name | String | Name of the in-game points system. |
points.kill-reward | Integer | Amount of points to reward a player for getting a kill. |
points.death-reward | Integer | Amount of points to reward a player for dying. |
points.win-reward | Integer | Amount of points to reward a player for winning a game. |
points.loss-reward | Integer | Amount of points to reward a player for losing a game. |
listeners.enabled.chat-listener | Boolean | Whether this plugin should handle chat messages. |
listeners.enabled.motd-listener | Boolean | Whether this plugin should handle server MOTD messages (changes according to the game state). |
listeners.enabled.misc-listener | Boolean | Whether this plugin should handle default game mechanics, such as disabling rain, crafting, picking up/dropping items, etc. |
group.<name>.color | String | Display name colors to assign to players in this group |
group.<name>.multiplier | Double | The number to multiply any points players in this group receive by. |
miscellaneous.message-prefix | String | The prefix to be displayed in certain messages. (Can be empty) |
miscellaneous.max-players | Integer | The maximum amount of regular players allowed on the server. |
miscellaneous.max-reserved | Integer | The amount of reserved slots on the server. |
miscellaneous.minimum-players | Integer | The amount of players required for the game to begin. |
miscellaneous.idle-kick | Integer | Duration (in seconds) before a player gets kicked for being dead too long. |
miscellaneous.hub-command | String | Command to execute when the game is over. (Leave empty for no command) |
miscellaneous.debug-messages | Boolean | Whether this plugin should output debug messages to the log. |
miscellaneous.compass-scramble | Integer | The distance between a player and their target till their compass starts scrambling. |
miscellaneous.cooldown | Integer | Duration (in seconds) before players can join again after a game has ended. |
arenas.yml
Configuration | Value | Description |
---|---|---|
load | String | The name of the arena that the server should load up. |
name.* | String | The name of the arena (Must not change once set). It is recommended to keep all characters lowercase and use "_" instead of white spaces. If players bought the map prior to the name changing, the plugin will fail to register the players as an owner of this arena. |
name.alias | String | Alias name of the arena (The name that players will visually see. |
name.description | String | Description of the arena (Displayed when the game starts or in the shop) |
name.point1 | Location | First cuboid point location of the arena |
name.point2 | Location | Second cuboid point location of the arena |
name.spawns | List(Location) | Locations where a player can spawn in the arena. |
name.price | Integer | The amount of points required to purchase this item, if price is bigger than 0 then players that do not own it will not be able to join the game. Use -1 to disable purchasing it. |
name.must-own | Boolean | Whether players must own this arena to join the server. |
classes.yml
Default
Configuration | Value | Description |
---|---|---|
classes.<name> | String | Changing this will break the plugin. |
classes.<name>.enabled | Boolean | Whether to enable or disable this class. By disabling the class, no players will be able to use it and will automatically unequip it when they join. |
classes.name.alias | String | Alias name of the class (The name that players will visually see). |
classes.name.description | String | Description of the class (Displayed in the shop). |
classes.name.price | Integer | The amount of points required to purchase this class. Use -1 to disable purchasing it. |
classes.name.shop-icon | Item | The item to be displayed in the shop gui. |
Archer
Configuration | Value | Description |
---|---|---|
arrows | Integer | Amount of arrows players get when respawning. |
power-damage | Integer | Level of the damage enchantment on the bow. |
infinity | Boolean | Whether the bow should have infinity. |
Arsonist
Configuration | Value | Description |
---|---|---|
ticks | Integer | Amount of ticks (a second is 20 ticks) till it blows up. |
tnts | Integer | Amount of tnts players get upon respawning. |
Froster
Configuration | Value | Description |
---|---|---|
freeze-time | Integer | Duration (in seconds) the player stays frozen. |
snowballs | Integer | Amount of snowballs players get upon respawning. |
Scorcher
Configuration | Value | Description |
---|---|---|
item | Integer | id of the item to give the player |
chance | Integer | The chance of the Scorcher setting their target on fire. |
Scout
Configuration | Value | Description |
---|---|---|
potion-amplifier | Integer | Level of speed effect the player gets upon respawning |
Toxic
Configuration | Value | Description |
---|---|---|
potion-duration | Integer | Duration (in seconds) the poison effect lasts. |
potion-amplifier | Integer | Level of the posion effect. |
potions | Integer | Amount of poison potions players get upon respawning. |
equipments.yml
Default
Configuration | Value | Description |
---|---|---|
equipments.<name> | String | Changing this will break the plugin. |
equipments.<name>.enabled | Boolean | Whether to enable or disable this equipment. By disabling the equipment, no players will be able to use it and will automatically unequip it when they join. |
equipments.<name>.alias | String | Alias name of the equipment (The name that players will visually see). |
equipments.<name>.description | String | Description of the equipment (Displayed in the shop). |
equipments.<name>.price | Integer | The amount of points required to purchase this equipment. Use -1 to disable purchasing it. |
End Stone Helmet
Configuration | Value | Description |
---|---|---|
potion-duration | Integer | Duration (in seconds) the resistance effect lasts. |
potion-amplifier | Integer | Level of the resistance effect. |
Glass Helmet
Configuration | Value | Description |
---|---|---|
potion-duration | Integer | Duration (in seconds) the night vision effect lasts. |
Ice Helmet
Configuration | Value | Description |
---|---|---|
potion-duration | Integer | Duration (in seconds) the speed effect lasts. |
potion-amplifier | Integer | Level of the speed effect. |
Obsidian Helmet
Configuration | Value | Description |
---|---|---|
resistance-potion-duration | Integer | Duration (in seconds) the resistance effect lasts. |
resistance-potion-amplifier | Integer | Level of the resistance effect. |
slowness-potion-duration | Integer | Duration (in seconds) the slowness effect lasts. |
slowness-potion-amplifier | Integer | Level of the slowness effect. |
Quartz Helmet
Configuration | Value | Description |
---|---|---|
distance | Integer | Distance when the players' target's compass starts scrambling. |
Sponge Helmet
Configuration | Value | Description |
---|---|---|
potion-duration | Integer | Duration (in seconds) the absorption effect lasts. |
potion-amplifier | Integer | Level of the absorption effect. |
TnT Helmet
Configuration | Value | Description |
---|---|---|
heal-percentage | Integer | A percentage of the amount to heal. 0 being none, 100 being all damage. |