Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!


- Clickable messages
- Optional arena support
- Lots of customisation
- Arena only chat
- Arena holograms
- Schedule games
- Clickable join signs
- Multi version support
- PlaceholderAPI placeholders
- Inventory backups (Can be disabled)
- Fully customisable messages (Hex colour support)
- Reward system (Give permissions, money, items, experience or even run commands)
- Spectator system (Can be disabled)


Player commands
| Command | Permission | Description | Default |
|---|---|---|---|
| /game | tfquiz.player |
Negate this to remove access to all of the following commands | true |
tfquiz.player.* |
true | ||
| /game list | tfquiz.player.list |
Lists all the games available, along with its status and player count | true |
| /game join <ID> | tfquiz.player.join |
Allows player to join the game | true |
| /game leave | tfquiz.player.join |
Allows player to leave the game | true |
Admin commands
| Command | Permission | Description | Default |
|---|---|---|---|
| /tf | tfquiz.admin |
Allows access to the command | OP |
| /tf help | tfquiz.admin |
Access to the admin help command | OP |
| /tf list | tfquiz.admin |
Lists all the games | OP |
| /tf setspawn | tfquiz.admin |
Set the spawn point for logging in (can be disabled in config) | OP |
| /tf game <gameID> setspawn | tfquiz.admin |
Sets the arena spawn point for the specified game | OP |
| /tf game <gameID> open|close | tfquiz.admin |
Opens or closes the specified game. You cannot use this on games that have schedulers set up | OP |
| /tf game <gameID> start | tfquiz.admin |
Starts the countdown, and the game will begin once the countdown gets to 0. This bypasses the minimum required players, but there must be atleast 1 player in the game. You cannot use this on games that have schedulers set up | OP |
| /tf game <gameID> end | tfquiz.admin |
This ends the game at the end of that round. It will announce all those who remain in play as winners. Ending a game when its in the countdown stage, just stops the countdown, all players remain. You cannot use this on games that have schedulers set up | OP |
| /tf game <gameID> end -without | tfquiz.admin |
Use the flag “-without” to immediately end the game without any winners. You cannot use this on games that have schedulers set up | OP |
| /tf game <gameID> addPlayer|removePlayer <player> | tfquiz.admin |
Adds|Removes a player from the game | OP |
| /tf game <gameID> setHoloSpawn | tfquiz.admin |
Sets the hologram spawn location | OP |
| /tf game <gameID> info | tfquiz.admin |
Displays information about that configured game | OP |
| /tf reload | tfquiz.reload |
Reloads the plugin | None |
tfquiz.admin.bypassflags |
Allows that player to bypass all arena flags | OP |
Sign commands
| Command | Permission | Description | Default |
|---|---|---|---|
| /tf sign list | tfquiz.admin.sign |
Shows a list of all game signs | OP |
| /tf sign add <gameID> | tfquiz.admin.sign |
Adds a new game sign for the specified game | OP |
| /tf sign remove | tfquiz.admin.sign |
Deletes an game sign that you are looking at | OP |
| /tf sign remove <signID> | tfquiz.admin.sign |
Deletes an game sign with that specified sign ID | OP |
| /tf sign edit <signID> <lineNo> "Text..." | tfquiz.admin.sign |
Edits the text on the game sign with that specified sign ID. Alternatively you can also right click game signs to edit them | OP |
tfquiz.admin.sign |
Gives the ability to right-click a sign to edit the text | OP |

config.yml
## -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- ##
## True False Quiz ##
## By Soapiee ##
## ##
## Message me on Discord for support, feature requests, bug reports, etc ##
## discord.com/users/152044111153594369 ##
## -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- ##
# Sends a message in console if there is an update available
update_notification: true
# Choose which language file you want to use
# Options: lang_en, lang_es, lang_de, lang_fr, lang_nl
language: lang_en
# These only apply if a game has an arena
arena_flags:
allow_fall_damage: false # Should players take fall damage
allow_pvp_damage: false # Can players deal damage to other players
allow_hunger: false # Will a player lose hunger (they also cannot be satiated)
allow_block_break: false # Can players break blocks
allow_block_place: false # Can players place blocks
allow_teleport: false # Should players be able to teleport
# Whether to save a backup of player inventories to a file when they are in an arena or not
save_player_inventories: false
# Whether to clear players inventories when they join an arena (it will be restored when they leave the arena)
empty_inv_on_arena_join: true
# Prevent players who are not in Survival mode to join games
enforce_survival_mode: true
# When a player joins the server, they are teleported here. NOTE: If false and your server crashes, players who were in arenas, will physically re-join inside the arena map/location
enforce_lobby_spawn: false
# Where you want players to be teleported to after they leave an arena, or where they spawn on server join (if the above setting is true)
lobby_spawn:
world: world
x: 0
y: 64
z: 0
yaw: -180
pitch: 0
# List commands that you want to be disallowed whilst the player is in an arena
disallowed_commands:
- '/example1'
#signs:
# 1: # EXAMPLE
# game_ID: 1
# material: OAK_WALL_SIGN
# world: world
# x: 2
# y: 65
# z: 2
# facing: south
# format:
# - '%game_ID%'
# - '%game_state%'
# - ' '
# - '%game_players%/%game_maxplayers%'
games:
# # EXAMPLE 1 (without an arena)
1:
# Options: Recruiting or Closed
state_on_startup: RECRUITING
minimum_players: 5
maximum_players: 20
countdown_seconds: 10
# Maximum amount of rounds to reach before ending the game. It will end earlier if there is 1 player remaining
maximum_rounds: 10
# Whether to announce the winner of a game to the whole server
broadcast_winners: true
reward:
type: none
# reward: # EXAMPLE
# type: 'command' # Options: permission, currency, experience, item, command, none
# reward: 'xp give %player% 100'
message: You gained some experience for winning
arena: false
# (in seconds) Only works when the arena option is false.
# How long to wait before the game is opened
# schedule_delay: 300
# (in seconds) How long the game remains open and in the recruiting state, before it closes again (will not close if the game is active).
# Make sure this is longer than your countdown_seconds option. Defaults to 60 if this isn’t set.
# schedule_resets: 120
# # EXAMPLE 2 (with an arena)
# 2:
# # Options: Recruiting or Closed
# state_on_startup: RECRUITING
# minimum_players: 5
# maximum_players: 20
# countdown_seconds: 60
# maximum_rounds: 20
# # Whether to announce the winner of a game to the whole server
# broadcast_winners: true
# reward:
# type: 'item'
# reward: oak_planks, 2
# message: 'You won 2 oak planks'
# arena: true
# arena_options:
# # Options: ‘both’, ‘chat’ or ‘hologram’
# desc_option: hologram
# # Enables the spectator system
# spectators: true
# # The spawn point for the hologram (Only works if desc_option is not ‘chat’
# holo_location:
# world: world
# x: -50
# y: 64
# z: 64
# # The spawn point where players get teleported to when they join the game/arena
# spawn_point:
# world: world
# x: -50
# y: 64
# z: 64
# yaw: -180
# pitch: 0
messages.yml
## -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- ##
## English Language File ##
## -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- ##
# # # # ---> GENERAL MESSAGES <--- # # # #
console_usage_error: "&cYou must be a player to use this command"
no_permission: "&cYou do not have permission to use this command"
player_not_found: "&cPlayer not found"
hooked_placeholderapi: "&aHooked into PlaceholderAPI"
hooked_vault: "&aHooked into Vault"
hooked_vault_error: "&cError hooking into Vault"
# # # # ---> ADMIN COMMAND MESSAGES <--- # # # #
update_available: "&aThere is an update available for TFQuiz"
unsupported_version: "&cUnsupported version detected. Plugin may not function correctly. Contact the developer to get your version supported"
disable_spectators_warning:
- "&c[TFQuiz] Unsupported NMS version detected. The Spectator system will be diminished."
- "&cIts recommended that you disable it in the config. All other features will work as normal"
spectator_system_error: "&cERROR: The spectator system is not working. Contact the developer"
unsupported_platform_spigot: "&c[TFQuiz] Incorrect server platform detected. This plugin is designed to be ran on Spigot."
unsupported_platform_paper: "&c[TFQuiz] Incorrect server platform detected. This plugin is designed to be ran on Paper."
download_spigot_jar: "&c[TFQuiz] Please download the Spigot jar instead."
download_paper_jar: "&c[TFQuiz] Please download the Paper jar instead."
admin_command_usage:
- "#01d54a--------- Admin Help ---------"
- "#01d54a/tf reload &7- Reloads the plugin"
- "#01d54a/tf list &7- Lists all loaded games"
- "#01d54a/tf setspawn &7- Sets the lobby spawn"
- "#01d54a/tf game <gameID> setSpawn &7- Sets the spawn point of a specified game"
- "#01d54a/tf game <gameID> setHoloSpawn &7- Sets the hologram location of a specified game"
- "#01d54a/tf game <gameID> open|close &7- Manually opens or closes a game"
- "#01d54a/tf game <gameID> start &7- Starts the countdown of a game"
- "#01d54a/tf game <gameID> end [-without] &7- Ends a game. Use the flag \"-without\" to instantly end without winners."
- "#01d54a/tf game <gameID> addPlayer|removePlayer <player> &7- Adds|Removes a player from the game"
- "#01d54a/tf game <gameID> info &7- Displays information based on the games setup"
- "#01d54a/tf sign add <gameID> &7- Adds a new game sign for the specified game"
- "#01d54a/tf sign remove <signID> &7- Deletes a game sign"
- "#01d54a/tf sign edit <signID> <lineNo> text... &7- Edits the text on the game sign "
admin_reload_command_usage: "&cUsage: /tf reload"
admin_reload_success: "&aSuccessfully reloaded TFQuiz"
admin_reload_error: "&cRan into an error whilst reloading TFQuiz"
admin_reload_inprogress: "&eReloading configuration..."
reload_convo_cancel: "&cYou have cancelled the reload"
reload_convo_invalid: "&cPlease type 'CONFIRM' or 'CANCEL'"
reload_convo_start:
- "&cThis will force reset all games, all scheduled games, and return all players to the lobby spawn"
- "&cType 'confirm' to confirm the reload"
- "&cThis will time out in 10 seconds"
invalid_number_input: "&c%input% is not a valid number"
games_error: "&cPlease set up some games in the config.yml"
questions_error: "&cCould not find any questions inside questions.yml"
questions_file_error: "&cThe questions.yml could not be loaded"
logger_file_error: "&cThe logger.log file could not be created"
logger_log_success: "&cAn error was added to the logger.log file"
logger_log_error: "&cThe logger.log file could not be created"
inventories_file_error: "&cThe playerInventories.yml could not be loaded"
inventories_saving_error: "&cThere was an error saving %player%'s inventory to playerInventories.yml"
inventories_removing_error: "&cThere was an error removing %player%'s inventory to playerInventories.yml"
language_file_error: "&cThe language file could not be loaded"
language_field_error: "&cCould not add new fields to the language file"
invalid_language: "&cAn invalid language has been configured. Defaulting to \"lang_en\""
settings_error: "&cThe config field &e%field% &cis not set. Defaulting to &e%default_value%"
lobby_spawn_error: "&cYou must set a lobby spawn point in the config"
invalid_reward_type: "&cInvalid reward type for game &e%game_ID%&c. No reward will be given."
missing_reward_message: "&cThe reward message for game &e%game_ID%&c is missing. No message will be sent to the player."
missing_vault_hook: "&cThe reward for game &e%game_ID%&c requires Vault to be installed."
invalid_reward_number: "&cYou must input a number for the reward amount of game &e%game_ID%"
invalid_reward_amount: "&cThe amount for the reward of game &e%game_ID% &cis to low"
missing_reward: "&cThere is no reward defined for game &e%game_ID%"
invalid_reward_material: "&cThe reward for game &e%game_ID%&c has an invalid material"
invalid_reward_item: "&cThe reward for game &e%game_ID%&c has an invalid item. Follow this format: \"apple, 5\" (material, quantity)"
invalid_game_spawn: "&cThe spawn point for game &e%game_ID% &cis invalid."
admin_list_command_usage: "&cUsage: /tf list"
admin_setspawn_command_usage: "&cUsage: /tf setspawn"
admin_lobby_spawn_set: "&aThe Lobby spawn has been set"
game_admin_command_usage:
- "#01d54a--------- Game Help ---------"
- "#01d54a/tf game <gameID> setSpawn &7- Sets the spawn point of a specified game"
- "#01d54a/tf game <gameID> setHoloSpawn &7- Sets the hologram location of a specified game"
- "#01d54a/tf game <gameID> open|close &7- Manually opens or closes a game"
- "#01d54a/tf game <gameID> start &7- Starts the countdown of a game"
- "#01d54a/tf game <gameID> end [-without] &7- Ends a game. Use the flag \"-without\" to instantly end without winners."
- "#01d54a/tf game <gameID> addPlayer|removePlayer <player> &7- Adds|Removes a player from the game"
- "#01d54a/tf game <gameID> info &7- Displays information based on the games setup"
game_force_started: "&aGame &e%game_ID%'s &acountdown has begun!"
game_force_start_error: "&cError trying to start this game. It is already in play"
game_start_scheduler_error: "&cYou cannot manually start a game that has an active scheduler"
game_start_closed_error: "&cError trying to start this game. It is closed. Use /tf game <ID> open"
game_start_empty_error: "&cError trying to start this game. There are no players in this game"
game_force_ended: "&aGame &e%game_ID% &ahas been ended"
game_force_ended_with_winners: "&aGame &e(%game_ID%) &awill end at the end of the round"
game_force_end_error: "&cError trying to end this game. It is not currently in play"
game_end_scheduler_error: "&cYou cannot manually end a game that has an active scheduler"
game_player_removed_target: "&cYou have been removed from game %game_ID%"
game_spawn_set: "&aThe spawn has been set for game %game_ID%"
game_holo_spawn_set: "&aYou set the hologram spawn point for game %game_ID%"
game_holo_spawn_removed: "&aYou have removed the hologram spawn point"
game_opened: "&aGame %game_ID% has been opened to players"
game_opened_error: "&cGame %game_ID% is already active"
game_opened_scheduler_error: "&cYou cannot manually open a game that has an active scheduler"
game_closed: "&cGame %game_ID% is no longer accepting players"
game_closed_error: "&cGame %game_ID% cannot be closed right now"
game_closed_scheduler_error: "&cYou cannot manually close a game that has an active scheduler"
game_player_added: "&e%player% &ahas been added to game %game_ID%"
game_player_added_error: "&cThis game is not currently accepting new players"
game_invalid_gamemode_error_other: "&cThe player must be in survival mode to join this game"
game_player_already_in_game: "&e%player% &cis already in a game"
game_player_removed: "&e%player% &ahas been removed from game %game_ID%"
game_player_not_in_game: "&e%player% &cis not in that game"
game_info:
- "#01d54a--------- &lGame %game_ID% Info #01d54a---------"
- "#01d54aCurrent Status: &7%game_players%/%game_maxplayers% - %game_status%"
- "#01d54aMin required players: &7%game_minplayers%"
- "#01d54aCountdown: &7%game_countdown%"
- "#01d54aMax rounds: &7%game_maxrounds%"
- "#01d54aBroadcasts winner: &7%game_doesbroadcast%"
- "#01d54aReward: &7%game_reward%"
- "#01d54a "
- "#01d54a&lArena Specifics"
- "#01d54aHas arena: &7%game_hasarena%"
- "#01d54aHas scheduler: &7%game_hasscheduler% %game_schedulerseconds%"
- "#01d54aDescription option: &7%game_desc%"
- "#01d54aSpectators: &7%game_doesspectators%"
- "#01d54aHologram: &7%game_holocoordinates%"
- "#01d54aSpawn point: &7%game_spawncoordinates%"
# # # # ---> GAME MESSAGES <--- # # # #
game_state_closed: "Not available"
game_state_recruiting: "Recruiting"
game_state_countdown: "Starting soon"
game_state_live: "Game is active"
game_list_header: "--------- Games List ---------"
game_list_format: "&e> %game_ID% &7(%game_players%/%game_maxplayers%) &e- %game_status%"
game_list_hover_text: "&eClick to join"
game_opened_scheduler: "&eA new quiz game has opened. Use &a/game join %game_ID% &e to join the fun"
game_open_scheduler_hover: "&eClick to join"
game_closed_scheduler: "&eThe quiz &7(%game_ID%) &eis now closed as not enough players joined."
game_join: "&aYou have joined game %game_ID% &7(%game_players%/%game_minplayers%)"
game_other_player_join: "&a%player% joined the game &7(%game_players%/%game_minplayers%)"
game_invalid_gameID: "&cYou must enter a valid gameID"
game_invalid_state_error: "&cThis game is not currently accepting players"
game_invalid_gamemode_error: "&cYou must be in survival mode to join this game "
forced_game_leave: "&aAn admin removed you from game %game_ID%"
game_full_error: "&cThis game is full"
already_in_game_error: "&cYou are already in a game"
game_leave: "&cYou have left the game"
game_other_player_left: "&c%player% left the game &7(%game_players%/%game_minplayers%)"
error_game_leave: "&cYou are not in a game "
game_countdown_start: "&aThe game is starting in %countdown%"
game_countdown_title_prefix: "&a%countdown%"
game_countdown_title_suffix: "&euntil the game starts"
game_started: "&a&lTrue/False Game started"
game_description: "Answer the questions correctly with either true or false."
game_hologram_desc:
- "&e-----------------------------------"
- "&eAnswer the questions correctly"
- "&eYou can only answer with True or False"
- "&e-----------------------------------"
game_round_countdown_message: "&aYou have %round_countdown% to answer the question"
game_round_countdown_title_prefix: "&a%round_countdown%"
game_round_countdown_title_suffix: "&euntil the round ends"
game_not_enough_players: "&cThere are not enough players. Countdown has stopped"
game_below_min_required: "&cThe game has ended as too many players have left"
game_disallowed_command: "&cYou cannot use that command when in a game with an arena"
game_prompt:
- "&e-----------------------------------"
- " "
- "&6&lTrue or False? %question%"
- " "
- "&e-----------------------------------"
game_true_outcome_message:
- "&e-----------------------------------"
- "&eThe correct answer was"
- " "
- "&aTRUE"
- "&e%correction_message%"
- " "
- "&e-----------------------------------"
game_false_outcome_message:
- "&e-----------------------------------"
- "&eThe correct answer was"
- " "
- "&cFALSE"
- "&e%correction_message%"
- " "
- "&e-----------------------------------"
game_eliminate_message:
- "&e-----------------------------------"
- " "
- "&cYou have been eliminated!"
- " "
- "&e-----------------------------------"
game_continued_message:
- "&e-----------------------------------"
- " "
- "&aWell done! You continue to the next round.."
- " "
- "&e-----------------------------------"
game_win_message:
- "&e-----------------------------------"
- " "
- "&aCongratulations! You have won!"
- " "
- "&e-----------------------------------"
game_multi_player_broadcast:
- "&e-----------------------------------"
- " "
- "&a%winners% have all won &7(Game: %game_ID%)&a!"
- " "
- "&e-----------------------------------"
game_single_player_broadcast:
- "&e-----------------------------------"
- " "
- "&a%winner% has won &7(Game: %game_ID%)&a!"
- " "
- "&e-----------------------------------"
game_no_winner_broadcast:
- "&e-----------------------------------"
- " "
- "&cThere were no winners as all players have been eliminated"
- "&cThe game &7(%game_ID%) &chas ended"
- " "
- "&e-----------------------------------"
game_item_win_error: "&cYou didn't have enough space in your inventory to receive your reward, so it was dropped on the floor."
game_command_usage: "&cUsage: /game <join | leave | list> <gameID>"
game_join_command_usage: "&cUsage: /game join <gameID>"
game_spectator_error: "&cThere was an error setting you as a spectator. You have been removed from the arena"
game_created: "&aGame &e%game_ID% &awas successfully created"
# # # # ---> SIGN MESSAGES <--- # # # #
sign_admin_command_usage:
- "#01d54a--------- Sign Help ---------"
- "#01d54a/tf sign add <gameID> &7- Adds a new game sign for the specified game "
- "#01d54a/tf sign remove &7- Deletes a game sign that you are looking at"
- "#01d54a/tf sign remove <signID> &7- Deletes a game sign with that specified sign ID"
- "#01d54a/tf sign edit <lineNo> \"Text...\" &7- Edits the text on the game sign you are looking at"
- "#01d54a/tf sign edit <signID> <lineNo> \"Text...\" &7- Edits the text on the game sign with that specified sign ID"
sign_list_header: "--------- Signs List ---------"
sign_list_format: "&e> (Game ID: %game_ID%) Sign ID: %sign_ID%"
sign_list_hover: "&eClick to teleport to sign"
sign_id_edit_command_usage: "#01d54a/tf sign edit <signID> <line> \"new text..\""
sign_edit_command_usage: "#01d54a/tf sign edit <line> \"new text..\""
sign_added: "&aYou added a new game sign &7(to game : %game_ID%)"
sign_removed: "&aYou removed a game sign &7(signID: %sign_ID%)"
sign_edited: "&aYou successfully edited a game sign &7(signID: %sign_ID%)"
sign_invalid_line_number: "&cEnter a valid line number (1-4)"
sign_invalid_signID_error: "&cYou must input a invalid signID. &7(Use /sign list to view all loaded signs"
not_looking_at_game_sign: "&cYou are not looking at a game sign"
not_looking_at_sign: "&cYou are not looking at a sign"
sign_already_exists: "&cThis sign is already a game sign"
sign_game_id_error: "&cSkipping sign with ID &e%sign_ID% &cdue to invalid game ID"
sign_material_error: "&cInvalid sign material for sign &e%sign_ID%&c. Defaulting to OAK_SIGN"
sign_location_error: "&cSkipping sign with ID &e%sign_ID% &cdue to invalid world"
sign_created: "&aGame sign &e%sign_ID% &awas successfully created"
sign_convo_start: "&eWelcome to the GameSign text editor."
sign_convo_line_prompt: "&eWhich line would you like to edit? Options: 1 - 4 &7(Type 'EXIT' to exit the editor)"
sign_convo_line_invalid: "&cInput must be between 1 and 4"
sign_convo_text_prompt: "&ePlease state the text you want to put on line &6&l%line_number%"
questions.yml
Questions:
1:
# Write the question in speech marks
Question: "'A' is the most common letter used in the English language"
# State whether the correct answer is "True" or "False"
Answer: False
# (Optional) Write an explanation for the correct answer. This will be shown once the answer is reveal.
Correction_Message: "'E' is the most common letter used in the English language"
2:
Question: "In the English language there is no word that rhymes with orange"
Answer: True
# (Optional) Leave the correction message blank if you do not want a message to be shown
Correction_Message: ""
3:
Question: "The unicorn is the national animal of Scotland"
Answer: True
Correction_Message: ""
4:
Question: "Goldfish have a two second memory"
Answer: False
Correction_Message: ""
5:
Question: "An octopus has two hearts"
Answer: False
Correction_Message: "An octopus has three hearts"
6:
Question: "An octopus has three hearts"
Answer: True
Correction_Message: ""
7:
Question: "An octopus has four hearts"
Answer: False
Correction_Message: "An octopus has three hearts"
8:
Question: "Cinderella was the first Disney princess"
Answer: False
Correction_Message: "The first disney princess was Snow White"
9:
Question: "Alexander Fleming discovered penicillin"
Answer: True
Correction_Message: ""
10:
Question: "The black box in a plane is black"
Answer: False
Correction_Message: "The 'black box' in a plane is actually orange"
PAPI:
| Placeholder | Description |
|---|---|
%tfquiz_gameID% |
Displays the game ID that the player is in. Will be “null” if the player isn't in a game |
%tfquiz_in_game% |
Shows “true” or “false” whether the player is in a game |
%tfquiz_gamestate% |
Shows the status of the game. Will be “null” if the player isn't in a game |
%tfquiz__countdown% |
Displays the amount of seconds remaining on the countdown before a game starts.. Will be “null” if the player isn't in a game |
Game setup examples
game with an arena
games:
1:
state_on_startup: RECRUITING # Options: Recruiting or Closed
minimum_players: 5
maximum_players: 20
countdown_seconds: 60
maximum_end_point: 20
broadcast_winners: true # Whether to announce the winner of a game to the whole server
reward:
type: 'item'
reward: oak_planks, 2
message: 'You won 2 oak planks'
arena: true
arena_options:
desc_option: hologram # Options: ‘both’, ‘chat’ or ‘hologram’
spectators: true # Enables the spectator system
holo_location: # The spawn point for the hologram (Only works if desc_option is not ‘chat’
world: world
x: -50
y: 64
z: 64
spawn_point: # The spawn point where players get teleported to when they join the game/arena
world: world
x: -50
y: 64
z: 64
yaw: -180
pitch: 0
game without an arena
games:
1:
state_on_startup: 'RECRUITING' # Options: Recruiting or Closed
minimum_players: 5
maximum_players: 10
maximum_end_point: 10
countdown_seconds: 10
# Whether to announce the winner of a game to the whole server
broadcast_winners: true
reward:
type: 'currency'
reward: 500
message: You won $500
arena: false
# (in seconds) Only works when the arena option is false.
schedule_delay: 300
# (in seconds) How long the game remains open and in the recruiting state, before it closes again (will not close if the game is active). Make sure this is longer than your countdown_seconds option. Defaults to 60 if this isn’t set.
schedule_resets: 120
Rewards examples
command rewards
reward:
type: command
reward: xp give %player% 100
message: You won some experience # (Optional) Do not add this option if you don’t want a reward message
command rewards as list
reward:
type: command
reward:
- xp give %player% 100
- eco give %player% 500
- broadcast %player% won the game
item rewards
reward:
type: item
reward: apple, 5 # For item rewards, state the Bukkit material, followed by the quantity
message: ‘&aYou won 5 Apples’
item rewards as list
reward:
type: item
Reward:
- apple, 5 # For item rewards, state the Bukkit material, followed by the quantity
- oak_planks, 2
- ender_chest, 1
message: ‘#01d54aYou won some items’
permission rewards
reward:
type: permissions
reward: test.permission
permission rewards as list
reward:
type: permission
reward:
- test.permission
- test.permission2
- test.permission3
message: You have won some permissions
money rewards
reward:
type: 'currency'
reward: 500
message: You won $500
xp rewards
reward:
type: experience
reward: 500
message: You won $500
no reward"
reward:
type: none
Sign examples
basic sign
signs:
1:
game: 1
material: OAK_WALL_SIGN
world: world
x: 2
y: 65
z: 2
facing: south
format:
- ' '
- 'Click me to join'
- 'game #1'
- ' '
sign with placeholders + colors
signs:
1:
game: 1
material: OAK_SIGN
world: world
x: 2
y: 65
z: 2
facing: south
format:
- '&a%game_ID%'
- '&e%game_state%'
- ' '
- '#01d54a%game_players%/%game_maxplayers%'
Pinned Versions
Pages
Members
Owner
