Configured mining behavior, clean vanilla drops

Block extraction rules for Paper servers.

CoreExtractionX changes what happens when configured blocks are mined: replace the source block while preserving natural drops, or let the block break normally and add an extra configured item drop.

Get Started Explore Features
  • Paper 1.21.11+
  • Java 21
  • 3 YAML files
  • No database
Extraction Rule Preview
diamond_ore REPLACEMENT
Source

Player mines a configured ore in survival with a normal tool.

Replace

The source block becomes the configured block, such as cobblestone.

Drops

CoreExtractionX spawns the natural drops from the original block once.

Replacement block becomes base material
Extra Drop DROP mode addon item
Safe respects cancelled breaks
Ore
Rule
Drops
YAML Rules ores.yml source to target
2rule modes
19default source blocks
YAMLper-block control
Papersurvival-only runtime

Core feature set

Small mining behavior changes with predictable server rules.

CoreExtractionX is built for owners who want configurable extraction behavior without turning mining into a custom progression, economy, GUI, or database system.

REPLACEMENT Mode

Replace the mined block in the world while manually spawning the source block's natural drops and preserving XP.

DROP Mode

Let the block break normally, then add an extra configured replacement item after vanilla drops are generated.

Dynamic Rules

Admins can add any valid block material under blocks: instead of editing hardcoded ore lists.

Protection Friendly

CoreExtractionX respects cancelled BlockBreakEvents and does not require protection-plugin dependencies.

Why CoreExtractionX

Configurable extraction without custom mining systems.

The plugin stays narrow: it changes configured block behavior, leaves unrelated mining vanilla, and avoids progression state, databases, economy hooks, GUIs, sounds, particles, and vein mining.

01

Natural Drops Stay Natural

Replacement mode calculates drops once with the player's current tool and lets Paper handle Fortune through the block loot table.

02

Rules Stay in YAML

config.yml, ores.yml, and messages.yml split global behavior, block rules, and player-facing text.

03

No Hard Dependency Stack

Protection compatibility comes from respecting cancelled events. No WorldGuard or GriefPrevention dependency is required.

Setup and compatibility

Built for modern Paper survival servers.

Install the jar on Paper, let the three YAML files generate, then tune global behavior and block rules.

Runtime

Paper 1.21.11+ and Java 21

CoreExtractionX is a Paper backend plugin. It does not ship proxy, web, database, or economy modules.

  • Survival-only runtime
  • Cancelled break protection
  • Java 21 build target
Files

Three focused YAML files

Global settings, per-block extraction rules, and text are separated so normal edits stay easy to review.

  • config.yml
  • ores.yml
  • messages.yml
Paper only Java 21 YAML driven No database

Resources

Docs for setup, config, and production checks.

Hub

Documentation Hub

Start from setup, feature overview, configuration reference, FAQ, and operational checks.

 Product

Product Overview

Detailed behavior for replacement mode, drop mode, permissions, Silk Touch, and scope.

 Setup

Installation Guide

Requirements, first boot, generated files, reload boundaries, and first validation tests.

 Config

Configuration Reference

YAML file map, rule examples, permissions, troubleshooting, and production checklist.

 FAQ

Complete FAQ

Short answers for Paper requirements, drops, Silk Touch, permissions, and reload behavior.

FAQ preview

Short answers before editing rules.

Does it replace every ore automatically?

The default ores.yml includes vanilla ores and Ancient Debris. Admins can add or disable rules per block.

Does Silk Touch trigger extraction?

By default, Silk Touch uses VANILLA behavior and CoreExtractionX does nothing. It can be changed to DENY.

Does it need WorldGuard?

No. It respects cancelled block break events and does not hard-depend on protection plugins.

Can DROP mode match vanilla drop quantity?

Yes. MATCH_DROPS captures the generated drop quantity at the start of BlockDropItemEvent.

Also try

More CoreX plugins for the same server stack.

Each project stays focused, so you can add only the systems your Paper server actually needs.

Armor

CoreArmorX

Vanilla+ armor upgrade paths, netherite skins, metadata-safe conversions, and YAML control.

Open site
Tools

CoreToolsX

Vanilla+ tool upgrade paths, material skins, protected crafting, and admin-controlled recipes.

Open site
Cases

CoreCaseX

Structured player reports, staff triage, evidence, replies, notes, and resolution workflows.

Open site
Chat

CoreChatX

Channels, private messages, pings, ChatItems, moderation, bridges, locales, and Velocity support.

Open site

Ready to test extraction rules?

Install CoreExtractionX, generate defaults, and mine through the configured blocks.

Start with the setup guide, then tune global behavior, block rules, and messages from YAML.

Open Installation Guide Open Configuration Reference