Extractioncraft Einrichtung

Voraussetzungen

• Java 21
• Ein Paper/Spigot-kompatibler Server auf der 1.21.4 API-Linie
• BetterStructures (Soft-Dependency, erforderlich für vorgefertigte Inhalte)
• EliteMobs (Soft-Dependency, erforderlich für vorgefertigte Inhalte)
• FreeMinecraftModels (Soft-Dependency, erforderlich für vorgefertigte Inhalte)

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/ ist mit den fünf vorgefertigten Kobold-Mines-Konfigurationsdateien vorbefüllt. loot_pools/ und loot_tables/ sind zunächst leer — die Loot-Tabellen, auf die die vorgefertigten Pakete verweisen (kobold_mines_chest_high_loot_table_10.yml und Konsorten), kommen mit dem herunterladbaren Content-Pack, nicht mit der Plugin-Jar.

Der Ordner schematics/ wird beim Start nicht angelegt. Er entsteht, sobald Inhalte installiert sind, und enthält die Kartendaten für jedes Inhaltspaket in einem nach dem folderName des Pakets benannten Unterordner (z.B. schematics/kobold_mines_10/). Extractioncraft nutzt das Vorhandensein dieses Unterordners, um in /exc setup zu entscheiden, ob ein Paket als heruntergeladen gilt.

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. Es prüft, ob WorldEdit (oder FastAsyncWorldEdit) installiert ist und ob mindestens eine BetterStructures-Schematic-Konfiguration verfügbar ist, und bietet dann einen Button "Ersteinrichtung abschließen" an. Da die Karten BetterStructures-Inhalte sind, verweisen die Hilfe-Links dieses Menüs auf die BetterStructures-Einrichtungsseite und den gemeinsamen Discord.
3. Lade Inhaltspakete von nightbreak.io herunter.
4. Lege heruntergeladene Inhalte in den Ordner plugins/Extractioncraft/imports/. Das Plugin entpackt unterstützte Archive beim nächsten Start.
5. Führe /exc reload aus oder starte den Server neu.
6. Führe /exc setup aus, um installierte Inhaltspakete zu durchsuchen und zu verwalten. Jedes Paket zeigt einen farbigen Status (grün = installiert, gelb = heruntergeladen, aber nicht installiert, rot = nicht heruntergeladen) und eine Klick-Aktion. 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 und zu den Update-Befehlen.

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	EliteMobs-Levelbereich	Max. Spieler
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

Alle vorgefertigten Pakete nutzen BetterStructures, FreeMinecraftModels und EliteMobs. PvP ist standardmäßig aktiviert. Die Kartendaten müssen separat über die im Setup-Menü angezeigten Inhalts-Links 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 die verfügbaren Inhaltspaket-Dateinamen per Tab — auch Pakete, die derzeit als nicht installiert markiert sind. Eine falsche Wahl scheitert daher erst bei der Weltgenerierung und nicht schon beim Befehl.
2. Das Plugin generiert die instanzierte Welt asynchron über BetterStructures und verwendet dabei den betterStructuresModulesContainerName des Pakets. Die Generierung erfolgt nicht sofort; du wirst an einen zufälligen Spawn-Punkt in der neuen Welt teleportiert, sobald sie bereit ist.
3. Der aktuelle Build registriert keinen Beitrittsbefehl, daher enthält das Match nur den Spieler, der es erstellt hat — der maxPlayers-Wert des Pakets (8 bei allen vorgefertigten Paketen) wird von der gemeinsamen Match-Laufzeit zwar gelesen, kann aber von nichts erreicht werden. 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. Wer ein laufendes Match ohne Extraktion verlässt, vernichtet standardmäßig sein Inventar — siehe Match-Ablauf.