⚔ GameMod — Fabric 1.21.x

A full-featured mini-game manager with countdown display, settings GUI, custom spawn radius, and world border control.

---

Required Dependencies (install alongside this mod)

Mod	Download
Fabric API	https://modrinth.com/mod/fabric-api
Cloth Config	https://modrinth.com/mod/cloth-config
ModMenu	https://modrinth.com/mod/modmenu

---

Commands (requires op level 2)

Game Control

Command	Effect
/game start	Begin countdown (if set) then launch the game
/game stop	Cancel countdown or end an active game
/game cooldown <time>	Set countdown duration (e.g. 10s, 5m, 2h)
/game cooldown	Show current cooldown setting

Settings

Command	Effect
/game settings or /game settings list	Print all current settings
/game settings display actionbar	Show countdown in the action bar
/game settings display bossbar	Show countdown in a boss bar
/game settings spawn here	Set spawn to your current position
/game settings spawn <x> <y> <z>	Set spawn to exact coordinates
/game settings radius <blocks>	Scatter players within N blocks of spawn (0 = exact)
/game settings border <size>	Set world border diameter for the game
/game settings cooldown <time>	Same as /game cooldown <time>
/game settings reset	Reset everything to defaults

---

Settings GUI (ModMenu)

Open the Mods screen in-game → find Game Mod → click the ⚙ button.

Categories:

• Display — boss bar vs action bar toggle
• Spawn Location — X / Y / Z coordinates + scatter radius
• World Border — game size and post-game reset size
• Cooldown — duration in s / m / h format

Settings are saved to config/gamemod.json automatically.

---

How it Works

/game start flow

1. Checks for an active countdown or game (blocks if already running)
2. If cooldown > 0: counts down, displaying progress on all players' screens
3. At zero (or instantly): teleports all online players to a random position within the spawn radius, sets world border centred on the spawn coordinates, sets everyone to Survival

Random radius teleport

• If radius = 0: all players land on the exact spawn point
• If radius > 0: each player gets a random angle and distance within the radius; Y is found automatically using the terrain heightmap (players always land on solid ground, not in mid-air or underground)

Eliminated players

When a player dies while a game is active they are automatically switched to Spectator mode. /game stop returns all spectators to Survival.

Countdown display

Remaining	Action bar colour	Boss bar colour
> 10s	🟢 Green	Green
6 – 10s	🟡 Yellow	Yellow
≤ 5s	🔴 Red	Red

---

Config file

config/gamemod.json — edited by the GUI or commands, reloaded on next server start.

{
  "useBossBar": false,
  "spawnX": 0.0,
  "spawnY": 64.0,
  "spawnZ": 0.0,
  "spawnRadius": 25,
  "gameBorderSize": 200.0,
  "defaultBorderSize": 60000000.0,
  "cooldownSeconds": 30
}

---