EasyCopper
一个适用于 Paper 26.3 的插件,允许玩家通过右键点击铜块使用剑来加速其氧化进程。
在原版 Minecraft 中,氧化只能通过斧头逆转。此插件添加了相反的过程,使铜能够按以下阶段进展:普通铜 → 暴露铜 → 风化铜 → 氧化铜。
功能特性
- 使用任何剑右键点击铜块即可使其进入下一个氧化阶段。
- 支持所有可氧化的铜块:
- 铜块、切制铜块、切制铜楼梯和切制铜台阶
- 雕纹铜块
- 铜门、活板门、格栅、信号灯、铁栏杆、铜链和灯笼
- 铜箱子(保留内容和自定义名称)
- 铜傀儡雕像
- 保留方块朝向、开启状态、被水浸没状态、红石属性及其他所有方块属性。
- 门的两半部分和双箱子的两侧会同时转换。
- 氧化进度更新时播放刮擦音效并显示粒子效果。
- 铜块氧化升级时显示第一人称手臂摆动动画。
- 所有玩家均可使用该插件:无需任何权限。
依赖要求
- Paper 26.3(或更高版本)
- Java 25(Paper 26.3 所必需)
服务器安装
仅需一个文件:
plugins/EasyCopper-1.0.0.jar
编译后的 JAR 包位于:
target/EasyCopper-1.0.0.jar
安装步骤:
- 将
EasyCopper-1.0.0.jar 复制到服务器的 plugins/ 文件夹中。
- 重启服务器(或使用
/reload confirm,但推荐重启)。
- 首次启动时,插件会自动创建
plugins/EasyCopper/config.yml。
你不需要复制 pom.xml、src/ 或其他任何文件夹:服务器上只需要 JAR 文件。
配置说明
plugins/EasyCopper/config.yml 文件会自动生成。主要设置如下:
| 选项 |
默认值 |
描述 |
cooldown-ms |
150 |
同一玩家两次使用之间的最小间隔(毫秒) |
allow-waxed |
false |
如果为 true,涂蜡的方块也可以继续氧化 |
require-sneak |
false |
如果为 true,玩家必须处于潜行状态 |
arm-swing |
true |
铜块氧化升级时显示手臂摆动动画 |
status-messages |
true |
对已完全氧化或已涂蜡的铜块显示操作栏消息 |
sounds.enabled |
true |
氧化进度更新时播放音效 |
particles.enabled |
true |
氧化进度更新时显示粒子效果 |
修改配置后,请运行:
/easycopper reload
命令与权限
| 命令 |
权限节点 |
描述 |
/easycopper reload |
easycopper.reload(默认:op) |
重新加载配置文件 |
使用该插件不需要任何权限:该功能对所有玩家开放。
从源码构建
mvn clean package
JAR 文件将生成于:
target/EasyCopper-1.0.0.jar
注意事项
- 涂蜡方块(
WAXED_...)默认不会继续氧化,这与原版一致:蜡可以防止氧化。如果你希望绕过此行为,请设置 allow-waxed: true。
- 铜矿石和粗铜块无法氧化,将被忽略。
- 已经完全氧化的方块不会发生变化。你可以设置
status-messages: true 以向玩家显示相关提示消息。
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:
- Copy
EasyCopper-1.0.0.jar into your server's plugins/ folder.
- Restart the server (or use
/reload confirm, although a restart is recommended).
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧