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. Other players join the match lobby. The content package defines the minimum and maximum player count.
  3. Once enough players have joined, 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, extraction points (levers on small platforms) appear on the map. A boss-bar compass shows markers along it that point toward each visible exit.
  6. Players pull a lever at an extraction point, then stand on the 3-block platform for 20 seconds to extract successfully.
  7. A world border steadily shrinks from 740 blocks across to nothing over 15 minutes, forcing players toward the center.
  8. Players who extract keep their loot (items are soulbound on exit via the EliteMobs soulbind enchantment). Players who fail to extract lose all inventory items when deleteItemsOnFailToExtract is true (the default).

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.