Commandes de MegaBlock Survivors

MegaBlock Survivors enregistre une seule commande principale et son alias :

/mbs
/megablocksurvivors

La commande de jeton Nightbreak utilisée pendant l'installation est distincte et fournie par MagmaCore :

/nightbreaklogin <token>

Installation et gestion du contenu

Commande	Expéditeur	Permission	Rôle actuel
/mbs	Tous	megablocksurvivors.*	Affiche l'aide de démarrage rapide : start, setup, reload
/mbs setup	Joueur	megablocksurvivors.setup	Ouvre le navigateur de contenu Nightbreak avec les filtres Gratuit, Premium et Ressources
/mbs recommendedplugins	Tous	megablocksurvivors.setup	Présente le catalogue des plugins complémentaires recommandés, dans un menu pour les joueurs ou une liste pour la console
/mbs downloadpluginupdate	Tous	megablocksurvivors.*	Télécharge le dernier JAR MegaBlock Survivors depuis Nightbreak ; nécessite un compte lié
/mbs downloadall	Tous	megablocksurvivors.*	Télécharge la mise à jour du plugin. MBS utilise hasContentPackages=false : cette commande ne télécharge donc pas de packs de contenu et sert ici d'alias de mise à jour du plugin.
/mbs applypluginupdate	Tous	megablocksurvivors.*	Applique sans redémarrage une mise à jour du plugin déjà téléchargée dans le dossier de mise à jour du serveur. MegaBlock Survivors est rechargé, ce qui termine les parties actives. Refusée lorsqu'aucune mise à jour valide plus récente n'est en attente, ou lorsqu'un plugin d'un autre auteur dépend de MegaBlock Survivors
/mbs reload	Tous	megablocksurvivors.*	Effectue un cycle complet de désactivation, chargement et activation de MegaBlock Survivors. Termine les parties actives et recharge la configuration, les traductions, le contenu, les mondes, les PNJ et les affichages. Si des modèles sont importés et que FreeMinecraftModels est activé, l'importateur partagé recharge également le contenu de FMM.
/mbs version	Tous	Aucune	Affiche la version actuelle du plugin

setup, recommendedplugins, downloadpluginupdate, downloadall et applypluginupdate sont enregistrées par NightbreakPluginBootstrap.registerStandardCommands de MagmaCore, intégré au plugin, et non par les classes de commandes propres à MegaBlock Survivors. Voir Mises à jour automatiques pour les réglages de mise à jour partagés.

Notes de version

MagmaCore enregistre aussi une commande de premier niveau distincte pour la boîte de réception partagée des notes de version :

/mbschangelog
/mbschangelog dismiss
/mbschangelog disable

Elle ouvre les notes de version de MegaBlock Survivors non lues, les marque comme lues ou désactive pour vous le rappel à la connexion. Elle est réservée aux joueurs et nécessite d'être OP ou de posséder megablocksurvivors.*, megablocksurvivors.setup ou megablocksurvivors.initialize. Voir Notifications de notes de version Nightbreak.

Commandes de jeu

Commande	Expéditeur	Rôle actuel
/mbs start	Joueur	Démarre une partie. Échoue si vous participez déjà à une partie ou en préparez encore une, ou si vous êtes déjà dans la partie d'un autre plugin utilisant le système de parties partagé de MagmaCore.
/mbs quit	Joueur	Termine votre partie, ou annule celle que vous êtes encore en train de préparer. Un joueur déjà en partie est déplacé vers le lobby mbs_spawn, ou ramené à l'endroit où il a exécuté /mbs start lorsque le lobby n'est pas chargé
/mbs stats	Joueur	Ouvre l'écran d'équipement et de statistiques de votre partie actuelle
/mbs summary	Joueur	Affiche dans le chat le résumé de votre partie actuelle ou la plus récente : durée, vague maximale, répartition des dégâts, équipement et éliminations
/mbs dump	Joueur	Vide le fichier partagé stats-dump.log, puis y écrit le résumé de la partie actuelle ou la plus récente du joueur sous forme d'une ligne JSON, s'il existe. Sans résumé, l'ancien journal est tout de même effacé
/mbs sacrifice	Joueur	Déclenche l'étape actuelle de l'Autel de sang le plus proche : 25 %, 50 % ou 75 % des PV
/mbs meta	Joueur	Ouvre la boutique de méta-progression, le Sanctuaire des échos d'âme
/mbs meta upgrade <track>	Joueur	Achète un niveau de l'amélioration permanente indiquée : hp, luck, speed, weaponslots, passiveslots, extralives, bantokens ou rerolltokens.

Commandes internes

Ces commandes sont déclenchées par les boutons des dialogues en jeu. Utilisez les boutons : les gestionnaires ne vérifient pas tous l'écran ou la phase de partie attendus. Exécuter manuellement les commandes de bannissement ou de relance peut consommer un jeton sans écran de récompense ouvert.

Commande	Expéditeur	Rôle actuel
/mbs selectgamemode <challenge|endless>	Joueur	Choisit le mode de jeu sur le premier écran précédant la partie
/mbs selectdifficulty <easy|medium|hard>	Joueur	Choisit la difficulté sur le deuxième écran précédant la partie
/mbs selectweapon <weaponType>	Joueur	Sélectionne l'arme de départ sur l'écran de choix de classe
/mbs reward <number>	Joueur	Choisit une récompense sur l'écran de montée de niveau
/mbs reward-ban <type>	Joueur	Exclut un type d'équipement des tirages suivants et consomme un jeton de bannissement. Le mécanisme de secours utilisé lorsque le pool est épuisé peut néanmoins proposer des types bannis.
/mbs reward-reroll	Joueur	Renouvelle les récompenses proposées et consomme un jeton de relance
/mbs hourglass-reward <number>	Joueur	Choisit une récompense sur l'écran du sablier
/mbs chest-reward <number>	Joueur	Choisit une récompense sur l'écran du coffre
/mbs resume	Joueur	Reprend le jeu après le choix d'une récompense
/mbs skip	Joueur	Envoyée par le bouton de saut de l'animation du sélecteur de récompenses. Termine l'animation et affiche les choix de récompense finaux. Ne fait rien en dehors d'une partie

Les animations du sélecteur de récompenses sont désactivées : les choix apparaissent donc immédiatement et /mbs skip n'a actuellement aucun effet. Elle n'exige aucune permission.

Commandes de débogage et d'administration

Commande	Expéditeur	Rôle actuel
/mbs cheat	Joueur	Retire tous les ennemis suivis sans butin ni crédit d'élimination, remplit le quota de sacrifices du portail et rend le joueur insensible aux dégâts de partie jusqu'à la fin de la partie. Le contact mortel de l'armée fantôme temporisée s'applique toujours
/mbs beam	Joueur	Trace pendant 10 secondes des rayons de débogage vers les blocs cibles d'un cube s'étendant sur 20 blocs le long de chaque axe depuis le joueur
/mbs skipworld	Joueur	Passe au monde suivant de la partie actuelle

Ces trois commandes de débogage n'exigent actuellement aucune permission. /mbs cheat marque la partie comme trichée, mais /mbs skipworld se contente de changer de monde sans activer cet indicateur. Le filtre antitriche du classement ne protège donc pas contre ce saut de monde de débogage.

Permissions

Permission	Déclarée dans	Accorde
megablocksurvivors.*	NightbreakPluginSpec	Les commandes d'administration : /mbs, /mbs reload, /mbs downloadpluginupdate, /mbs downloadall, /mbs applypluginupdate, ainsi que le rappel de première configuration
megablocksurvivors.setup	NightbreakPluginSpec	/mbs setup et /mbs recommendedplugins
megablocksurvivors.initialize	NightbreakPluginSpec	Uniquement /mbschangelog. Aucune commande /mbs initialize n'est enregistrée
megablocksurvivors.match.bypass	plugin.yml (par défaut : op)	Se téléporter dans les mondes des parties en cours sans être refusé ni renvoyé dehors. Les détenteurs sont tout de même déplacés avant la suppression des mondes d'une partie terminée

Remarques

• Le plugin.yml de MegaBlock Survivors déclare /mbs, son alias /megablocksurvivors et la permission megablocksurvivors.match.bypass. Chaque sous-commande est enregistrée à l'exécution via le CommandManager de MagmaCore.
• Les commandes sans permission explicitement définie n'en exigent aucune.
• /mbs setup et /mbs recommendedplugins nécessitent megablocksurvivors.setup. /mbs reload, /mbs downloadpluginupdate, /mbs downloadall et /mbs applypluginupdate nécessitent megablocksurvivors.*. Les deux permissions sont déclarées dans le NightbreakPluginSpec pour permettre un rôle limité à la configuration, distinct du rôle d'administration complet.
• MegaBlock Survivors appelle la surcharge simplifiée de l'initialisation partagée, qui n'enregistre pas /mbs initialize. Avec hasContentPackages=false, les commandes de téléchargement et de mise à jour par pack sont aussi omises, et /mbs downloadall télécharge uniquement le JAR du plugin. Gérez le contenu MBSPackage via /mbs setup.
• De nombreux textes de jeu utilisent plugins/MegaBlockSurvivors/translations.yml. Certaines descriptions des commandes partagées et certains textes des menus de contenu et du classement restent définis directement en anglais dans le code.