EasyCopper

EasyCopper

A plugin for Paper 26.3 that allows players to advance the oxidation of copper blocks by right-clicking a block with a sword.

In vanilla Minecraft, oxidation can only be reversed using an axe. This plugin adds the opposite process, allowing copper to progress through the following stages: normal copper → exposed copper → weathered copper → oxidized copper.

Features

• Right-click a copper block with any sword to advance it to the next oxidation stage.
• Supports all oxidizable copper blocks:
• Copper Block, Cut Copper, Cut Copper Stairs and Slabs
• Chiseled Copper
• Copper Door, Trapdoor, Grate, Bulb, Bars, Chain and Lantern
• Copper Chest (contents and custom name are preserved)
• Copper Golem Statue
• Preserves block orientation, open state, waterlogged state, redstone properties and all other block properties.
• Doors are converted on both halves, and double chests are converted on both sides.
• Plays a scraping sound and displays particles when oxidation advances.
• Shows the first-person arm-swing animation when copper advances.
• All players can use the plugin: no permission is required.

Requirements

• Paper 26.3 (or later)
• Java 25 (required by Paper 26.3)

Server installation

Only one file is required:

plugins/EasyCopper-1.0.0.jar

The compiled JAR is located at:

target/EasyCopper-1.0.0.jar

Installation steps:

1. Copy EasyCopper-1.0.0.jar into your server's plugins/ folder.
2. Restart the server (or use /reload confirm, although a restart is recommended).
3. On first startup, the plugin automatically creates plugins/EasyCopper/config.yml.

You do not need to copy pom.xml, src/ or any other folders: only the JAR file is needed on the server.

Configuration

The plugins/EasyCopper/config.yml file is created automatically. Main settings:

Option · Default · Description
cooldown-ms · 150 · Minimum delay between two uses by the same player
allow-waxed · false · If true, waxed blocks can also advance through oxidation
require-sneak · false · If true, players must be sneaking
arm-swing · true · Shows the arm-swing animation when copper advances
status-messages · true · Displays action-bar messages for already oxidized or waxed copper
sounds.enabled · true · Plays a sound when oxidation advances
particles.enabled · true · Displays particles when oxidation advances

After changing the configuration, run:

/easycopper reload

Commands and permissions

Command · Permission · Description
/easycopper reload · easycopper.reload (default: op) · Reloads the configuration

Using the plugin does not require any permissions: the feature is available to every player.

Building from source

mvn clean package

The JAR file will be created at:

target/EasyCopper-1.0.0.jar

Notes

• Waxed blocks (WAXED_...) do not advance by default, just as in vanilla: wax prevents oxidation. Set allow-waxed: true if you want to bypass this behavior.
• Copper ores and raw copper blocks cannot oxidize and are ignored.
• Blocks that are already fully oxidized do not change. You can display a message for them by setting status-messages: true.