Minigame Arena Definition
| Property | Value |
|---|---|
| Entry ID | minigame_arena |
| Type | Definition / Manifest |
| Color | Orange |
| Icon | mdi:grid |
Description
The core arena definition entry for the minigame extension. Configures every aspect of a minigame arena: game type, spawn positions, team mode, player limits, kits, power-ups, rounds, artifact references for score/time tracking, and triggers for game lifecycle events.
Fields
General Configuration
| Field | Type | Description |
|---|---|---|
gameType | GameType | Game type: TPP, Spleef, Parkour, Archery, etc. |
description | Var<String> | Description shown to players in browser |
region | Ref<RegionDefinitionEntry> | Protection region defining play area |
Spawn Positions
| Field | Type | Description |
|---|---|---|
lobbySpawn | Var<Position> | Lobby waiting position |
gameSpawn | Var<Position> | Game start position |
endTeleport | Var<Position> | End teleport position |
spectatorSpawn | Var<Position> | Spectator position |
lobbyRadius | Var<Double> | Lobby movement radius in blocks |
Player Limits
| Field | Type | Description |
|---|---|---|
minPlayers | Var<Int> | Minimum players to start |
maxPlayers | Var<Int> | Maximum players allowed |
autoStartCountdown | Var<Int> | Countdown before game starts in seconds |
maxGameDuration | Var<Int> | Max game duration in seconds |
allowLateJoin | Boolean | Allow joining during game |
allowSpectate | Boolean | Allow eliminated players to spectate |
Team Configuration
| Field | Type | Description |
|---|---|---|
teamMode | TeamMode | Team mode: NONE, SOLO, RED_BLUE, TEAMS_CUSTOM |
teamCount | Int | Team count if TEAMS_CUSTOM |
teamNames | String | Team names separated by commas |
Kit Configuration
| Field | Type | Description |
|---|---|---|
giveKit | Boolean | Give kit to players at start |
bringOwnItems | Boolean | Allow players to keep own inventory |
clearInventoryOnEnd | Boolean | Clear inventory at end |
kitItems | List<Item> | Kit items given at start |
Gameplay Options
| Field | Type | Description |
|---|---|---|
floorMaterial | Var<String> | Floor material for Spleef/BlockParty |
powerUpEnabled | Boolean | Enable power-ups |
powerUpInterval | Var<Int> | Power-up spawn interval in seconds |
useRounds | Boolean | Enable rounds with reset between each |
maxRounds | Var<Int> | Maximum number of rounds |
Artifact References
| Field | Type | Description |
|---|---|---|
winStatArtifact | Ref<MinigameWinsArtifactEntry> | Artifact storing wins/losses |
scoreArtifact | Ref<MinigameScoreArtifactEntry> | Artifact storing scores |
stateArtifact | Ref<MinigameStateArtifactEntry> | Artifact storing game state |
bestTimeArtifact | Ref<MinigameBestTimeArtifactEntry> | Artifact storing personal best time |
topTimesArtifact | Ref<MinigameTopTimesArtifactEntry> | Artifact storing leaderboard times |
topTimesLimit | Int | Number of times kept in leaderboard |
Triggers
| Field | Type | Description |
|---|---|---|
onGameStart | Ref<TriggerableEntry> | Trigger on game start |
onGameEnd | Ref<TriggerableEntry> | Trigger on game end |
onPlayerJoin | Ref<TriggerableEntry> | Trigger on player join |
onPlayerEliminate | Ref<TriggerableEntry> | Trigger on player elimination |
onRoundStart | Ref<TriggerableEntry> | Trigger on round start |
onPersonalBest | Ref<TriggerableEntry> | Trigger on personal best |
onWorldRecord | Ref<TriggerableEntry> | Trigger on world record |
UI & Messages
| Field | Type | Description |
|---|---|---|
customLobbyMenu | Ref<MinigameLobbyMenuEntry> | Custom lobby menu |
showScoreboard | Boolean | Show in-game scoreboard |
scoreboardLines | Var<String> | Scoreboard lines using %minigame_... placeholders |
joinMessage | Var<String> | Welcome message |
leaveMessage | Var<String> | Leave message |
winMessage | Var<String> | Win message |
eliminationMessage | Var<String> | Elimination message |
Usage Example
minigame_arena:
gameType: Spleef
description: "Classic Spleef - break the floor under your opponents!"
lobbySpawn: <world,0,64,0>
gameSpawn: <world,0,50,0>
spectatorSpawn: <world,0,80,0>
lobbyRadius: 5.0
minPlayers: 2
maxPlayers: 8
autoStartCountdown: 10
teamMode: SOLO
giveKit: true
kitItems:
- DIAMOND_SHOVEL
useRounds: true
maxRounds: 3
winStatArtifact: ref:my_wins_artifact
scoreArtifact: ref:my_scores_artifact
showScoreboard: true
scoreboardLines: "Players: %minigame_players%\nRound: %minigame_round%"
joinMessage: "Welcome to Spleef!"
winMessage: "%player% wins Spleef!"
This defines a Spleef arena with solo mode, 2–8 players, a 10-second start countdown, 3 rounds, kits with diamond shovels, and scoreboard display.