Installation d'Extractioncraft

Compatibilité de la version de développement

Cette section décrit les sources 1.0-SNAPSHOT d'Extractioncraft, et non une combinaison de versions publiée et vérifiée. Les sources actuelles sont compilées avec BetterStructures 2.7.6 et EliteMobs 10.9.7 et appellent directement leurs API. Utilisez un ensemble de builds compatibles et testés avant d'ouvrir un serveur aux joueurs ; installer les dernières versions des plugins complémentaires ne suffit pas à établir leur compatibilité.

Prérequis

• Le plugin cible le bytecode Java 21 ; utilisez l'environnement Java requis par la version du serveur choisie
• Un serveur Paper/Spigot compatible : le descripteur déclare 1.21.4, tandis que la compilation actuelle utilise Spigot API 26.3-R0.1-SNAPSHOT. Ces valeurs ne définissent pas une plage de versions de serveur testée
• BetterStructures, déclaré comme dépendance facultative, mais requis au démarrage
• EliteMobs, déclaré comme dépendance facultative, mais requis au démarrage
• FreeMinecraftModels, déclaré comme dépendance facultative, mais requis au démarrage
• WorldEdit ou FastAsyncWorldEdit, que BetterStructures utilise pour générer les cartes

Au démarrage, Extractioncraft attend que BetterStructures, EliteMobs et FreeMinecraftModels aient fini de se charger, puis leur laisse jusqu'à 5 minutes pour recharger le contenu qu'il vient d'importer. Si l'un d'eux est absent, échoue à se charger ou est encore en cours de rechargement passé ce délai, Extractioncraft journalise ExtractionCraft initialization failed et ses commandes ne sont pas enregistrées.

Fichiers créés par Extractioncraft

Au démarrage, Extractioncraft initialise les chemins suivants :

plugins/Extractioncraft/config.yml
plugins/Extractioncraft/messaging.yml
plugins/Extractioncraft/content_packages/
plugins/Extractioncraft/loot_pools/
plugins/Extractioncraft/loot_tables/
plugins/Extractioncraft/imports/

content_packages/ contient dès le départ les cinq configurations Kobold Mines. loot_pools/ et loot_tables/ sont initialement vides. Les tables référencées par ces packs (kobold_mines_equipment_loot_table.yml et kobold_mines_supplies_loot_table.yml) sont fournies avec le pack de contenu téléchargeable, pas avec le JAR du plugin.

Le pack de contenu contient aussi les données des cartes, qui résident dans les plugins complémentaires : les générateurs de modules, modules, composants et pools d'apparition vont dans BetterStructures, les boss et objets dans EliteMobs, et les modèles dans FreeMinecraftModels. Un pack est considéré comme téléchargé dans /exc setup lorsque BetterStructures a chargé le générateur de modules indiqué dans son betterStructuresModulesContainerName.

Procédure de première installation recommandée

1. Installez Extractioncraft avec BetterStructures, EliteMobs, FreeMinecraftModels et WorldEdit ou FastAsyncWorldEdit. Démarrez le serveur une fois.
2. Exécutez /exc initialize pour ouvrir le menu de première configuration. Son panneau d'état est rouge si ni WorldEdit ni FastAsyncWorldEdit n'est activé, jaune si aucun pack n'est à la fois activé et associé à un générateur de modules chargé, et vert dès qu'un pack est prêt. Cliquez sur le panneau pour connaître les étapes suivantes. La tête de joueur renvoie vers la page d'Extractioncraft sur nightbreak.io et vers le Discord.
3. Téléchargez le pack de contenu sur nightbreak.io.
4. Placez le ZIP téléchargé dans le dossier plugins/Extractioncraft/imports/.
5. Exécutez /exc reload ou redémarrez le serveur. L'importateur décompresse le ZIP dans les dossiers d'Extractioncraft, BetterStructures, EliteMobs et FreeMinecraftModels. Extractioncraft recharge ensuite BetterStructures, ainsi qu'EliteMobs si le pack a ajouté du contenu EliteMobs, puis attend que les plugins complémentaires aient fini de se charger.
6. Exécutez /exc setup pour parcourir et gérer les packs de contenu. Chaque pack affiche un état coloré : vert pour installé, jaune pour téléchargé mais non installé, rouge pour non téléchargé. Cliquer sur un pack vert le désactive, cliquer sur un pack jaune l'active, et cliquer sur un pack rouge affiche son lien de téléchargement avec la consigne de placer le fichier dans le dossier d'importation puis d'exécuter /exc reload. Le menu contient aussi une entrée Plugins recommandés et un bouton d'information représenté par une tête de joueur, avec des liens vers le wiki, le Discord, la page du jeton de votre compte, /extractioncraft recommendedplugins et /nightbreak plugins.

Les packs de contenu ne se téléchargent pas en jeu ; utilisez le lien de téléchargement et le dossier d'importation.

Outils de configuration MagmaCore partagés

MagmaCore étant intégré à Extractioncraft, le plugin fournit les outils Nightbreak communs :

• Plugins recommandés — /exc recommendedplugins, ou l'entrée correspondante dans /exc setup, présente les plugins complémentaires et indique lesquels sont déjà installés.
• Jeton de compte et contenu sous licence — /nightbreaklogin enregistre le jeton de votre compte nightbreak.io pour permettre au serveur de télécharger en jeu le contenu sous licence.
• Catalogue de plugins — /nightbreak plugins ouvre le catalogue des autres plugins de MagmaGuy.

Contenu fourni

Extractioncraft fournit les configurations des packs suivants, de la série Kobold Mines :

Pack	Fichier de configuration	Niveau	Joueurs maximum
Kobold Mines 10	kobold_mines_10.yml	10	8
Kobold Mines 20	kobold_mines_20.yml	20	8
Kobold Mines 30	kobold_mines_30.yml	30	8
Kobold Mines 40	kobold_mines_40.yml	40	8
Kobold Mines 50	kobold_mines_50.yml	50	8

Le niveau correspond au contentLevel du pack, utilisé pour le butin des conteneurs. Les boss des pools d'apparition du pack de contenu apparaissent au même niveau. Chaque carte comporte des zones Normal, Hard et Mythic, la plus difficile se trouvant au centre ; voir Butin des mobs tués.

Tous utilisent BetterStructures, FreeMinecraftModels et EliteMobs. Le PvP est activé par défaut. Les données des cartes doivent être téléchargées séparément via le lien de contenu du menu de configuration.

Démarrer une partie

Une fois le contenu installé :

1. Exécutez /exc createMatch <contentPackage.yml>, par exemple /exc createMatch kobold_mines_10.yml. La complétion propose tous les packs de contenu chargés au démarrage. La commande refuse un pack désactivé, ou dont le générateur de modules est absent, désactivé, n'est pas un générateur de monde ou ne possède aucun module de départ installé.
2. Le plugin génère le monde instancié via BetterStructures, à partir du betterStructuresModulesContainerName du pack. La génération prend du temps et affiche une barre de boss de progression ; vous êtes téléporté à un point d'apparition aléatoire du nouveau monde lorsqu'il est prêt. La génération est annulée si elle dure plus de 15 minutes, si vous vous déconnectez ou si vous exécutez /exc leave.
3. Extractioncraft n'enregistre aucune commande pour rejoindre une partie : celle-ci ne contient donc que son créateur. Une fois minPlayers atteint, soit 1 par défaut, n'importe quel joueur de la partie peut exécuter /exc start.
4. Pour quitter une partie à tout moment, utilisez /exc leave ou /exc quit. Partir après le lancement de la partie compte comme une extraction échouée ; voir Déroulement des parties.