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)

CannonRTP ne fournit pas de menu /wc initialize distinct pour la première utilisation -- il n'a pas de modes préréglés. La première fois qu'un administrateur se connecte après l'installation, un avertissement Nightbreak en chat l'invite à exécuter /wc setup.

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 et /wc updatecontent 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 prenant un argument <id> de canon proposent en auto-complétion la liste des identifiants de canon connus. Les commandes prenant un argument <world> proposent en auto-complétion la liste des noms de monde actuellement chargés.