Commandes et permissions de CannonRTP

CannonRTP enregistre ses commandes dans l'espace de noms cannonrtp.

• Commande principale : /cannonrtp
• Alias : /crtp, /wc

/wc est l'alias court que la plupart des administrateurs utiliseront, mais chaque sous-commande nécessite la permission cannonrtp.admin.

Commandes d'administration

create, place, remove, target et center enregistrent leur configuration avant d'appliquer la modification. Si l'enregistrement échoue, la commande signale l'erreur sans recharger ni appliquer cette modification. Corrigez le problème de fichier signalé avant de réessayer.

Après une modification réussie, ces commandes ainsi que delete reconstruisent tous les canons, pas seulement celui que vous avez modifié. Les lancements en cours sont annulés et les joueurs concernés sont ramenés au siège de leur canon, chaque canon abandonne ses destinations en file et relance sa recherche, et tous les délais de récupération entre lancements sont réinitialisés.

Commande	Expéditeur	Description
/cannonrtp	Tous	Affiche l'en-tête d'aide, puis toutes les sous-commandes enregistrées que l'expéditeur peut utiliser
/wc help	Tous	Identique à /cannonrtp : affiche l'aide
/wc create <id>	Joueur	Crée une nouvelle configuration de canon et place sa première instance à votre position actuelle. Refuse un identifiant déjà existant ; utilisez /wc place pour lui ajouter un placement.
/wc create <id> <display_name>	Joueur	Même action, avec un nom d'affichage personnalisé ; les tirets bas sont remplacés par des espaces
/wc place <id>	Joueur	Ajoute un placement d'un canon existant à votre position actuelle
/wc remove <id>	Joueur	Retire le placement de <id> le plus proche dans votre monde actuel, en conservant le fichier de configuration
/wc delete <id>	Tous	Supprime entièrement le fichier de configuration du canon
/wc target <id> <world>	Joueur	Change le monde d'atterrissage cible du canon
/wc center <id>	Joueur	Fixe le centre de recherche du canon à votre position actuelle
/wc list	Tous	Présente chaque placement avec son nom d'affichage, son état, la taille de sa file et le dernier détail de statut
/wc status	Tous	Affiche les mêmes informations que /wc list
/wc probe	Joueur	Vérifie si votre position actuelle passe toutes les protections activées
/wc reload	Tous	Recharge entièrement CannonRTP : chaque fichier de configuration, chaque canon et chaque adaptateur de protection, ainsi que tout ce qui attend dans le dossier imports/
/wc setup	Joueur	Ouvre le navigateur de contenu Nightbreak, qui présente les packs de canons installés et téléchargeables
/wc recommendedplugins	Tous	Ouvre le catalogue Nightbreak des plugins complémentaires recommandés pour CannonRTP
/wc downloadpluginupdate	Tous	Télécharge un JAR CannonRTP plus récent depuis Nightbreak. Il est utilisé au prochain redémarrage du serveur, ou plus tôt si nightbreak.applyPluginUpdatesWithoutRestart vaut when-empty ou immediately dans config.yml
/wc applypluginupdate	Tous	Applique sans redémarrage une mise à jour de CannonRTP déjà téléchargée, en rechargeant le plugin depuis le nouveau JAR. Refusée lorsqu'aucune mise à jour valide et plus récente n'est en attente, lorsqu'un plugin d'un autre auteur dépend de CannonRTP (dépendance ou dépendance optionnelle), ou pendant qu'un autre remplacement de plugin est en cours. Si le nouveau JAR ne parvient pas à s'activer, l'ancien JAR est rechargé et la mise à jour reste dans le dossier de mise à jour pour le prochain redémarrage. Voir Appliquer les mises à jour sans redémarrage.
/wc downloadall	Tous	Télécharge la mise à jour du plugin CannonRTP et tous les packs de contenu disponibles sur Nightbreak
/wc downloadallcontent	Tous	Télécharge tous les packs de contenu CannonRTP disponibles sur Nightbreak, sans le JAR du plugin
/wc updatecontent	Tous	Télécharge les mises à jour des packs de contenu CannonRTP obsolètes ; alias : /wc updateallcontent
/wc forcereinstallcontent <package|all>	Tous	Télécharge de nouveau le contenu Nightbreak même si la copie locale est à jour. Cette commande permet de réparer les fichiers d'un pack endommagés ou modifiés à la main. Utilisez all pour tous les packs déjà téléchargés, ou la complétion par tabulation pour choisir l'identifiant d'un pack Nightbreak : free-cannon-model ou cannonrtp-premium-cannon-model.

/wc initialize ouvre le menu de première configuration pour les joueurs possédant cannonrtp.admin. /wc setup ouvre le navigateur de contenu. L'initialisation partagée enregistre les deux commandes ; l'existence d'initialize ne dépend pas des modes prédéfinis.

Tant que la configuration n'est pas marquée comme terminée (setupDone dans config.yml), les joueurs possédant cannonrtp.admin reçoivent un rappel dans le chat environ 10 secondes après leur connexion, avec des liens cliquables vers /wc initialize et /wc setup. Chaque choix du menu de première configuration (Recommended Setup, Manual Setup, Use Current Content) passe setupDone à true et arrête le rappel.

Toutes les sous-commandes d'administration ci-dessus nécessitent cannonrtp.admin.

Ces commandes Nightbreak sont intégrées à CannonRTP

/wc setup, /wc initialize, /wc recommendedplugins, /wc downloadpluginupdate, /wc applypluginupdate, /wc downloadall, /wc downloadallcontent, /wc updatecontent et /wc forcereinstallcontent sont fournies par la bibliothèque partagée MagmaCore, intégrée par shading à CannonRTP. Elles sont enregistrées automatiquement et n'apparaissent donc pas dans plugin.yml. La commande distincte /nightbreaklogin <token>, également fournie par MagmaCore, enregistre le jeton de votre compte Nightbreak pour les téléchargements premium, et /nightbreaklogout le déconnecte (voir Déconnecter un serveur).

MagmaCore enregistre aussi /wcchangelog, qui présente aux administrateurs les notes de version non lues de CannonRTP et des packs de canons. Voir Notifications de notes de version.

Consultez Packs de contenu pour savoir précisément ce que gèrent /wc setup, /wc downloadall et /wc updatecontent.

Différence entre create, place, remove et delete

Une configuration de canon, plugins/CannonRTP/cannons/<id>.yml, peut servir à plusieurs placements dans le monde. create crée la configuration et son premier placement. place ajoute un placement à une configuration existante. remove retire un seul placement, le plus proche de vous dans votre monde, tout en conservant la configuration. delete supprime entièrement le fichier de configuration et donc tous ses placements. Les trois fichiers intégrés (example_cannonrtp, cannonrtp_free_cannon, cannonrtp_premium_cannon) reviennent avec leurs valeurs par défaut et sans placement lors du rechargement qui suit.

Interaction des joueurs

Il n'existe aucune commande destinée aux joueurs pour activer un canon. Ils utilisent CannonRTP en entrant dans son rayon de déclenchement : triggerRadius, fixé par défaut à 1,75 bloc.

Permissions

Deux permissions sont enregistrées dans plugin.yml :

Permission	Valeur par défaut	Description
cannonrtp.admin	op	Nécessaire pour chaque sous-commande d'administration, y compris les commandes Nightbreak intégrées setup, downloadall et updatecontent
cannonrtp.use	true	Nécessaire pour qu'un joueur puisse déclencher un canon

Les commandes partagées /nightbreaklogin <token> et /nightbreaklogout, fournies par MagmaCore et absentes du plugin.yml de CannonRTP, utilisent leur propre permission nightbreak.login, accordée par défaut à op.

Fonctionnement de cannonrtp.use

Si un joueur ne possède pas cannonrtp.use, le canon l'ignore silencieusement. Aucun message de refus n'est envoyé pour cette vérification de base : le joueur traverse simplement la zone du canon sans être lancé.

Permission propre à chaque canon

Chaque configuration de canon peut également définir le champ requiredPermission.

• Si requiredPermission est vide, comme par défaut, le canon vérifie uniquement cannonrtp.use.
• Si requiredPermission est défini et que le joueur possède cannonrtp.use mais pas la permission propre au canon, CannonRTP lui envoie le message configuré noPermission, contenant le nom d'affichage du canon. Ce message est limité à un envoi toutes les trois secondes par joueur et par canon.

Complétion par tabulation

Les commandes portant sur un canon existant, place, remove, delete, target et center, proposent les <id> connus et n'acceptent qu'un identifiant déjà existant. /wc create fait exception : <id> et <display_name> sont du texte libre ; la complétion affiche donc uniquement ces indications. Les commandes qui prennent un argument <world> proposent les noms des mondes actuellement chargés. /wc forcereinstallcontent propose all et l'identifiant de chaque pack Nightbreak.