Minigame Arena

Arène de mini-jeu

ManifesteFourni par MiniGame

Master configuration entry for a minigame arena. This single entry contains ALL configuration for any game type. Game-specific settings are handled through the [gameType] field and [templateConfig] for template-based games. Players interact with this arena through action entries (join, leave, start) and GUI menus configured in the editor.

Champs

Champ	Type	Par défaut	Description
gameType	GameType	TPP	Type de jeu (TPP, Spleef, Parkour, Archery, etc.)Valeurs :SUMOGLADIATORDUELSKOTHPAINTBALLONE_IN_THE_CHAMBERPARKOURBLOCK_PARTYTNT_RUNFLOOR_IS_LAVAFALLING_BLOCKSWAVE_SURVIVALZOMBIE_APOCALYPSEDODGE_THE_ARROWSDEFEND_THE_CORECAPTURE_THE_FLAGINFECTIONSPLEEFSHEEP_HUNTTPPFREEZE_TAGHOT_POTATODEACOUDREMUSICAL_CHAIRSARCHERYQUAKE
description	Var<String>	—	Description affichée aux joueurs dans le navigateur de jeuxPlaceholdersCouleursMultiligne
lobbySpawn	Var<Position>	ORIGIN	Position du lobby d'attente (où les joueurs spawn en attendant)
gameSpawn	Var<Position>	ORIGIN	Position de spawn en jeu (au début de la partie)
endTeleport	Var<Position>	ORIGIN	Position de téléportation à la fin de la partie
spectatorSpawn	Var<Position>	ORIGIN	Position des spectateurs (optionnel — utilise gameSpawn si non défini)
lobbyRadius	Var<Double>	10.0	Rayon horizontal autorisé autour du lobby, en attente et pendant le décompte (en blocs ; 0 = illimité)
gameRadius	Var<Double>	64.0	Rayon de jeu autour du spawn (utilisé par les modes hors-limites)
minPlayers	Var<Int>	2	Nombre minimum de joueurs pour démarrer
maxPlayers	Var<Int>	16	Nombre maximum de joueurs autorisés
autoStartCountdown	Var<Int>	15	Temps du countdown avant le début de la partie (secondes)
maxGameDuration	Var<Int>	300	Durée maximale de la partie (secondes)
allowLateJoin	Boolean	false	Permettre aux joueurs de rejoindre en cours de partie
allowSpectate	Boolean	true	Permettre aux joueurs éliminés de regarder en spectateur
teamMode	TeamMode	NONE	Mode d'équipe (NONE, SOLO, RED_BLUE, TEAMS_CUSTOM)
teamCount	Int	2	Nombre d'équipes (utilisé si teamMode = TEAMS_CUSTOM)
teamNames	String	Rouge,Bleu	Noms des équipes séparés par des virgules
giveKit	Boolean	true	Donner un kit aux joueurs au début de la partie
bringOwnItems	Boolean	false	Permettre aux joueurs de garder leur propre inventaire
clearInventoryOnEnd	Boolean	true	Vider l'inventaire à la fin de la partie
kitItems	List<Item>	empty	Items du kit donnés aux joueurs au début de la partie
region	Ref<RegionDefinitionEntry>	—	Région définissant la zone de jeu : quitter la région pendant une partie élimine le joueur (modes à gabarit). Laisse vide pour ne pas limiter la zone.
floorMaterial	Var<String>	—	Matériau(x) du sol, noms Bukkit séparés par des virgules (modes « sol disparu » : Spleef, BlockParty). Le joueur est éliminé dès que le bloc sous ses pieds n'en fait plus partie. Vide = tout bloc non vide est un sol.
powerUpEnabled	Boolean	false	Activer les power-ups
powerUpInterval	Var<Int>	15	Intervalle d'apparition des power-ups (secondes)
useRounds	Boolean	false	Activer les rounds avec reset entre chaque round
maxRounds	Var<Int>	3	Nombre maximum de rounds
winStatArtifact	Ref<MinigameWinsArtifactEntry>	—	Artifact stockant les victoires/défaites des joueurs
scoreArtifact	Ref<MinigameScoreArtifactEntry>	—	Artifact stockant les scores des joueurs
stateArtifact	Ref<MinigameStateArtifactEntry>	—	Artifact stockant l'état de la partie
bestTimeArtifact	Ref<MinigameBestTimeArtifactEntry>	—	Artifact stockant le meilleur temps personnel de chaque joueur
topTimesArtifact	Ref<MinigameTopTimesArtifactEntry>	—	Artifact stockant le classement des meilleurs temps
topTimesLimit	Int	10	Nombre de temps conservés dans le classement
onGameStart	Ref<TriggerableEntry>	—	Trigger exécuté au début de la partie
onGameEnd	Ref<TriggerableEntry>	—	Trigger exécuté à la fin de la partie
onPlayerJoin	Ref<TriggerableEntry>	—	Trigger exécuté quand un joueur rejoint
onPlayerEliminate	Ref<TriggerableEntry>	—	Trigger exécuté quand un joueur est éliminé
onRoundStart	Ref<TriggerableEntry>	—	Trigger exécuté au début d'un round
onPersonalBest	Ref<TriggerableEntry>	—	Trigger exécuté quand un joueur bat son propre record
onWorldRecord	Ref<TriggerableEntry>	—	Trigger exécuté quand un joueur bat le record de l'arène
customLobbyMenu	Ref<MinigameLobbyMenuEntry>	—	Menu lobby personnalisé (laissez vide pour le menu par défaut)
showScoreboard	Boolean	true	Afficher le scoreboard en jeu
scoreboardLines	Var<String>	—	Lignes du scoreboard (utilise les placeholders %minigame_...)PlaceholdersMultiligne
joinMessage	Var<String>	<green>Vous avez rejoint <bold>%arena%</bold> !</green>	Message de bienvenue quand un joueur rejointPlaceholdersCouleursMultiligne
leaveMessage	Var<String>	<gray>%player% a quitté la partie.</gray>	Message quand un joueur quittePlaceholdersCouleursMultiligne
winMessage	Var<String>	<bold><gold>🏆 %winner% a gagné !</gold></bold>	Message de victoire annoncé à la fin de la partie (%winner% = vainqueur)PlaceholdersCouleursMultiligne
eliminationMessage	Var<String>	<red>%player% a été éliminé !</red>	Message d'éliminationPlaceholdersCouleursMultiligne

How to use it

This one entry configures every game mode. Pick gameType first, then set the four positions: lobbySpawn (where players wait), gameSpawn (where the game starts), spectatorSpawn (eliminated players, optional) and endTeleport (where everyone returns).

• Starting. The game counts down only once minPlayers players have clicked Ready. autoStartCountdown is the countdown length and maxGameDuration the hard limit of the playing phase, both in seconds.

• Teams. teamMode RED_BLUE creates two teams. TEAMS_CUSTOM creates teamCount teams named from teamNames (comma separated). NONE and SOLO create no team.

• Inventory. kitItems are given when the game starts if giveKit is on. By default the player inventory is saved and cleared; bringOwnItems keeps it.

• Rounds and power-ups. useRounds and maxRounds apply to the rule-based modes, and powerUpEnabled with powerUpInterval (minimum 5 seconds) drops random power-ups.

• Messages and scoreboard. joinMessage, leaveMessage, eliminationMessage accept %arena%, %player%, %winner% and the other game tokens. scoreboardLines takes one line per row, also with the tokens, and an empty value shows a default scoreboard.

• Persistence and triggers. Link winStatArtifact, scoreArtifact, stateArtifact, bestTimeArtifact and topTimesArtifact, and the onGameStart, onGameEnd, onPlayerJoin, onPlayerEliminate, onRoundStart, onPersonalBest and onWorldRecord triggers. The two record triggers only fire for parkour.

• Limits and floor. lobbyRadius (default 10, 0 = no limit) keeps waiting players within that horizontal distance of lobbySpawn during the Lobby and Countdown phases: it blocks moving further away, never teleports, and walking back is always allowed. region is the play zone: leaving it during a game eliminates the player, in rule-based modes only (not Archery, Parkour or Dé à Coudre); leave it empty for no zone. floorMaterial is a comma-separated list of Bukkit material names used by the floor-gone modes (Spleef, Block Party): a player is eliminated when the block below is not in the list, and an empty value means any non-air block counts as floor. Floors are not generated.

• Victory message. winMessage is announced when the game ends; %winner% is the winner.

• gameRadius. Only used by the out-of-bounds elimination, which no built-in mode uses.