-
Notifications
You must be signed in to change notification settings - Fork 6
Arena config explanation
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.
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>, (...)
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.
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.
This setting determines if the players hunger bar can go down while in the arena.
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
This section contains settings for the usage of commands in arenas.
Command_Settings:
Commands_Disabled: <true/false>
Allowed_Commands: <command>, (...)
This setting determines if all commands except the listed commands in the setting Allowed_Commands will be disabled in the arena.
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
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>, (...)
This setting determines the game duration in seconds.
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.
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.
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..
This section contains settings for the automatic start system of the arena.
Automatic_Start:
Enabled: <true/false>
Percent: <amount>
Player_Amount: <amount>
This setting determines if the automatic start system should be enabled for this arena.
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%.
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.
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>, (...)
This setting determines if the time remaining messages should be enabled for this arena.
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
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>
This setting determines if powerups are enabled in this arena.
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
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>
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>
This section contains settings especially for item rewards.
Item_Rewards:
Enabled: <true/false>
Items: <itemID-amount> OR <itemID-amount-data>, (...)
This setting determines if item rewards are enabled in this arena.
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
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>
This setting determines if money reward is enabled in this arena.
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.