core-minigames/docs/FullTutorialExamples/KingOfHill/02-minigame-definition.md

King of the Hill — Minigame Definition

Create the following file in your server's assets:

src/main/resources/Server/Minigames/King_Of_The_Hill.json

{
  "Id": "King_Of_The_Hill",
  "Name": "King of the Hill",
  "Enabled": true,
  "MinPlayers": 2,
  "MaxPlayers": 16,
  "TeamMode": "SOLO",
  "WinCondition": "HIGHEST_SCORE",
  "RoundLengthSeconds": 120,
  "TotalRounds": 3,
  "CountdownSeconds": 10,
  "AllowPvp": true,
  "RequiredGameMode": "Adventure",
  "ShowHud": true,
  "ShowScore": true,
  "ShowTime": true,
  "ShowRound": true
}

Field Breakdown

Field	Value	Why
Id	King_Of_The_Hill	Must match the filename exactly and all MinigameId fields on every trigger volume in the world.
MinPlayers	2	Queue will not start a countdown until at least 2 players have joined. Set to 1 for solo testing.
TeamMode	SOLO	Each player competes individually with their own score.
WinCondition	HIGHEST_SCORE	The player with the most points when the game ends wins.
RoundLengthSeconds	120	Each hill is active for 2 minutes before the next round begins.
TotalRounds	3	Three rounds run in sequence. The runtime advances rounds automatically when each timer expires.
CountdownSeconds	10	After MinPlayers has joined the queue, a 10-second countdown begins before the game starts.
AllowPvp	true	Players can knock each other off the hill. Set to false for a passive score-race version.
RequiredGameMode	Adventure	Applied to each player when they activate. Prevents block breaking and placing.
ShowHud	true	Enables the in-game HUD. Without this, no HUD appears even if the other Show* fields are set.
ShowScore	true	Shows the player's current score on the HUD.
ShowTime	true	Shows time remaining in the current round on the HUD. Only renders when RoundLengthSeconds > 0.
ShowRound	true	Shows current round out of total rounds (e.g. 2 / 3). Only renders when TotalRounds > 1.

How Rounds Work

You do not need to manually advance rounds. The runtime handles this automatically:

1. When the game starts, the $round timer begins counting down RoundLengthSeconds for round 1.
2. When the timer expires, round 2 starts and the timer resets.
3. When round 3's timer expires, on_game_rounds_complete is dispatched.

Your trigger volumes use the CurrentRound condition to check which round is active, so each capture zone automatically becomes active or inactive as rounds change.

Testing With One Player

Change MinPlayers to 1 while setting up and testing your world. Change it back before going live.