Installation de MegaBlock Survivors

Le processus d'installation de MegaBlock Survivors est construit autour des paquets de contenu geres par Nightbreak, avec un support optionnel de modeles via FreeMinecraftModels.

Prerequis

• Java 21
• Un serveur compatible Paper/Spigot sur la ligne API 1.21

Integrations optionnelles :

• FreeMinecraftModels pour les modeles personnalises de mobs et d'armes (dependance optionnelle)

Ce que MegaBlock Survivors cree

Au demarrage, MegaBlock Survivors initialise ou utilise ces chemins :

plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt

Configuration

config.yml contient :

Cle	Type	Defaut	Description
setupDone	boolean	false	Indique si la configuration initiale a ete completee

Avertissement de premiere configuration

Lorsque setupDone est false, le plugin affiche un avertissement de premiere configuration aux joueurs disposant de la permission megablocksurvivors.* lorsqu'ils se connectent. Cela les guide a travers le telechargement initial du contenu.

Procedure recommandee pour la premiere utilisation

1. Installez MegaBlock Survivors et demarrez le serveur une premiere fois.
2. Liez votre compte Nightbreak avec /nightbreaklogin <token>.
3. Executez /mbs downloadall pour telecharger tous les paquets de contenu MegaBlock Survivors accessibles dans plugins/MegaBlockSurvivors/imports.
4. Executez /mbs setup a tout moment pour parcourir, activer, desactiver ou mettre a jour des paquets individuels.
5. Executez /mbs reload apres avoir telecharge du contenu pour charger les nouvelles cartes et ressources.

/nightbreaklogin <token> fait partie du flux de compte partage Nightbreak/MagmaCore, ce n'est pas une commande declaree dans le plugin.yml de MegaBlock Survivors.

Paquets de contenu

Les paquets de contenu sont configures via des fichiers YAML dans le dossier content_packages/. Chaque paquet peut definir :

Champ	Type	Description
isEnabled	boolean	Si le paquet est actif
name	string	Nom d'affichage du paquet
description	liste de string	Lignes de description
downloadLink	string	URL de telechargement manuel
version	integer	Numero de version du paquet
nightbreakSlug	string	Slug de contenu Nightbreak pour les telechargements automatiques
schematicFiles	liste de string	Fichiers de schematics inclus dans le paquet
worldFolders	liste de string	Dossiers de monde inclus
worldContainerFolders	liste de string	Dossiers de conteneur de monde inclus
modelFolders	liste de string	Dossiers de modeles pour FreeMinecraftModels
markerFileName	string	Fichier marqueur pour detecter si le paquet est installe
category	enum	FREE, PREMIUM, ou RESOURCES
toggleable	boolean	Si le paquet peut etre active/desactive

Notifications de mise a jour de version

Lorsque le plugin detecte une mise a jour de version (en comparant avec version.txt), il notifie la console et tous les OPs en ligne du changement de version.