Extractioncraft Einrichtung

Kompatibilität des Entwicklungsstands

Dieser Abschnitt beschreibt den Quellcodestand 1.0-SNAPSHOT von Extractioncraft, keine verifizierte Kombination veröffentlichter Versionen. Der aktuelle Quellcode kompiliert gegen BetterStructures 2.7.6 und EliteMobs 10.9.7 und ruft deren APIs direkt auf. Verwende zusammen getestete, aufeinander abgestimmte Builds, bevor du einen Server für Spieler öffnest. Die Installation der neuesten Begleit-Plugins allein belegt keine Kompatibilität.

Voraussetzungen

• Das Plugin erzeugt Bytecode für Java 21; verwende die von deiner Serverversion benötigte Java-Laufzeit
• Ein kompatibler Paper/Spigot-Server: Der Deskriptor deklariert 1.21.4, während der aktuelle Build gegen Spigot API 26.3-R0.1-SNAPSHOT kompiliert. Diese Werte belegen keinen getesteten Bereich von Serverversionen
• BetterStructures (als Soft-Dependency deklariert, für den Start erforderlich)
• EliteMobs (als Soft-Dependency deklariert, für den Start erforderlich)
• FreeMinecraftModels (als Soft-Dependency deklariert, für den Start erforderlich)
• WorldEdit oder FastAsyncWorldEdit, womit BetterStructures die Karten generiert

Beim Start wartet Extractioncraft, bis BetterStructures, EliteMobs und FreeMinecraftModels vollständig geladen sind, und gibt ihnen dann bis zu 5 Minuten, um gerade importierte Inhalte neu zu laden. Fehlt eines davon, lässt es sich nicht laden oder lädt es nach dieser Zeit immer noch neu, protokolliert Extractioncraft ExtractionCraft initialization failed, und seine Befehle werden nicht registriert.

Was Extractioncraft erstellt

Beim Start initialisiert Extractioncraft diese Pfade:

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/ enthält bereits die fünf vorgefertigten Kobold-Mines-Konfigurationsdateien. loot_pools/ und loot_tables/ sind zunächst leer. Die Loot-Tabellen, auf die die vorgefertigten Pakete verweisen (kobold_mines_equipment_loot_table.yml und kobold_mines_supplies_loot_table.yml), werden mit dem herunterladbaren Content-Pack geliefert, nicht mit der Plugin-Jar.

Das Content-Pack enthält auch die Kartendaten, die in den Begleit-Plugins liegen: Modulgeneratoren, Module, Komponenten und Spawn-Pools gehen an BetterStructures, Bosse und Items an EliteMobs und Modelle an FreeMinecraftModels. Ein Paket gilt in /exc setup als heruntergeladen, wenn BetterStructures den Modulgenerator geladen hat, der im betterStructuresModulesContainerName des Pakets genannt ist.

Empfohlener Ersteinrichtungsablauf

1. Installiere Extractioncraft zusammen mit BetterStructures, EliteMobs, FreeMinecraftModels und WorldEdit (oder FastAsyncWorldEdit). Starte den Server einmal.
2. Führe /exc initialize aus, um das Ersteinrichtungsmenü zu öffnen. Seine Statusscheibe ist rot, wenn weder WorldEdit noch FastAsyncWorldEdit aktiviert ist, gelb, wenn kein Paket zugleich aktiviert ist und einen geladenen Modulgenerator hat, und grün, sobald ein Paket bereit ist. Klicke auf die Scheibe, um die nächsten Schritte zu sehen. Der Spielerkopf verlinkt auf die Extractioncraft-Seite auf nightbreak.io und den Discord.
3. Lade das Content-Pack von nightbreak.io herunter.
4. Lege die heruntergeladene ZIP-Datei in den Ordner plugins/Extractioncraft/imports/.
5. Führe /exc reload aus oder starte den Server neu. Der Importer entpackt die ZIP-Datei in die Ordner von Extractioncraft, BetterStructures, EliteMobs und FreeMinecraftModels. Danach lädt Extractioncraft BetterStructures neu, außerdem EliteMobs, wenn das Pack EliteMobs-Inhalte hinzugefügt hat, und wartet, bis die Begleit-Plugins vollständig geladen sind.
6. Führe /exc setup aus, um Inhaltspakete zu durchsuchen und zu verwalten. Jedes Paket zeigt einen farbigen Status (grün = installiert, gelb = heruntergeladen, aber nicht installiert, rot = nicht heruntergeladen). Ein Klick auf ein grünes Paket deaktiviert es, ein Klick auf ein gelbes aktiviert es, und ein Klick auf ein rotes gibt seinen Download-Link aus, zusammen mit der Anleitung, die Datei in den Importordner zu legen und /exc reload auszuführen. Das Setup-Menü enthält außerdem einen Eintrag Empfohlene Plugins und einen Info-Button (der Spielerkopf) mit Links zum Wiki, zum Discord, zu deiner Konto-Token-Seite, /extractioncraft recommendedplugins und /nightbreak plugins.

Inhaltspakete werden nicht im Spiel heruntergeladen; verwende den Download-Link und den Importordner.

Gemeinsame MagmaCore-Einrichtungsfunktionen

Da MagmaCore in Extractioncraft gebündelt ist, wird das Plugin mit den gemeinsamen Nightbreak-Einrichtungswerkzeugen ausgeliefert:

• Empfohlene Plugins — /exc recommendedplugins (oder der Eintrag innerhalb von /exc setup) listet die Begleit-Plugins auf, die gut mit Extractioncraft harmonieren, und zeigt an, welche bereits installiert sind.
• Konto-Token / lizenzierte Inhalte — /nightbreaklogin registriert das Token deines nightbreak.io-Kontos, damit der Server lizenzierte Inhalte im Spiel herunterladen kann.
• Plugin-Katalog — /nightbreak plugins öffnet einen durchsuchbaren Katalog der anderen Plugins von MagmaGuy.

Vorgefertigte Inhalte

Extractioncraft wird mit Konfigurationen für folgende vorgefertigte Inhaltspakete ausgeliefert (Kobold Mines-Reihe):

Paket	Konfigurationsdateiname	Level	Max. Spieler
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

Das Level ist das contentLevel des Pakets und wird für Behälter-Loot verwendet. Die Bosse in den Spawn-Pools des Content-Packs spawnen auf demselben Level. Jede Karte hat Zonen der Stufen Normal, Hard und Mythic, wobei die schwerste Zone in der Mitte liegt; siehe Mob-Kill-Loot.

Alle vorgefertigten Pakete nutzen BetterStructures, FreeMinecraftModels und EliteMobs. PvP ist standardmäßig aktiviert. Die Kartendaten müssen separat über den im Setup-Menü angezeigten Inhalts-Link heruntergeladen werden.

Ein Match starten

Sobald Inhalte installiert sind:

1. Führe /exc createMatch <contentPackage.yml> aus (z.B. /exc createMatch kobold_mines_10.yml). Das Argument vervollständigt per Tab jedes beim Start geladene Inhaltspaket. Der Befehl lehnt ein Paket ab, das deaktiviert ist oder dessen Modulgenerator fehlt, deaktiviert ist, kein Weltgenerator ist oder keine installierten Startmodule hat.
2. Das Plugin generiert die instanzierte Welt über BetterStructures und verwendet dabei den betterStructuresModulesContainerName des Pakets. Die Generierung erfolgt nicht sofort und zeigt eine Fortschritts-Bossleiste an; du wirst an einen zufälligen Spawn-Punkt in der neuen Welt teleportiert, sobald sie bereit ist. Die Generierung wird abgebrochen, wenn sie länger als 15 Minuten dauert, wenn du die Verbindung trennst oder /exc leave ausführst.
3. Extractioncraft registriert keinen Beitrittsbefehl, daher enthält das Match nur den Spieler, der es erstellt hat. Sobald minPlayers erfüllt ist (standardmäßig 1), kann jeder Spieler im Match /exc start ausführen.
4. Um ein Match jederzeit zu verlassen, führe /exc leave (oder /exc quit) aus. Verlassen nach dem Start des Matches zählt als fehlgeschlagene Extraktion; siehe Match-Ablauf.