Packs de contenu CannonRTP

CannonRTP gère les modèles officiels de canons comme des packs de contenu Nightbreak. Les téléchargements actuels Free Cannon et Premium Cannon contiennent le modèle FreeMinecraftModels et un marqueur de version du pack dans content_packages/. CannonRTP génère lui-même les configurations de canon correspondantes dans cannons/ ; les téléchargements ne fournissent pas de configurations de placement.

Commandes principales

Commande	Rôle
/wc setup	Ouvre le navigateur de contenu Nightbreak, qui présente les packs de canons installés et téléchargeables
/wc downloadall	Télécharge la mise à jour du plugin CannonRTP et tous les packs de contenu disponibles sur Nightbreak
/wc updatecontent	Met à jour tous les packs de contenu CannonRTP obsolètes ; alias : /wc updateallcontent
/wc reload	Recharge CannonRTP après une importation manuelle
/nightbreaklogin <token>	Enregistre le jeton Nightbreak partagé, nécessaire pour les packs premium

Les commandes de gestion /wc nécessitent cannonrtp.admin. La commande de compte distincte /nightbreaklogin <token> nécessite nightbreak.login.

En plus des packs de canons, le menu /wc setup affiche une entrée de mise à jour du plugin (cliquez dessus pour télécharger une mise à jour disponible), une entrée de plugins recommandés, une entrée de téléchargement global qui exécute /wc downloadall, et un bouton de mises à jour automatiques qui écrit nightbreak.autoDownloadPluginUpdates dans config.yml (voir Configuration).

Packs intégrés

CannonRTP fournit par défaut les définitions de deux packs Nightbreak :

Identifiant du pack	Nom affiché	Source
cannonrtp	Free CannonRTP	Téléchargement gratuit sur Nightbreak
cannonrtp_premium	Premium CannonRTP	Nécessite un accès de soutien premium Nightbreak

Chaque définition se trouve dans plugins/CannonRTP/content_packages/<id>.yml et contient :

• isEnabled — indique si le pack est activé ; le menu /wc setup l'écrit lorsque vous activez ou désactivez le pack
• version — version installée localement, utilisée par /wc updatecontent pour repérer les packs obsolètes
• name et description — textes affichés dans le menu /wc setup
• downloadLink — page Nightbreak vers laquelle CannonRTP vous oriente lorsqu'un pack n'a pas de nightbreakSlug et doit être téléchargé à la main, et lien de l'avertissement de la console concernant un pack obsolète
• folderName et contentFilePrefixes — fichiers du pack que CannonRTP considère comme lui appartenant
• nightbreakSlug — identifiant de projet Nightbreak utilisé par le service de téléchargement et de mise à jour

Il n'est normalement pas nécessaire de modifier ces fichiers à la main : le plugin les régénère et les réécrit.

États des packs

Dans le menu /wc setup, chaque pack présente l'un des états suivants :

• installé — le pack satisfait aux vérifications de téléchargement ci-dessous, ses métadonnées indiquent isEnabled: true et les entrées de canons correspondantes sont présentes dans plugins/CannonRTP/cannons/
• téléchargé mais désactivé — le téléchargement du modèle est reconnu, mais le pack n'est pas actif ; le désactiver dans le menu déplace ses fichiers vers plugins/CannonRTP/cannons_disabled/
• obsolète — le pack est installé et une version plus récente est disponible sur Nightbreak ; si votre compte lié n'y a plus accès, le menu l'indique au lieu de proposer la mise à jour
• accès requis — le pack n'est pas téléchargé, vous êtes connecté et votre compte Nightbreak n'y a pas accès
• non téléchargé — le marqueur de version locale n'est pas positif ou les fichiers du modèle sont introuvables

Les fichiers YAML générés pour les canons ne prouvent pas à eux seuls que le pack a été téléchargé. CannonRTP exige une version locale supérieure à zéro et au moins un fichier .bbmodel dans le dossier folderName du pack, sous plugins/FreeMinecraftModels/models/ ou plugins/FreeMinecraftModels/Models/. Si le dossier du modèle manque, le pack redevient téléchargeable même si sa configuration de canon générée existe encore.

Cliquer sur un pack dans le menu permet de le télécharger, de l'installer, de l'activer ou de le désactiver. Désactiver un pack déplace ses configurations de canons de cannons/ vers cannons_disabled/ sans les supprimer ; sa réactivation restaure donc les mêmes fichiers. CannonRTP recrée ses fichiers intégrés cannonrtp_free_cannon.yml et cannonrtp_premium_cannon.yml dès qu'ils manquent dans cannons/ : après une désactivation, le rechargement y laisse donc des copies par défaut sans placement, et la réactivation remet les fichiers sauvegardés à leur place.

Organisation des dossiers de canons

Dossier	Rôle
plugins/CannonRTP/cannons/	Configurations actives des canons. Leur contenu est chargé au démarrage ou avec /wc reload.
plugins/CannonRTP/cannons_disabled/	Configurations de canons issues de packs actuellement désactivés. Le chargeur ignore ces fichiers, mais les conserve pour une réactivation ultérieure.
plugins/CannonRTP/imports/	Dossier où déposer les packs à importer manuellement. CannonRTP le parcourt au démarrage et fusionne son contenu dans les dossiers des packs.

Importation manuelle

Vous pouvez toujours installer un pack à la main :

1. Téléchargez son fichier zip depuis Nightbreak.
2. Déposez le zip intact dans plugins/CannonRTP/imports/.
3. Exécutez /wc reload.

CannonRTP récupère le pack, déplace les fichiers dans les dossiers appropriés et recharge les configurations des canons. L'importation manuelle reste possible, mais n'est plus la méthode recommandée : /wc setup et /wc downloadall s'en chargent automatiquement.

Accès premium

Les packs de contenu premium, comme cannonrtp_premium, nécessitent un compte Nightbreak lié. Exécutez une fois /nightbreaklogin <token> avec un jeton obtenu sur la page de votre compte Nightbreak. Vous pourrez ensuite récupérer le contenu premium avec /wc downloadall ou le menu /wc setup.

Si vous n'êtes pas connecté, les packs premium restent visibles dans le menu de configuration, mais ne peuvent pas être téléchargés.