Installation d'Extractioncraft

Prérequis

• Java 21
• Un serveur compatible Paper/Spigot sur la ligne d'API 1.21.4
• BetterStructures (dépendance optionnelle, requise pour le contenu premade)
• EliteMobs (dépendance optionnelle, requise pour le contenu premade)
• FreeMinecraftModels (dépendance optionnelle, requise pour le contenu premade)

Ce qu'Extractioncraft crée

Au démarrage, Extractioncraft initialise ces chemins :

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/ est pré-rempli avec les cinq fichiers de configuration premade des Kobold Mines. loot_pools/ et loot_tables/ sont vides au départ — les tables de butin référencées par les paquets premade (kobold_mines_chest_high_loot_table_10.yml et consorts) arrivent avec le pack de contenu téléchargeable, pas avec le jar du plugin.

Le dossier schematics/ n'est pas créé au démarrage. Il apparaît une fois le contenu installé et contient les données de carte de chaque paquet de contenu dans un sous-dossier nommé d'après le folderName du paquet (par exemple schematics/kobold_mines_10/). Extractioncraft se sert de la présence de ce sous-dossier pour déterminer si un paquet compte comme téléchargé dans /exc setup.

Procédure recommandée pour la première utilisation

1. Installez Extractioncraft avec BetterStructures, EliteMobs, FreeMinecraftModels et WorldEdit (ou FastAsyncWorldEdit). Démarrez le serveur une première fois.
2. Exécutez /exc initialize pour ouvrir le menu de configuration initiale. Celui-ci vérifie que WorldEdit (ou FastAsyncWorldEdit) est installé et qu'au moins une configuration de schematic BetterStructures est disponible, puis propose un bouton « Compléter la configuration initiale ». Comme les cartes sont du contenu BetterStructures, les liens d'aide de ce menu pointent vers la page d'installation de BetterStructures et vers le Discord commun.
3. Téléchargez les paquets de contenu depuis nightbreak.io.
4. Placez le contenu téléchargé dans le dossier plugins/Extractioncraft/imports/. Le plugin extraira les archives prises en charge au prochain démarrage.
5. Exécutez /exc reload ou redémarrez le serveur.
6. Exécutez /exc setup pour parcourir et gérer les paquets de contenu installés. Chaque paquet affiche un statut coloré (vert = installé, jaune = téléchargé mais non installé, rouge = non téléchargé) et une action de clic. Le menu de configuration comprend également une entrée Plugins recommandés et un bouton d'information (la tête de joueur) avec des liens vers le wiki, le Discord, la page du jeton de votre compte et les commandes de mise à jour.

Fonctionnalités de configuration partagées de MagmaCore

Comme MagmaCore est intégré à Extractioncraft, le plugin est livré avec les outils de configuration partagés de Nightbreak :

• Plugins recommandés — /exc recommendedplugins (ou l'entrée à l'intérieur de /exc setup) liste les plugins compagnons qui se marient bien avec Extractioncraft et indique lesquels sont déjà installés.
• Jeton de compte / contenu sous licence — /nightbreaklogin enregistre le jeton de votre compte nightbreak.io afin que le serveur puisse télécharger le contenu sous licence en jeu.
• Catalogue de plugins — /nightbreak plugins ouvre un catalogue navigable des autres plugins de MagmaGuy.

Contenu premade

Extractioncraft est livré avec une configuration pour les paquets de contenu premade suivants (série Kobold Mines) :

Paquet	Nom de fichier de config	Plage de niveau EliteMobs	Joueurs max
Kobold Mines 10	kobold_mines_10.yml	0-10	8
Kobold Mines 20	kobold_mines_20.yml	11-20	8
Kobold Mines 30	kobold_mines_30.yml	21-30	8
Kobold Mines 40	kobold_mines_40.yml	31-40	8
Kobold Mines 50	kobold_mines_50.yml	41-50	8

Tous les paquets premade utilisent BetterStructures, FreeMinecraftModels et EliteMobs. Le PvP est activé par défaut. Les données de carte doivent être téléchargées séparément depuis les liens de contenu affichés dans le menu de configuration.

Démarrer un match

Une fois le contenu installé :

1. Exécutez /exc createMatch <contentPackage.yml> (par exemple /exc createMatch kobold_mines_10.yml). L'argument auto-complète les noms de fichiers de paquets de contenu disponibles — y compris les paquets actuellement marqués comme non installés, si bien qu'un mauvais choix échouera à la génération du monde plutôt qu'au niveau de la commande.
2. Le plugin génère le monde instancié de manière asynchrone via BetterStructures, en utilisant le betterStructuresModulesContainerName du paquet. La génération n'est pas instantanée ; vous êtes téléporté à un point d'apparition aléatoire du nouveau monde une fois qu'il est prêt.
3. La build actuelle n'enregistre aucune commande pour rejoindre : le match ne contient donc que le joueur qui l'a créé — le maxPlayers du paquet (8 pour tous les paquets premade) est bien lu par le runtime de match partagé, mais rien ne peut l'atteindre. Une fois minPlayers atteint (1 par défaut), n'importe quel joueur du match peut exécuter /exc start.
4. Pour quitter un match à tout moment, exécutez /exc leave (ou /exc quit). Quitter un match en cours sans s'extraire détruit votre inventaire par défaut — voir déroulement d'un match.