The configuration file is located at /MBedwars/lobby-hotbar.yml.
Each section inside the file represents an item that will be given. The name of the section is the id of the item. The id may be anything, the only requirements are that it only persists of ASCII characters and that it is unique (there may not be multiple items with the same id).
Each item may include these configs:
| Name | Meaning | Default Value |
|---|---|---|
| name | The name that will be displayed. %<entry>% will be taken from the messages file. It is also possible to use color codes (e.g. &e for yellow) | id of the item |
| slot | The position of the player's hotbar at which the item will be placed at. Must range between 0 and 8 | 0 |
| handler | The id of the handler. Defines the effective behaviour when the item is being used. A list of all available ones can be found in the page below | null |
| item | The material that shall be shown as the icon in the hotbar. It uses this syntax | "STONE" |
| add-commands | Whether commands shall be executed when the item is being used. The commands will be run as if the player would wrote them himself, in case the config commands-as-console isn't set to true. Example: [ "say My name is {player}" ] | [ ] |
| commands-as-console | Whether the commands from the add-commands shall be executed from the console (means with OP; value = true permissions) or as if the player would write the commands themselves (value = false). | false |
| Name | Description |
|---|---|
| bedwars:view_achievements | Opens a GUI that displays all achievements that the player has obtained or hasn't obtained yet. There are certain configs within config.yml that begin with gui-spectatortp- with which you are able to modify the look-and-feel of it. |
| bedwars:force_start | Decreases lobby timer on use to the value of the forcestart-time config (located within config.yml). Item gets hidden in case the timer is already below that time. |
| bedwars:leave | Makes the player leave the arena and moves him to the hub. You may make the player wait for a certain time using the lobby-leaveitem-time config (located within config.yml) to avoid misclicks. |
| bedwars:select_team | Opens a GUI in which the player can select the team they want to be in. There are certain configs within config.yml that begin with gui-selectteam- with which you are able to modify the look-and-feel of it. |
| bedwars:vote_arena | Used for voting arenas only. Opens a GUI on use in which players can vote for which arena they want to play in. Gets hidden in case voting is inactive. |
Certain handlers (e.g. bedwars:vote_arena and bedwars:force_start) hide their items at certain conditions. By overlapping these over others by making them be on the same slot, you may add a certain order and conditions in which they are being displayed. For instance, in the default configurations, the select team item shares the same slot as the vote arena item. However, the select team item is only being shown if the players have already voted for an arena.
Also available at: https://pastebin.com/SFdt5HHU
Click to open:
########################
# Visit the wiki page for further info: https://s.marcely.de/mbww8
########################
view-achievements: # The unique id of this item. Is not bound to the type of the handler, just has to be unique from others.
name: '%Lobby_Item_Achievements%' # Will be shown when the player holds it on his hand / moves with his cursor over it
slot: 0 # The slot at which it's located at. Can go from 0 up to 8. 0 is the very left one.
handler: 'bedwars:view_achievements' # The handler of the item that determines what exactly happens when the item is being used.
item: 'nether_star' # The item stack that'll be placed at the given slot.
select-team:
name: '%Lobby_Item_SelectTeam%'
slot: 1
handler: 'bedwars:select_team'
item: 'leather_boots'
vote-arena:
name: '%Lobby_Item_VoteArena%'
slot: 1
handler: 'bedwars:vote_arena'
item: 'bed'
force-start:
name: '%Lobby_Item_ForceStart%'
slot: 4
handler: 'bedwars:force_start'
item: 'clock'
leave:
name: '%Lobby_Item_Leave%'
slot: 8
handler: 'bedwars:leave'
item: 'redstone'
# You're able to add custom items by simply copy & pasting the existing ones
# Only make sure that there aren't multiple items with the same id
# Furthmore, you might want to check out the API for adding your custom handlers