Configuration Nightbreak et gestion du contenu

Cette page est le guide de configuration partage pour les plugins geres par Nightbreak.

Elle s'applique directement a :

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

Ces plugins partagent maintenant le meme cycle de vie general :

1. Installez le plugin et toutes les dependances obligatoires.
2. Demarrez le serveur une premiere fois pour generer les fichiers et les menus.
3. Lancez la commande de premiere configuration du plugin si elle existe.
4. Associez un jeton Nightbreak avec /nightbreaklogin <token>.
5. Utilisez le menu de configuration du plugin pour parcourir, installer, activer, desactiver et mettre a jour le contenu.
6. Utilisez les commandes de telechargement ou de mise a jour en masse si vous voulez un bootstrap initial plus rapide.

Ce que MagmaCore partage reellement

MagmaCore est la couche commune derriere le flux gere par Nightbreak. Il fournit :

• la commande partagee /nightbreaklogin <token>
• le stockage partage du jeton dans plugins/MagmaCore/nightbreak.yml
• les primitives de menu de configuration partagees utilisees par les menus de configuration des plugins
• les controles partages d'acces Nightbreak, de version et de telechargement
• la logique partagee de telechargement en masse qui place les fichiers dans le dossier imports du plugin proprietaire

Les commandes specifiques au plugin comme /em initialize ou /bs setup restent implementees par chaque plugin. MagmaCore fournit les systemes partages utilises par ces commandes.

Schema commun de premiere configuration

La plupart des plugins actuels geres par Nightbreak exposent :

Plugin	Commande initiale	Menu de configuration	Installation en masse	Mise a 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 de premiere configuration. Il ne remplace pas le menu de configuration specifique au plugin ni les commandes de gestion du contenu.

MagmaCore dispose egalement d'un systeme d'initialisation au demarrage du plugin, mais ce n'est pas la meme chose que les commandes initialize destinees aux joueurs et documentees ici.

Flux recommande pour les administrateurs de serveur

1. Installer d'abord le plugin

Placez le jar du plugin et les dependances obligatoires dans plugins/, puis demarrez le serveur une premiere fois.

2. Lancer le flux de premiere configuration

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

• marquer la premiere configuration comme terminee
• vous orienter vers l'association du compte Nightbreak
• vous guider vers le menu de configuration actuel
• clarifier quand les imports manuels restent valides

Le comportement du menu de premiere configuration est partage, mais le nom exact de la commande et la logique de suivi restent specifiques a chaque plugin.

3. Associer votre compte Nightbreak

Allez sur la page de compte Nightbreak, recuperez le jeton du serveur, puis lancez :

/nightbreaklogin <token>

Le jeton est partage par MagmaCore, donc un seul jeton associe peut etre reutilise par tous les plugins MagmaGuy compatibles sur ce serveur.

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

Les menus de configuration sont aujourd'hui la source de verite pour :

• l'etat des packages
• l'etat des acces
• le contenu installe par rapport au contenu seulement telecharge
• le contenu partiellement installe qui doit etre repare
• le contenu obsolete
• les filtres de contenu par categorie

Si vous avez associe un jeton, les menus de configuration sont le moyen recommande pour installer et mettre a jour le contenu.

5. Utiliser les commandes de masse quand vous voulez aller vite

Utilisez la commande downloadall si vous voulez initialiser rapidement un serveur, et updatecontent si vous voulez actualiser tout ce qui est obsolete.

Le telechargeur partage en masse ne tente que les packages geres par Nightbreak qui :

• ont un slug Nightbreak
• sont accessibles avec le jeton associe
• ne sont pas encore telecharges, ou sont marques comme obsoletes

La plupart des plugins actuels se rechargent automatiquement apres un telechargement en masse reussi.

Concepts partages

Telecharge mais pas installe

Un package peut exister localement sans etre active. La signification exacte varie legerement selon le plugin, mais l'etat affiche dans le menu de configuration est plus important que la simple presence d'un zip dans imports.

Les telechargements en masse sont egalement places dans le meme dossier imports du plugin que les imports manuels avant que l'etape specifique d'import ou de rechargement du plugin ne se termine.

Contenu dependant de l'acces

Les menus de configuration peuvent maintenant distinguer le contenu qui :

• est disponible pour votre jeton
• doit etre achete ou debloque
• est installe
• est seulement partiellement installe
• est telecharge mais desactive
• est obsolete

Les imports manuels restent valides

Les plugins geres par Nightbreak prennent toujours en charge les flux d'import manuel. L'import manuel est maintenant la solution de repli, pas le chemin par defaut. Voir Imports manuels vs gestion en jeu.

Plugins qui n'utilisent pas ce flux

Tous les plugins de ce wiki n'utilisent pas le contenu telechargeable gere par Nightbreak.

• BetterFood n'utilise pas la gestion de packages Nightbreak
• ResurrectionChest n'utilise pas la gestion de packages Nightbreak
• WorldCannon n'utilise pas la gestion de packages Nightbreak
• ResourcePackManager gere les resource packs, pas les packages DLC Nightbreak