Extractioncraft Setup

Requirements

• Java 21
• A Paper/Spigot-compatible server on the 1.21.4 API line
• BetterStructures (soft-depend, required for premade content)
• EliteMobs (soft-depend, required for premade content)
• FreeMinecraftModels (soft-depend, required for premade content)

What Extractioncraft Creates

On startup, Extractioncraft initializes these paths:

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/

The schematics/ folder holds the actual BetterStructures map data for each installed content package, under a subfolder named after the package's folderName (e.g. schematics/kobold_mines_10/).

Recommended First-Time Flow

1. Install Extractioncraft along with BetterStructures, EliteMobs, FreeMinecraftModels, and WorldEdit (or FastAsyncWorldEdit). Start the server once.
2. Run /exc initialize to open the first-time setup menu. It checks that WorldEdit is installed and that at least one BetterStructures schematic configuration is available, then offers a "Complete first-time setup" button.
3. Download content packages from nightbreak.io.
4. Place downloaded content into the plugins/Extractioncraft/imports/ folder. The plugin will extract supported archives on the next startup.
5. Run /exc reload or restart the server.
6. Run /exc setup to browse and manage installed content packages. Each package shows a colored status (green = installed, yellow = downloaded but not installed, red = not downloaded) and a click action. The setup menu also includes a Recommended Plugins entry and an info button (the player skull) with links to the wiki, the Discord, your account token page, and the update commands.

MagmaCore Shared Setup Features

Because MagmaCore is bundled into Extractioncraft, the plugin ships with the shared Nightbreak setup tooling:

• Recommended plugins — /exc recommendedplugins (or the entry inside /exc setup) lists the companion plugins that pair well with Extractioncraft and shows which are already installed.
• Account token / licensed content — /nightbreaklogin registers your nightbreak.io account token so the server can download licensed content in-game.
• Plugin catalog — /nightbreak plugins opens a browsable catalog of MagmaGuy's other plugins.

Premade Content

Extractioncraft ships with configuration for the following premade content packages (Kobold Mines series):

Package	Config filename	EliteMobs level range	Max players
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

All premade packages use BetterStructures, FreeMinecraftModels, and EliteMobs. PvP is enabled by default. The map data must be downloaded separately from the content links shown in the setup menu.

Starting a Match

Once content is installed:

1. Run /exc createMatch <contentPackage.yml> (e.g. /exc createMatch kobold_mines_10.yml). The argument tab-completes the available content package filenames.
2. The plugin generates the instanced world asynchronously via BetterStructures. You are teleported in once it is ready.
3. Other players can join. When the minimum player count is met, any player in the match can run /exc start.
4. To leave a match at any time, run /exc leave (or /exc quit).