Guide
Comment créer un plugin de mini-jeu Minecraft
Mis à jour le 18 octobre 2026
Un plugin de mini-jeu fait tourner des manches : les joueurs attendent dans un lobby, un compte à rebours démarre, la partie suit ses propres règles, quelqu'un gagne et l'arène est réinitialisée pour la manche suivante. Tous les mini-jeux, du spleef au bed wars, ont le même squelette. Une fois celui-ci bien fait, les règles du jeu sont la partie facile.
Partez de cet exemple et modifiez les règles.
Générer ceci avec CodexeÉtape par étape
1.Écrivez les règles d'une manche
Combien de joueurs, comment une manche commence et se termine, comment on gagne, ce qui se passe à la mort (éliminé, réapparition, spectateur) et ce que les joueurs reçoivent au départ.
2.Prévoyez la configuration des arènes
Des commandes admin pour créer une arène et définir son lobby, ses points d'apparition et ses limites, par exemple
/mg create <name>et/mg setspawn <name>. Les arènes sont sauvegardées dans un fichier pour survivre aux redémarrages.3.Définissez les états de jeu
En attente, démarrage (compte à rebours), en cours et fin. Chaque état autorise des choses différentes : personne ne casse de blocs dans le lobby, personne ne rejoint une partie en cours.
4.Décidez comment l'arène se réinitialise
Suivez et annulez les blocs modifiés pendant la manche, ou rechargez une copie d'un monde modèle. Sans réinitialisation, la deuxième manche commence sur une map abîmée.
5.Ajoutez ce que voient les joueurs
Un scoreboard latéral avec les joueurs restants et le temps, une boss bar ou des titres pour le compte à rebours, et des messages dans le chat pour les éliminations et le gagnant.
6.Générez, compilez et jouez une manche
Décrivez-le à Codexe, laissez-le compiler, puis rejoignez le serveur de test avec Tester maintenant. Réglez un nombre minimum de joueurs bas pendant les tests pour qu'une manche puisse démarrer.
Les états de jeu
La plupart des bugs de mini-jeux viennent de joueurs qui font quelque chose dans le mauvais état. Écrire les états dans la demande pousse l'IA à construire le plugin autour d'eux.
| État | Ce qui se passe | Règles habituelles |
|---|---|---|
| En attente | Les joueurs rejoignent le lobby | Pas de dégâts, pas de blocs cassés, on quitte avec un objet ou une commande |
| Démarrage | Compte à rebours une fois le minimum atteint | Le compte à rebours s'arrête si des joueurs partent et qu'on passe sous le minimum |
| En cours | Les règles du jeu s'appliquent | Pas de nouveaux joueurs, les morts éliminent ou font réapparaître, quitter compte comme une défaite |
| Fin | Gagnant annoncé, récompenses distribuées | Joueurs renvoyés après quelques secondes, arène réinitialisée |
Réinitialiser l'arène
- Enregistrer et annuler les modifications : sauvegardez chaque bloc avant qu'il change pendant la manche et remettez-le à la fin. Rapide pour les petites arènes où les joueurs cassent ou posent quelques blocs.
- Monde modèle : gardez une copie propre de la map, déchargez le monde joué après la manche et recopiez le modèle par-dessus. Simple et fiable pour les maps qui se font détruire.
- Aucune modification autorisée : pour des jeux comme le parkour ou les duels PvP, annulez complètement les modifications de blocs et il n'y a rien à réinitialiser.
Exemple de description
« Un plugin de mini-jeu spleef pour Paper 1.21.4. Les admins créent des arènes avec /spleef create <name>, /spleef setlobby et /spleef setfloor (les deux coins du sol de neige). Les joueurs rejoignent avec /spleef join <arena>. La manche démarre 15 secondes après l'arrivée de 2 joueurs, jusqu'à 8. Les joueurs reçoivent une pelle en diamant, cassent la neige instantanément et sont éliminés quand ils tombent sous le sol. Le dernier joueur debout gagne 50 pièces via Vault. Les joueurs éliminés deviennent spectateurs. Le sol de neige est restauré après chaque manche. Scoreboard latéral avec les joueurs restants et le temps. Arènes sauvegardées dans arenas.yml, nombre minimum de joueurs et récompenses dans config.yml. »
Tester un mini-jeu
Un mini-jeu est difficile à juger à partir du code : il faut jouer une manche. Tester maintenant démarre un serveur Paper privé de votre version avec le plugin installé, généralement dans un monde plat, et vos amis peuvent le rejoindre si vous les ajoutez à l'accès au serveur. L'offre Free autorise 2 personnes sur un serveur de test, Pro 5, Business 10 et Enterprise 20.
Demandez que le nombre minimum de joueurs soit dans config.yml pour pouvoir le régler à 1 ou 2 pendant les tests. Les joueurs de test peuvent aussi rejoindre, lancer les commandes de participation et d'administration et vérifier les messages, ce qui repère les commandes cassées avant même que vous jouiez.
Questions
Une arène ou plusieurs ?
Demandez plusieurs arènes dès le départ. Transformer plus tard un plugin à une seule arène en plugin multi-arènes oblige à réécrire la façon dont les joueurs et l'état de la partie sont stockés.
Puis-je créer un mini-jeu PvP en 1.8 ?
Oui. Indiquez Spigot ou Paper 1.8.8 dans la demande : Codexe écrit le code pour cette ancienne API, et les serveurs de test tournent sur les versions de 1.8 à 26.3.
Comment fonctionnent les réseaux de mini-jeux ?
Les grands réseaux font tourner chaque jeu sur son propre serveur derrière un proxy BungeeCord ou Velocity, avec un serveur lobby qui envoie les joueurs vers une partie libre. Cela fait un plugin proxy plus un plugin de jeu, en deux projets.
Créez votre mini-jeu
Ce prompt s'ouvre prêt à être envoyé :
“Un plugin de mini-jeu spleef pour Paper 1.21.4 : arènes créées avec /spleef create, setlobby et setfloor, les joueurs rejoignent avec /spleef join, la manche démarre 15 secondes après 2 joueurs (8 max), pelles en diamant, éliminé en tombant sous le sol, le dernier joueur gagne 50 pièces via Vault, spectateurs pour les joueurs éliminés, sol de neige restauré après chaque manche, scoreboard latéral avec les joueurs restants et le temps, arènes sauvegardées dans arenas.yml.”
Générer ceci avec Codexe