CoreExtractionX

CoreExtractionX is a Paper-only survival enhancement plugin for Minecraft servers. It changes what happens when configured blocks are mined: a source block can be replaced in the world while its natural drops are preserved, or it can break normally while CoreExtractionX adds an extra configured item drop.

The idea is simple: block extraction should be server-controlled, predictable, and easy to configure without forcing a server to install a database, economy system, GUI, vein miner, auto miner, custom drop framework, or protection-plugin bridge.

This page is a commercial-style feature overview. Exact config keys, defaults, limits, and operational details are documented at https://icewolf23x.github.io/CoreExtractionX-website/

What CoreExtractionX Does

Adds YAML-driven extraction rules for configured source blocks.
Supports REPLACEMENT mode, where the mined block is replaced in the world.
Supports DROP mode, where the block breaks normally and CoreExtractionX adds an extra configured item drop.
Preserves the original block's natural drops in replacement mode.
Supports configurable fixed, random, matched-drop, and matched-quantity extra drop amounts.
Ships default rules for vanilla ores, deepslate ores, Nether ores, and Ancient Debris.
Lets admins add any valid block material as a dynamic rule.
Supports global and per-block permission checks.
Supports configurable Silk Touch behavior.
Supports world whitelist and blacklist filtering.
Supports configurable manual drop spawn locations.
Preserves vanilla XP in replacement mode when enabled.
Respects cancelled block break events for protection compatibility.
Includes reload commands through /coreextractionx reload and /cex reload.

How To Use

Install the jar on a Paper server, start the server, and let CoreExtractionX generate its default files.

CoreExtractionX creates three main configuration files:

config.yml for global runtime settings.
ores.yml for block extraction rules.
messages.yml for player-facing messages.

Server staff edit ores.yml to decide which blocks CoreExtractionX handles, which mode each block uses, and what replacement block or extra item should be used.

After normal YAML edits, run /coreextractionx reload or /cex reload.

Replacement Mode

REPLACEMENT mode is useful when a server wants a mined source block to turn into another block instead of disappearing.

For example, the default configuration can make:

normal stone ores become COBBLESTONE
deepslate ores become COBBLED_DEEPSLATE
Nether ores become NETHERRACK
Ancient Debris become BLACKSTONE

The source block's natural drops are calculated from the player's current tool and spawned manually, so normal Minecraft drop behavior stays familiar.

Drop Mode

DROP mode leaves vanilla block breaking intact and adds an extra configured item drop after the normal drops are generated.

Supported amount modes include:

FIXED for a set amount.
RANDOM for a random amount between configured limits.
MATCH_DROPS to match the initial generated drop quantity.
MATCH_QUANTITY to match the current item quantity when CoreExtractionX handles the drop event.

This is useful when a server wants extra configured rewards without replacing the source block in the world.

Permissions And Safety

CoreExtractionX can use one global permission or per-block permission overrides.

When a player does not have permission, the plugin can either:

let vanilla mining continue
cancel the block break

Silk Touch can also be handled globally or per block. By default, Silk Touch uses vanilla behavior and CoreExtractionX does nothing.

CoreExtractionX ignores cancelled block break events. If a region, claim, or protection plugin cancels a break first, CoreExtractionX does not modify the block, drops, XP, or tool durability.

Current State

CoreExtractionX currently:

supports Paper 1.21.11 and above
requires Java 21 or newer
works as a standalone Paper plugin
generates config.yml, ores.yml, and messages.yml
does not require Vault
does not require PlaceholderAPI
does not require a database
does not require an economy plugin
does not require a custom GUI
does not require a resource pack
does not require a protection-plugin dependency
does not add vein mining or auto mining

Summary

CoreExtractionX is built for servers that want mining behavior to be configurable without turning mining into a large progression or automation system.

It is a focused extraction layer for Paper servers: choose the blocks, choose the mode, reload the YAML, and keep the rest of the server's mining behavior vanilla-friendly.