Commandes et Permissions de CannonRTP

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

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

/wc est l'alias court que la plupart des administrateurs utiliseront, mais le nœud de permission sous-jacent reste cannonrtp.admin pour chaque sous-commande.

Commandes Administrateur

Commande	Émetteur	Description
/cannonrtp	N'importe qui	Affiche l'en-tête d'aide suivi de chaque sous-commande enregistrée que l'émetteur peut utiliser
/wc help	N'importe qui	Identique à /cannonrtp -- affiche la liste d'aide
/wc create <id>	Joueur	Crée une toute nouvelle configuration de canon et place la première instance à votre position actuelle
/wc create <id> <display_name>	Joueur	Identique à ci-dessus, mais définit un nom d'affichage personnalisé (les underscores deviennent des espaces)
/wc place <id>	Joueur	Ajoute un autre placement d'un canon existant à votre position actuelle
/wc remove <id>	Joueur	Supprime le placement le plus proche de <id> dans votre monde actuel (le fichier de configuration est conservé)
/wc delete <id>	N'importe qui	Supprime le fichier de configuration du canon
/wc target <id> <world>	Joueur	Change le monde d'atterrissage cible du canon
/wc center <id>	Joueur	Définit le centre de recherche du canon à votre position actuelle
/wc list	N'importe qui	Liste chaque placement avec le nom d'affichage, le statut, la taille de la file et le dernier détail de statut
/wc status	N'importe qui	Même sortie que /wc list
/wc probe	Joueur	Teste si votre position actuelle passerait toutes les vérifications de protection activées
/wc reload	N'importe qui	Recharge la configuration globale, chaque configuration de canon, les tâches et les adaptateurs de protection
/wc setup	Joueur	Ouvre le menu de style Nightbreak du navigateur de contenu (liste les packages de canons installés et téléchargeables)
/wc recommendedplugins	N'importe qui	Ouvre le catalogue Nightbreak des plugins compagnons recommandés pour CannonRTP
/wc downloadpluginupdate	N'importe qui	Télécharge un jar de plugin CannonRTP plus récent depuis Nightbreak (appliqué après le prochain redémarrage du serveur)
/wc downloadall	N'importe qui	Télécharge la mise à jour du plugin CannonRTP et tous les packages de contenu disponibles depuis Nightbreak
/wc downloadallcontent	N'importe qui	Télécharge tous les packages de contenu CannonRTP disponibles depuis Nightbreak (contenu uniquement, sans jar de plugin)
/wc updatecontent	N'importe qui	Télécharge les mises à jour des packages de contenu CannonRTP obsolètes (alias : /wc updateallcontent)
/wc forcereinstallcontent <package|all>	N'importe qui	Retélécharge le contenu depuis Nightbreak même lorsque la copie locale est déjà à jour -- à utiliser pour réparer des fichiers de package endommagés ou modifiés à la main. Passez all pour tous les packages déjà téléchargés, ou complétez par tabulation un unique slug de package Nightbreak (free-cannon-model, cannonrtp-premium-cannon-model).

/wc initialize ouvre la première configuration pour les joueurs avec cannonrtp.admin. /wc setup ouvre le navigateur de contenu. Les deux commandes sont enregistrées ; les modes prédéfinis ne déterminent pas l'existence d'initialize.

Toutes les sous-commandes administrateur ci-dessus nécessitent cannonrtp.admin.

Ces commandes Nightbreak sont fournies avec CannonRTP

/wc setup, /wc recommendedplugins, /wc downloadpluginupdate, /wc downloadall, /wc downloadallcontent, /wc updatecontent et /wc forcereinstallcontent sont fournies par la bibliothèque partagée MagmaCore intégrée (shaded) dans CannonRTP. Elles sont enregistrées automatiquement -- vous ne les voyez pas dans plugin.yml. La commande distincte /nightbreaklogin <token> (également issue de MagmaCore) enregistre le jeton de votre compte Nightbreak pour les téléchargements premium.

Consultez la page Packages de Contenu pour plus de détails sur ce que /wc setup, /wc downloadall et /wc updatecontent gèrent réellement.

create vs place vs remove vs delete

Une seule configuration de canon (plugins/CannonRTP/cannons/<id>.yml) peut piloter plusieurs placements en jeu. create crée la configuration et amorce le premier placement. place ajoute un autre placement à une configuration existante. remove supprime un placement (le plus proche de vous dans votre monde) mais conserve la configuration. delete supprime le fichier de configuration, retirant tous les placements.

Interaction Joueur

Il n'existe aucune commande joueur pour activer un canon. Les joueurs utilisent CannonRTP en marchant dans le rayon de déclenchement du canon (triggerRadius, 1,75 bloc par défaut).

Permissions

Deux nœuds de permission sont enregistrés dans plugin.yml :

Permission	Défaut	Description
cannonrtp.admin	op	Requis pour chaque sous-commande administrateur (y compris les commandes Nightbreak intégrées setup / downloadall / updatecontent)
cannonrtp.use	true	Requis pour qu'un joueur puisse déclencher un canon

La commande partagée /nightbreaklogin <token> (fournie par MagmaCore, non déclarée dans le plugin.yml de CannonRTP) utilise son propre nœud de permission nightbreak.login.

Fonctionnement de cannonrtp.use

Si un joueur n'a pas cannonrtp.use, le canon ignore silencieusement ce joueur. Aucun message de refus n'est envoyé pour cette vérification de permission de base -- il traverse simplement la zone du canon sans être lancé.

Verrou de Permission par Canon

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

• Si requiredPermission est vide (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 le nœud propre au canon, CannonRTP envoie le message noPermission configuré incluant le nom d'affichage du canon. Le message est limité à une fois toutes les trois secondes par joueur et par canon.

Auto-complétion

Les commandes qui agissent sur un canon existant (place, remove, delete, target, center) proposent en auto-complétion l'<id> depuis la liste des identifiants de configuration de canon connus, et n'acceptent qu'un identifiant qui existe déjà. /wc create fait exception : son <id> et son <display_name> sont du texte libre, l'auto-complétion n'affiche donc que l'indication <id> / <display_name>. Les commandes prenant un argument <world> proposent en auto-complétion la liste des noms de monde actuellement chargés, et /wc forcereinstallcontent propose all ainsi que chaque slug de package Nightbreak.