King of the Hill

Install

Go to the download page
Choose the latest version
Download the -shaded file
Copy the downloaded file to the folder plugins/GamesInTheBox/expansions
Restart the server

How to play

A box would appear at the game arena. Players must enter the box to earn points. If a player was knocked out of the box for some reasons, the points would be decreased over time. Those who have the highest points would win the game.

Set up

Build a place for the box

Info

The stones are for the two corners of the box

Look at the first corner and type /gitbeditor action koth set-pos1

Look at the second corner and type /gitbeditor action koth set-pos2

Configure additional settings
Save the settings as a new arena by typing /gitbeditor save koth <planner> <arena>
Clear the unnecessary blocks. Your new arena will be available after reloading

Additional Settings

Note

The settings below are available as the actions of the command /gitbeditor action koth <action> [args]

For example, the action set-point <number> plus is relevant to the command /gitbeditor action koth set-point <number> plus

Use the command /gitbeditor usage koth to get the full list of available actions and their usage

Use the command /gitbeditor status koth to get the status of the settings, including the current values for each one of them

Point

set-point <number> plus to set the points a player would receive when he enters the box
set-point <number> minus to set the points decreased when a player is out of the box
set-max-players-to-add-point <number> to set the maximum players inside the box before the box stops giving points

Tip

Set the <number> to -1 to disable the limit

Reward

add-reward <top> <command> to add a new <command> to be executed when the player is at the position <top>

Tip

You can use some placeholders for the <command>:
- {top}: Get the top position of the player
- {name}: Get the name of the player
<top> starts from 1. A value of -1 indicates that the reward is for all players

clear-reward <top> to clear all commands at the position <top>
clear-all-reward to clear all commands at all the top
set-min-players-to-reward <number> to set how many players are required to start the reward

Tip

Set the <number> to -1 to disable the limit

Hologram

new-hologram to create a new hologram at your current location
set-hologram-location <index> to move the hologram at the <index> to your current location

Tip

The <index> of the hologram starts from 0, and it is provided as the output of the action new-hologram

add-hologram-line <index> <line> to add the <line> at the end of the hologram at the <index>

Tip

You can use default hologram lines provided by the default-hologram-lines setting at the file messages.yml in the expansion’s folder

To use these lines, set the <line> to default:<name>, with the <name> indicating the name of the default hologram lines

For example, if you want to use the description hologram lines, the appropriate <line> will be default:description

clear-hologram-line <index> to clear all lines of the hologram at the <index>
remove-hologram <index> to remove the hologram at the <index>
clear-all-hologram to clear all holograms

Time

set-waiting-time <time> to set the <time> before the game starts
set-in-game-time <time> to set the <time> the game runs
set-ending-time <time> to set the <time> before the game ends

Tip

The unit of <time> is millisecond by default

You can set the <time> in seconds by adding s after the time. For example, 30s is for 30 seconds

Similarly, you can set the <time> in minutes by using m (30m for 30 minutes)

Particle

set-particle <particle> to set the <particle> of the box
set-particle-count <number> to set the count of the particle of the box
set-particle-offset <x> <y> <z> to set the offset of the particle of the box
set-particle-rate <number> to set the density (rate) of the particle of the box
set-particle-period <number> to set the period between each call of spawning the particle

Variable

Variable	Description
`{game_point}`	The points of the player
`{game_top}`	The top position of the player
`{game_time_left}`	The time left of the game arena
`{game_min_players_to_reward}`	The minimum players to start the reward
`{game_point_plus}`	The points to give when a player enters the box
`{game_point_minus}`	The points to take when a player is out of the box
`{game_top_name_<number>}`	The name of the player at the top position `<number>`
`{game_top_value_<number>}`	The value of the player at the top position `<number>`

Action

Note

The actions below are used in the command /gitb action <planner> <action> [args]

For example, the command to use the action skip-time is gitb action <planner> skip-time

skip-time to skip the time on a state of the current arena