Extractioncraft Setup

Requirements

• Java 21
• A Paper/Spigot-compatible server on the 1.21 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/

Recommended First-Time Flow

1. Install Extractioncraft along with BetterStructures, EliteMobs, and FreeMinecraftModels. Start the server once.
2. Run /exc initialize to open the first-time setup menu. This walks through dependency checks and content status.
3. Download content packages from nightbreak.io.
4. Place downloaded content into the plugins/Extractioncraft/imports/ folder.
5. Run /exc reload or restart the server.
6. Run /exc setup to browse and manage installed content packages.

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).
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 can run /exc start.
4. To leave a match at any time, run /exc leave.