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.