CompressCoreRK

About CompressCoreRK

CompressCoreRK was originally developed specifically for my own FullPvP server and its resource-based economy.

After testing and using it on my server, I decided to share it with the community for other server owners who may need an efficient, configurable and tier-based automatic compression system.

Although it was designed primarily for FullPvP, the plugin is not restricted to that game mode. Its chains, tiers, conversion amounts and currencies can be adapted to many different types of Minecraft servers.

The included default conversions represent the requirements of my server, but administrators can customize them through the configuration files.

Designed for FullPvP — Usable Everywhere

CompressCoreRK is especially useful for servers where players collect large quantities of resources and need to convert them into blocks or custom currencies automatically.

It can also be used in:

• FullPvP servers
• BoxPvP servers
• Prison servers
• Survival servers
• SkyBlock servers
• Grinding-based servers
• Custom economy servers

• Three default compressor tiers: T1, T2 and T3
• Higher tiers inherit every conversion from previous tiers
• Event-driven inventory processing
• Debounce and batch processing
• No global periodic player scan
• Multi-stage and cascading conversions
• Direct conversion of configured intermediate blocks
• ItemEdit ServerItem currency integration
• Original ItemEdit templates are cloned and preserved
• Generated currencies stack with original ItemEdit currencies
• Protected inventory baseline
• Deterministic compressor priority and tier resolution
• Main-hand, off-hand and inventory right-click toggling
• PDC-secured compressor identification
• Safe inventory simulation before every transaction
• Configurable chains and compressor definitions
• Validation, doctor and player debug commands
• Automatic configuration migration with timestamped backups
• Fortune-compatible Minecraft drops

T1 — Resource Compressor

T1 processes the normal resource chains:

Example:

T2 — Advanced Compressor

T2 includes everything from T1 and adds:

T3 — Elite Compressor

T3 includes everything from T1 and T2 and adds:

If a player has multiple compressors, only the compressor with the highest effective priority and tier is used.

Multiple compression engines are never executed simultaneously for the same player.



Gold

Iron

Emerald

Copper

Diamond

Netherite

Direct block conversions

Intermediate inputs also work independently.

For example, a GOLD_BLOCK obtained directly can be converted even if it was not previously created from RAW_GOLD.



CompressCoreRK does not manually recreate currency items.

Every server owner can design their own currencies using ItemEdit.

CompressCoreRK retrieves and clones the original ServerItem templates, preserving their name, lore, glow, components and exact ItemEdit identity.

Required ItemEdit IDs

Creating your currencies

First, hold the item you want to use as a currency in your main hand.

Customize its name:

Optionally add a description or additional lore:

Save the item as a global ItemEdit ServerItem:

Repeat the process for the other currencies:

You can use any material, custom name, lore, glow or modern item component supported by ItemEdit.

CompressCoreRK clones the original ItemEdit template. Generated currencies remain compatible and stack with the original currencies from your server.

• Paper 1.21.x
• Java 21
• ItemEdit
• ItemEdit ServerItem IDs 1, 2 and 3 configured

Optional dependency: AutoPickup

AutoPickup is optional.

If you use AutoPickup, its AutoSmelt feature must remain disabled for chains that use RAW_GOLD, RAW_IRON and RAW_COPPER.

Important: If AutoSmelt is enabled, AutoPickup may convert RAW resources into ingots before CompressCoreRK processes them.

1. Stop your server.
2. Install ItemEdit.
3. Place CompressCoreRK-1.0.0.jar inside the plugins folder.
4. Start the server.
5. Create ItemEdit ServerItems with IDs 1, 2 and 3.
6. Run the validation command.
7. Run the doctor command.

When updating, do not delete your existing CompressCoreRK YAML files.

Supported configuration migrations create timestamped backup files automatically.

Do not install two different CompressCoreRK JAR versions simultaneously.



Command overview

• /compressor status — Shows the global state and effective compressor.
• /compressor list — Lists available compressor definitions.
• /compressor info <id> — Shows information about a compressor.
• /compressor give <player> <id> [amount] — Gives a secured compressor item.
• /compressor validate — Validates the loaded configuration.
• /compressor doctor — Shows server, ItemEdit and internal status.
• /compressor debug [player] — Shows totals, baseline, eligibility and the latest transaction.
• /compressor reload — Reloads valid configuration safely.
• /compressor version — Shows the installed version.

CompressCoreRK uses an event-driven processing flow:

Multiple resources are calculated in batches.

For example:

The plugin does not need to execute ten independent conversions when the same result can be calculated safely in one batch.

• COMMAND outputs are disabled by default and cannot be rolled back.
• ItemEdit currencies are never reconstructed manually.
• Silk Touch follows normal Minecraft loot behavior.
• Fortune uses Minecraft and Paper's normal drop calculation.
• CompressCoreRK does not force one resource per mined block.
• Only eligible quantities are processed according to the protected baseline.
• Moving, splitting or combining stacks does not make protected items eligible.
• If an output cannot be created or inserted safely, the input is not consumed.
• Only one effective compressor is used per player.

• config.yml — General processing, performance and hook settings
• compressors.yml — Tiers, priorities, items and inherited chains
• chains.yml — Inputs, conversion amounts and outputs
• currencies.yml — ItemEdit currency mappings
• messages.yml — Plugin messages
• storage.yml — Storage-related settings

After changing the configuration, use:



When reporting a problem, include the output of:

Also include:

• Paper version
• Java version
• ItemEdit version
• AutoPickup version, if installed
• Relevant server console log
• Steps required to reproduce the problem