Skip to main content

Extractioncraft

Extractioncraft is a competitive extraction-style game mode plugin for Minecraft servers. Players enter procedurally generated instanced maps, loot containers, fight elite mobs, and race to reach extraction points before the world border closes in.

Start Here​

Current Platform Notes​

  • Plugin version in the current repo: 1.0-SNAPSHOT
  • API version: 1.21.4
  • Root command: /extractioncraft (alias /exc)

How a Match Works​

  1. A player creates a match with /exc createMatch <contentPackage.yml>, which generates an instanced world asynchronously using BetterStructures modular world generation. The creator is teleported into a random spawn location once the world is ready.
  2. The content package defines a minimum and maximum player count, but the current build registers no join command — /exc createMatch is the only way into a match, so in practice a match holds only its creator.
  3. Once minPlayers is met (1 by default), any player in the match can run /exc start. A short 3-second countdown plays before the match goes live.
  4. On start, chests and barrels spawn throughout the map. Containers emit portal particles every 10 ticks so they're easy to spot. Players loot containers (standing still for 3 seconds to open them) and fight EliteMobs enemies for loot drops. A sidebar scoreboard counts down a 15-minute timer.
  5. After 1 minute, the usable version of each extraction point is pasted in. A boss-bar compass shows a marker for every extraction point in front of the player.
  6. Pulling the lever at an extraction point consumes it and opens a single shared 20-second extraction window. Everyone standing inside that point's extraction zone when the window closes extracts together.
  7. A world border steadily shrinks from 740 blocks across to nothing over roughly 15 minutes, forcing players toward the center.
  8. Players who extract keep their loot (items are soulbound on exit via the EliteMobs soulbind enchantment). Everybody else — players who leave, disconnect, or take lethal damage — loses their whole inventory when deleteItemsOnFailToExtract is true (the default).

Full details on timers, extraction rules, deaths and world protections are on the match flow page.

Dependencies​

  • Soft-depends (effectively required for premade content): BetterStructures, EliteMobs, FreeMinecraftModels
  • Framework: MagmaCore (bundled)

The plugin will load without the soft-depends, but the premade Kobold Mines content packages cannot run without all three.