Configuration de Nightbreak et gestion de contenu

Cette page est le guide de configuration partagé pour les plugins gérés par Nightbreak.

Il s'applique directement à :

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

Ces plugins partagent désormais le même cycle de vie global :

1. Installez le plugin et toutes les dépendances obligatoires.
2. Démarrez le serveur une fois pour que les fichiers et menus soient générés.
3. Exécutez la commande de configuration initiale du plugin s'il en possède une.
4. Liez un token Nightbreak avec /nightbreaklogin <token>.
5. Utilisez le menu de configuration du plugin pour parcourir, installer, activer, désactiver et mettre à jour le contenu.
6. Utilisez les commandes de téléchargement/mise à jour en masse du plugin lorsque vous souhaitez un démarrage initial plus rapide.

Ce que MagmaCore partage réellement

MagmaCore est la couche partagée derrière le flux géré par Nightbreak. Il fournit :

• la commande partagée /nightbreaklogin <token>
• le stockage partagé du token dans plugins/MagmaCore/nightbreak.yml
• les primitives partagées du menu de configuration utilisées par les menus de configuration des plugins
• les vérifications partagées d'accès, de version et de téléchargement Nightbreak
• la logique partagée de téléchargement en masse qui télécharge les fichiers dans le dossier imports du plugin propriétaire

Les commandes spécifiques aux plugins telles que /em initialize ou /bs setup sont toujours implémentées par chaque plugin. MagmaCore fournit les systèmes partagés que ces commandes utilisent.

Modèle partagé de première utilisation

La plupart des plugins actuels gérés par Nightbreak exposent :

Plugin	Commande initiale	Menu de configuration	Installation en masse	Mise à jour en masse
EliteMobs	/em initialize	/em setup	/em downloadall	/em updatecontent
BetterStructures	/bs initialize	/bs setup	/bs downloadall	/bs updatecontent
FreeMinecraftModels	/fmm initialize	/fmm setup	/fmm downloadall	/fmm updatecontent
EternalTD	/etd initialize	/etd setup	/etd downloadall	/etd updatecontent

initialize est un flux de guidage initial. Il ne remplace pas le menu de configuration spécifique au plugin ni les commandes de gestion de contenu.

MagmaCore possède également un système d'initialisation séparé au démarrage du plugin, mais ce n'est pas la même chose que les commandes initialize destinées aux joueurs documentées ici.

Flux recommandé pour les propriétaires de serveurs

1. Installez d'abord le plugin

Placez le fichier jar du plugin et toutes les dépendances obligatoires dans plugins/, puis démarrez le serveur une fois.

2. Exécutez le flux de configuration initiale

Si le plugin expose une commande initialize, utilisez-la en premier. Les menus actuels sont conçus pour :

• marquer la configuration initiale comme terminée
• vous diriger vers la liaison de compte Nightbreak
• vous diriger vers le menu de configuration actuel
• clarifier quand les importations manuelles sont encore valides

Le comportement du menu de première utilisation est lui-même partagé, mais le nom exact de la commande et la logique de suivi restent spécifiques au plugin.

3. Liez votre compte Nightbreak

Rendez-vous sur la page du compte Nightbreak, obtenez votre token de serveur et exécutez :

/nightbreaklogin <token>

Le token est partagé via MagmaCore, donc un token lié peut être réutilisé par tous les plugins MagmaGuy compatibles sur ce serveur.

4. Utilisez le menu de configuration pour la gestion quotidienne du contenu

Les menus de configuration sont la source de référence actuelle pour :

• les états des paquets
• les états d'accès
• le contenu installé vs téléchargé
• le contenu partiellement installé nécessitant une réparation
• le contenu obsolète
• les filtres de contenu par catégorie

Si vous avez un token lié, les menus de configuration sont l'endroit recommandé pour installer et mettre à jour le contenu.

5. Utilisez l'installation/mise à jour en masse pour la rapidité

Utilisez la commande downloadall lorsque vous souhaitez configurer un serveur rapidement et la commande updatecontent lorsque vous souhaitez rafraîchir tout ce qui est obsolète.

Le téléchargeur en masse partagé ne tente que les paquets gérés par Nightbreak qui :

• ont un slug Nightbreak
• sont accessibles au token lié
• ne sont pas encore téléchargés ou sont marqués comme obsolètes

La plupart des plugins actuels se rechargent automatiquement après des téléchargements en masse réussis.

Concepts partagés

Téléchargé vs installé

Un paquet peut exister localement sans être activé. La signification exacte varie légèrement selon le plugin, mais l'état du menu de configuration compte plus que l'existence d'un zip dans imports.

Les téléchargements en masse atterrissent également dans le même dossier imports du plugin utilisé par les importations manuelles avant que l'étape d'importation/rechargement spécifique au plugin ne se termine.

Contenu sensible aux accès

Les menus de configuration peuvent désormais distinguer entre le contenu qui :

• est disponible pour votre token
• doit être acheté ou déverrouillé
• est installé
• n'est que partiellement installé
• est téléchargé mais désactivé
• est obsolète

Les importations manuelles sont toujours valides

Les plugins gérés par Nightbreak supportent toujours les flux d'importation manuelle. L'importation manuelle est désormais le chemin de secours, pas le chemin par défaut. Voir Importations manuelles vs gestion en jeu.

Plugins qui n'utilisent pas ce flux

Tous les plugins de ce wiki n'utilisent pas le contenu téléchargeable géré par Nightbreak.

• BetterFood n'utilise pas la gestion de paquets Nightbreak
• ResurrectionChest n'utilise pas la gestion de paquets Nightbreak
• WorldCannon n'utilise pas la gestion de paquets Nightbreak
• ResourcePackManager gère les packs de ressources, pas les paquets DLC Nightbreak