Skip to content

Arena config explanation

DarkBlade12 edited this page Oct 12, 2013 · 12 revisions

At this page are the parts of the arena config explained. It's shown which values are suitable for the different settings and what they actually do.

❯ Section General_Settings

This section contains all general settings like the edit mode, if hunger should be disabled etc.

General_Settings:
  Edit_Mode: <true/false>
  Require_Empty_Inventory: <true/false>
  Hunger_Disabled: <true/false>
  Ignored_Block_Ids: <id>, (...)
  Command_Settings:
   Commands_Disabled: <true/false>
   Allowed_Commands: <command>, (...)

❯❯❯ Setting Edit_Mode

This setting determines if the arena is currently in edit mode or not. Arenas that are newly created have this always set to true. If an arena isn't in edit mode, no one can't build in the protection area, add new spawns or re-set the floor/protection area. If you haven't setup the arena you shouldn't change this to false since it tries to load the spawns and regions which aren't existent.

❯❯❯ Setting Require_Empty_Inventory

This setting determines if players that want to join have to have their inventory empty in order to be able join. However the players' inventory will be always saved and will be restored after the player leaves the arena.

❯❯❯ Setting Hunger_Disabled

This setting determines if the players hunger bar can go down while in the arena.

❯❯❯ List Ignored_Block_Ids

The ids listed here will be ignored by the paint which means that if the player runs over them they won't become colored wool blocks. The ids have to be always seperated with , , here are some examples: Correct: 20, 0, 5 Incorrect: 20,0,5

❯❯ Sub-Section Command_Settings

This section contains settings for the usage of commands in arenas.

 Command_Settings:
  Commands_Disabled: <true/false>
  Allowed_Commands: <command>, (...)

❯❯❯ Setting Commands_Disabled

This setting determines if all commands except the listed commands in the setting Allowed_Commands will be disabled in the arena.

❯❯❯ List Allowed_Commands

The commands listed here will be the only allowed commands in the arena if the setting Commands_Disabled is set to true. Something special here is that if you add a main command like pw, all subcommands and the main command will work. (/pw, /pw arenas,...) If you also add the subcommand like pw arenas only itself will work. The commands have to be always seperated with , , here are some examples: Correct: pw, list, msg Incorrect: pw,list,msg

❯ Section Game_Settings

This section contains all settings related to the game itself like the duration, countdown etc.

Game_Settings:
 Duration: <seconds>
 Countdown: <seconds>
 Default_Brush_Size: <amount>
 Mode: <default>
 Automatic_Start:
  Enabled: <true/false>
  Percent: <amount>
  Player_Amount: <amount>
 Time_Remaining_Messages:
  Enabled: <true/false>
  Time_Schedule: <seconds>, (...)

❯❯❯ Setting Duration

This setting determines the game duration in seconds.

❯❯❯ Setting Countdown

This setting determines the countdown duration in seconds. Note that players can join during the countdown so if you want to let the players have time to join while it's counting down you should set this to a higher value.

❯❯❯ Setting Default_Brush_Size

This setting determines the radius of the circle every player paints by default. It's recommended not to use very high values, which could cause lag.

❯❯❯ Setting Mode

This setting determines the game mode of the arena. Currently there's just the default mode (fill as much area as possible with your color), but other modes will come soon like Avoid the colors etc..

❯❯ Sub-Section Automatic_Start

This section contains settings for the automatic start system of the arena.

 Automatic_Start:
  Enabled: <true/false>
  Percent: <amount>
  Player_Amount: <amount>

❯❯❯ Setting Enabled

This setting determines if the automatic start system should be enabled for this arena.

❯❯❯ Setting Percent

This is the percentage value of ready players divided through all players in the arena when the arena will automatically start the countdown. For example you've set this to 50 and there are 2 players in the arena and one marks himself as ready the arena will start the countdown because 1/2 = 0.5 = 50%.

❯❯❯ Setting Player_Amount

This is the amount of players when the arena will automatically start the countdown. For example it's set to 4 and there are currently 3 players in the arena, now another player joins so there are now 4 players and the arena will start the countdown.

❯❯ Sub-Section Time_Remaining_Messages

This section contains settings for the time remaining messages that will be sent to all players in the arena at specific times.

 Time_Remaining_Messages:
  Enabled: <true/false>
  Time_Schedule: <seconds>, (...)

❯❯❯ Setting Enabled

This setting determines if the time remaining messages should be enabled for this arena.

❯❯❯ List Time_Schedule

The times listed here will be the schedule for the time remaining messages. The numbers have to be always seperated with , , here are some examples: Correct: 60, 90, 110 Incorrect: 60,90,110

❯ Section Powerup_Settings

This section contains all settings related to powerups.

Powerup_Settings:
 Powerups_Enabled: <true/false>
 Time_Schedule: <seconds>, (...)
 <mode>_Mode_Powerups:
  Big_Brush:
   Brush_Size: <amount>
   Duration: <seconds>
  Tiny_Brush:
   Brush_Size: <amount>
   Duration: <seconds>
  Empty_Paint:
   Duration: <seconds>
  Speed:
   Intensity: <amount>
   Duration: <seconds>
  Freeze:
   Duration: <seconds>
  Big_Blob:
   Blob_Size: <amount>
  Tiny_Blobs:
   Blob_Size: <amount>
   Blob_Amount: <amount>
  Advanced_Darkness:
   Duration: <seconds>
  Drunken:
   Intensity: <amount>
   Duration: <seconds>
  Slowness:
   Intensity: <amount>
   Duration: <seconds>
  Jumping:
   Jump_Height: <amount>
   Duration: <seconds>
  Color_Bombs:
   Bomb_Size: <amount>
   Bomb_Amount: <amount>
   Disappear_Duration:  <seconds>
  Immortal_Color:
   Duration: <seconds>
  Eraser:
   Eraser_Size: <amount>
   Duration: <seconds>
  Powerup_Magnet:
   Magnet_Range: <amount>
   Duration: <seconds>
  Dash:
   Dash_Amount: <amount>
   Disappear_Duration: <seconds>
  No_Borders:
   Duration: <seconds>

❯❯❯ Setting Powerups_Enabled

This setting determines if powerups are enabled in this arena.

❯❯❯ List Time_Schedule

The times listed here will be the schedule for the powerup dropping. The numbers have to be always seperated with , , here are some examples: Correct: 20, 40, 60 Incorrect: 20,40,60

❯❯ Sub-Section <mode>_Mode_Powerups

This section contains settings for the powerups of the specified mode. Currently there's just Default_Mode_Powerups, because there aren't any other modes yet. If any powerup section in this sub section is removed it won't be obtainable in this arena. If you want to know the effects and icons of each powerup click here.

 <mode>_Mode_Powerups:
  Big_Brush:
   Brush_Size: <amount>
   Duration: <seconds>
  Tiny_Brush:
   Brush_Size: <amount>
   Duration: <seconds>
  Empty_Paint:
   Duration: <seconds>
  Speed:
   Intensity: <amount>
   Duration: <seconds>
  Freeze:
   Duration: <seconds>
  Big_Blob:
   Blob_Size: <amount>
  Tiny_Blobs:
   Blob_Size: <amount>
   Blob_Amount: <amount>
  Advanced_Darkness:
   Duration: <seconds>
  Drunken:
   Intensity: <amount>
   Duration: <seconds>
  Slowness:
   Intensity: <amount>
   Duration: <seconds>
  Jumping:
   Jump_Height: <amount>
   Duration: <seconds>
  Color_Bombs:
   Bomb_Size: <amount>
   Bomb_Amount: <amount>
   Disappear_Duration:  <seconds>
  Immortal_Color:
   Duration: <seconds>
  Eraser:
   Eraser_Size: <amount>
   Duration: <seconds>
  Powerup_Magnet:
   Magnet_Range: <amount>
   Duration: <seconds>
  Dash:
   Dash_Amount: <amount>
   Disappear_Duration: <seconds>
  No_Borders:
   Duration: <seconds>

❯ Section Reward_Settings

This section contains all settings for winning rewards. Rewards will only distributed if the game ended naturally, that means the game duration is over. If it was stopped manually through a command, reload or too few players left in the arena no rewards will be distributed!

Reward_Settings:
 Item_Rewards:
  Enabled: <true/false>
  Items: <itemID-amount> OR <itemID-amount-data>, (...)
 Money_Reward:
  Enabled: <true/false>
  Money_Amount: <amount>

❯❯ Sub-Section Item_Rewards

This section contains settings especially for item rewards.

 Item_Rewards:
  Enabled: <true/false>
  Items: <itemID-amount> OR <itemID-amount-data>, (...)

❯❯❯ Setting Enabled

This setting determines if item rewards are enabled in this arena.

❯❯❯ List Items

The items listed here will be distributed to players who win a game in this arena. The data value is important if you want to give the player for example colored wool, charcoal, lapis lazuli or other items which differ through the data value. The items have to be always seperated with , , here are some examples: Correct: 266-10, 288-2, 351-10-4 Incorrect: 266-10,288-2,351-10-4

❯❯ Sub-Section Money_Reward

This section contains settings especially for a money reward. Note that you have to have Vault and an Economy plugin installed in order to make the plugin able to distribute the reward.

 Money_Reward:
  Enabled: <true/false>
  Money_Amount: <amount>

❯❯❯ Setting Enabled

This setting determines if money reward is enabled in this arena.

❯❯❯ Setting Money_Amount

This is the amount of money a player will gain when winning in this arena. This value can also be a point number like 123.456 or a normal number like 500.

Clone this wiki locally