core-minigames/docs/FullTutorialExamples/KingOfHill/07-end-and-reset.md

King of the Hill — Ending & Resetting

This step covers what happens when the game ends, what signals fire and when, and how to use arena reset to prepare for the next game.

---

What Happens When the Game Ends

When the final round timer expires (and no overtime/sudden death is configured), the runtime calls end("rounds_complete") automatically. The full sequence:

1. HUDs removed for all players in the runtime.
2. Phase set to ENDING → SignalPhaseStart=ENDING fires.
3. Active signal timers cancelled.
4. Temporary entities cleaned up (spawned NPCs/items tracked by the runtime).
5. Player inventories restored (since RestorePlayerInventory = true is the default).
6. Rewards distributed (if any Rewards are defined in the definition).
7. on_game_end event dispatched with reason = "rounds_complete" and final scores.
8. Runtime state cleared — scores, player status, timers, counters all zeroed.
9. Runtime removed from the active list.
10. Phase set to RESETTING → SignalPhaseStart=RESETTING fires.
11. on_arena_reset event dispatched (since ResetOnEnd = true is the default).

You do not need to manually reset scores or clear HUDs.

---

ENDING Phase Volume (Optional)

Use SignalPhaseStart=ENDING to show a scoreboard, announce the winner, or freeze players briefly before cleanup. This fires while the runtime still holds final scores.

Tags:

Tag	Value
MinigameId	King_Of_The_Hill
MapId	Hillside
SignalPhaseStart	ENDING

Example effects:

Effect	Fields
SendMinigameMessage	MinigameId = King_Of_The_Hill, MessageKey = game_over, Target = ALL

---

Arena Reset Volume

Use SignalPhaseStart=RESETTING to restore any world state changed during the game. This fires after the runtime has been cleaned up, so it is safe to re-enable the queue pad without risk of double-triggering.

Scope note: SignalPhaseStart=RESETTING is scoped by MinigameId tag match, NOT by physical containment within the MapRole=MainArena boundary. Any volume anywhere in the world with a matching MinigameId tag will respond. The arena boundary volume is only used for map discovery, not for event routing.

For this King of the Hill setup there are no block placements or NPC spawns, so the arena reset volume is optional. Add it if you want to re-enable the queue pad, reset visual markers, or restore barriers changed mid-game.

Tags:

Tag	Value
MinigameId	King_Of_The_Hill
MapId	Hillside
SignalPhaseStart	RESETTING

Example effects:

Effect	Fields	Purpose
PlaceBlocks	(coordinates of any changed areas, original block id)	Restore modified terrain.

---

Repeating the Game

After the runtime ends and SignalPhaseStart=RESETTING fires, the minigame is ready to start again. Players can step back onto the queue pad and a new runtime will be created when StartQueuedMinigame fires again.

No state from the previous game persists — scores, player status, timers, and counters are all cleared by the end flow.

---

Manual Reset

If you need to reset the game mid-match (for testing or crash recovery), use the admin command:

/minigame reset King_Of_The_Hill

This calls ResetMinigame directly, which sets phase to RESETTING, fires SignalPhaseStart=RESETTING, clears runtime state, and dispatches on_arena_reset — without going through the normal end flow (no rewards, no inventory restore, no ENDING phase).