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/
plugins/Extractioncraft/schematics/

Le dossier schematics/ contient les données réelles des cartes BetterStructures pour chaque paquet de contenu installé, dans un sous-dossier nommé d'après le folderName du paquet (par exemple schematics/kobold_mines_10/).

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 est installé et qu'au moins une configuration de schematic BetterStructures est disponible, puis propose un bouton « Compléter la configuration initiale ».
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.
2. Le plugin génère le monde instancié de manière asynchrone via BetterStructures. Vous êtes téléporté à l'intérieur une fois qu'il est prêt.
3. D'autres joueurs peuvent rejoindre. Lorsque le nombre minimum de joueurs est atteint, 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).