CopperPlus - 高级铜氧化插件
? 概述
CopperPlus 是一款针对 Minecraft 1.21+ 的品质生活(QoL)插件,彻底革新了铜氧化机制。将缓慢的自然氧化过程转变为快速、可控的系统,利用营火和水来实现——非常适合需要快速获取氧化铜的建筑师和红石工程师!
✨ 主要特性
⚡ 加速氧化系统
- 快速氧化:在点燃的营火上方放置铜块,并在附近放置水,以大幅加快氧化速度
- 智能检测:自动检测有效设置并开始氧化过程
- 水速倍增器:水方块越多 = 氧化越快(每个水方块的加成可配置)
- 视觉反馈:氧化过程中显示粒子效果和声音通知
- 进度追踪:实时显示氧化进度信息
? 多语言支持(11种语言!)
- English (en_US) - 默认
- Chinese Simplified (zh_CN) - 简体中文
- Spanish (es_ES) - Español
- Hindi (hi_IN) - हिन्दी
- Arabic (ar_SA) - العربية
- Portuguese (pt_BR) - Português
- Russian (ru_RU) - Русский
- Japanese (ja_JP) - 日本語
- German (de_DE) - Deutsch
- French (fr_FR) - Français
- Korean (ko_KR) - 한국어
?️ 其他特性
- 新手包:包含营火、铜块、水桶和打火石的一键启动套件
- 发射器支持:发射器可以放置自动开始氧化的铜块
- 消息开关:玩家可以启用/禁用氧化通知
- 智能区块管理:高效的区块处理,支持每区块最大数量配置
- 完全可配置:所有功能都有广泛的配置选项
? 命令
所有命令均使用主 /copperplus 命令(别名:/cp, /copper+):
| 命令 |
描述 |
权限 |
/copperplus help |
显示所有可用命令 |
copperplus.use |
/copperplus kit |
获取铜氧化新手包 |
copperplus.kit |
/copperplus language |
查看当前语言 |
copperplus.use |
/copperplus language set <code> |
更改你的语言 |
copperplus.use |
/copperplus language list |
列出所有可用语言 |
copperplus.use |
/copperplus language admin <code> |
设置服务器默认语言 |
copperplus.admin |
/copperplus togglemsg |
开启/关闭氧化消息 |
copperplus.use |
/copperplus reload |
重新加载插件配置 |
copperplus.admin |
? 工作原理
基本设置
- 放置一个营火(普通营火或灵魂营火)
- 在营火正上方放置一个铜块
- 在附近放置水方块(1格半径内)
- 营火必须处于点燃状态才能发生氧化
- 看着你的铜块在几秒钟内完成氧化,而不是几小时!
氧化速度公式
- 基础速度:可配置的持续时间(默认:完全氧化需 60 秒)
- 水加成:每个水方块增加一个速度乘数
- 最大值:最多 26 个水方块会影响氧化速度
- 公式:
Speed = 1.0 + (water_blocks × water_speed_bonus)
氧化阶段
该插件支持所有原版铜氧化阶段:
- 铜块 → 斑驳的铜
- 斑驳的铜 → 风化的铜
- 风化的铜 → 氧化的铜
适用于所有铜变体:铜块、台阶、切石台阶和切制铜!
⚙️ 配置
关键配置选项
general:
enabled: true # 启用/禁用插件
debug: false # 调试模式用于故障排除
oxidation:
duration-seconds: 60 # 单个氧化阶段的基础时间
water-speed-bonus: 0.25 # 每个水方块的速度乘数
max-water-blocks: 26 # 计算的最大水方块数
require-lit-campfire: true # 营火必须处于点燃状态
water-check-radius: 1 # 检查水的半径
effects:
particles: true # 启用粒子效果
particle-type: "WAX_ON" # 使用的粒子类型
sounds: true # 启用声音效果
performance:
check-interval: 20 # 氧化检查之间的刻数
max-per-chunk: 50 # 每区块最大氧化方块数
kit:
items:
campfire: 4 # 新手包中的营火数量
copper-block: 64 # 铜块数量
water-bucket: 2 # 水桶数量
flint-and-steel: 1 # 用于点燃的打火石
? 权限
| 权限 |
描述 |
默认值 |
copperplus.use |
访问基本命令 |
所有玩家 |
copperplus.kit |
使用 /copperplus kit 命令 |
所有玩家 |
copperplus.admin |
管理员命令(重载、设置默认语言) |
操作员 |
? 安装
-
要求:
- Paper 服务器 1.21 或更高版本
- Java 21 或更高版本
-
安装步骤:
- 从发行版下载最新的
copper-plus-1.0.jar
- 将 JAR 文件放入服务器的
plugins 文件夹中
- 重启服务器
- 在
plugins/CopperPlus/config.yml 中配置设置
- (可选)在
plugins/CopperPlus/languages/ 中自定义语言文件
? 使用场景
对于建筑师
- 无需等待数小时即可快速获取氧化铜用于建造
- 使用不同的氧化阶段创建渐变效果
- 批量生产风化铜用于屋顶和装饰
对于红石工程师
- 快速测试铜灯泡的氧化状态
- 创建可控的氧化农场
- 实验不同的氧化模式
面向服务器管理员
- 为玩家提供生活便利功能
- 相比加速刻(tick acceleration)方案,显著降低服务器负载
- 完全掌控氧化速度与机制
? 独特功能
为何选择 CopperPlus?
- 真实机制:利用营火热量与水(如同真实的氧化化学原理!)
- 性能优化:采用高效的区块级处理机制
- 全面集成:兼容发射器、所有铜类型及原版机制
- 玩家自主:可选通知功能,支持按玩家设置语言偏好
- 管理员友好:提供丰富的配置选项,并支持无需重启服务器的重载操作
? 更新路线图
计划中的功能
- 自定义氧化图案与模板
- 涂蜡自动化系统
- 结合闪电的氧化逆转功能
- 用于语言与设置管理的图形用户界面(GUI)
- PlaceholderAPI 支持
- 通过经济系统集成进行套件购买
- 为氧化变体添加自定义合成配方
? 性能表现
- 轻量级:智能检查间隔带来极低的服务器影响
- 可扩展:可配置的阈值限制有效防止性能问题
- 高效:仅处理处于活动状态的氧化装置
- 整洁:区块卸载时自动清理数据
? 故障排除
常见问题
氧化未启动:
- 确保营火已点燃(而非仅放置)
- 检查水是否在 1 格半径范围内
- 验证铜块是否直接位于营火上方
- 确认插件已在配置中启用
消息未显示:
- 检查是否已通过
/copperplus togglemsg 关闭了消息提示
- 验证您的语言文件是否存在且格式正确
- 确保您距离正在氧化的铜块在 16 格以内
性能问题:
- 在配置文件中减少
max-per-chunk(每区块最大数量)的值
- 增加
check-interval(检查间隔)以降低更新频率
- 启用
clear-on-unload(卸载时清除)以改善内存管理
? 支持
- Bug 报告:在我们的 GitHub 仓库中创建 Issue
- 功能请求:通过 GitHub Discussions 提出建议
- Discord:加入我们的社区服务器获取实时支持
- Wiki:详细的文档可在 GitHub Wiki 上查阅
? 许可证
本插件按“原样”提供,仅供 Minecraft 服务器使用。未经作者许可,不得重新分发或修改。
?? 作者
Timiliris_420 - 首席开发者
? 鸣谢
- Paper 团队提供的优秀 API
- Minecraft 社区带来的灵感
- 所有贡献者与测试人员
CopperPlus - 让铜的氧化既有趣又快速! ?⚡
CopperPlus - Advanced Copper Oxidation Plugin
? Overview
CopperPlus is a quality-of-life plugin for Minecraft 1.21+ that revolutionizes copper oxidation mechanics. Transform the slow, natural oxidation process into a rapid, controlled system using campfires and water - perfect for builders and redstone engineers who need oxidized copper quickly!
✨ Key Features
⚡ Accelerated Oxidation System
- Rapid Oxidation: Place copper blocks above lit campfires with water nearby to speed up oxidation dramatically
- Smart Detection: Automatically detects valid setups and begins the oxidation process
- Water Speed Multiplier: More water blocks = faster oxidation (configurable bonus per water block)
- Visual Feedback: Particle effects and sound notifications during oxidation
- Progress Tracking: Real-time oxidation progress messages
? Multi-Language Support (11 Languages!)
- English (en_US) - Default
- Chinese Simplified (zh_CN) - 简体中文
- Spanish (es_ES) - Español
- Hindi (hi_IN) - हिन्दी
- Arabic (ar_SA) - العربية
- Portuguese (pt_BR) - Português
- Russian (ru_RU) - Русский
- Japanese (ja_JP) - 日本語
- German (de_DE) - Deutsch
- French (fr_FR) - Français
- Korean (ko_KR) - 한국어
?️ Additional Features
- Starter Kit: Quick-start kit with campfire, copper blocks, water bucket, and flint & steel
- Dispenser Support: Dispensers can place copper blocks that automatically start oxidizing
- Message Toggle: Players can enable/disable oxidation notifications
- Smart Chunk Management: Efficient processing with configurable limits per chunk
- Fully Configurable: Extensive configuration options for all features
? Commands
All commands use the main /copperplus command (aliases: /cp, /copper+):
| Command |
Description |
Permission |
/copperplus help |
Show all available commands |
copperplus.use |
/copperplus kit |
Get the copper oxidation starter kit |
copperplus.kit |
/copperplus language |
View your current language |
copperplus.use |
/copperplus language set <code> |
Change your language |
copperplus.use |
/copperplus language list |
List all available languages |
copperplus.use |
/copperplus language admin <code> |
Set server default language |
copperplus.admin |
/copperplus togglemsg |
Toggle oxidation messages on/off |
copperplus.use |
/copperplus reload |
Reload plugin configuration |
copperplus.admin |
? How It Works
Basic Setup
- Place a Campfire (regular or soul campfire)
- Place a Copper Block directly above the campfire
- Place Water blocks nearby (within 1 block radius)
- The campfire must be lit for oxidation to occur
- Watch as your copper oxidizes in seconds instead of hours!
Oxidation Speed Formula
- Base Speed: Configurable duration (default: 60 seconds for full oxidation)
- Water Bonus: Each water block adds a speed multiplier
- Maximum: Up to 26 water blocks can affect oxidation speed
- Formula:
Speed = 1.0 + (water_blocks × water_speed_bonus)
Oxidation Stages
The plugin supports all vanilla copper oxidation stages:
- Copper Block → Exposed Copper
- Exposed Copper → Weathered Copper
- Weathered Copper → Oxidized Copper
Works with all copper variants: blocks, stairs, slabs, and cut copper!
⚙️ Configuration
Key Configuration Options
general:
enabled: true # Enable/disable the plugin
debug: false # Debug mode for troubleshooting
oxidation:
duration-seconds: 60 # Base time for one oxidation stage
water-speed-bonus: 0.25 # Speed multiplier per water block
max-water-blocks: 26 # Maximum water blocks counted
require-lit-campfire: true # Campfire must be lit
water-check-radius: 1 # Radius to check for water
effects:
particles: true # Enable particle effects
particle-type: "WAX_ON" # Particle type to use
sounds: true # Enable sound effects
performance:
check-interval: 20 # Ticks between oxidation checks
max-per-chunk: 50 # Max oxidizing blocks per chunk
kit:
items:
campfire: 4 # Number of campfires in kit
copper-block: 64 # Number of copper blocks
water-bucket: 2 # Number of water buckets
flint-and-steel: 1 # Flint and steel for lighting
? Permissions
| Permission |
Description |
Default |
copperplus.use |
Access to basic commands |
All players |
copperplus.kit |
Use the /copperplus kit command |
All players |
copperplus.admin |
Admin commands (reload, set default language) |
Operators |
? Installation
-
Requirements:
- Paper server 1.21 or higher
- Java 21 or higher
-
Installation Steps:
- Download the latest
copper-plus-1.0.jar from releases
- Place the JAR file in your server's
plugins folder
- Restart your server
- Configure settings in
plugins/CopperPlus/config.yml
- (Optional) Customize language files in
plugins/CopperPlus/languages/
? Use Cases
For Builders
- Quickly obtain oxidized copper for builds without waiting hours
- Create gradient effects with different oxidation stages
- Mass-produce weathered copper for roofing and decoration
For Redstone Engineers
- Rapidly test copper bulb oxidation states
- Create controlled oxidation farms
- Experiment with different oxidation patterns
For Server Admins
- Provide quality-of-life improvement for players
- Reduce server load compared to tick acceleration methods
- Full control over oxidation speed and mechanics
? Unique Features
Why CopperPlus?
- Realistic Mechanism: Uses campfire heat and water (like real oxidation chemistry!)
- Performance Optimized: Efficient chunk-based processing
- Fully Integrated: Works with dispensers, all copper types, and vanilla mechanics
- Player Choice: Optional notifications, per-player language preferences
- Admin Friendly: Extensive configuration and reload without restart
? Update Roadmap
Planned Features
- Custom oxidation patterns and templates
- Waxing automation system
- Oxidation reversal with lightning integration
- GUI for language and settings management
- PlaceholderAPI support
- Economy integration for kit purchases
- Custom crafting recipes for oxidized variants
? Performance
- Lightweight: Minimal server impact with smart check intervals
- Scalable: Configurable limits prevent performance issues
- Efficient: Only processes active oxidation setups
- Clean: Automatic cleanup when chunks unload
? Troubleshooting
Common Issues
Oxidation not starting:
- Ensure campfire is lit (not just placed)
- Check water is within 1 block radius
- Verify copper block is directly above campfire
- Make sure the plugin is enabled in config
Messages not showing:
- Check if you've toggled messages off with
/copperplus togglemsg
- Verify your language file exists and is valid
- Ensure you're within 16 blocks of oxidizing copper
Performance issues:
- Reduce
max-per-chunk in config
- Increase
check-interval for less frequent updates
- Enable
clear-on-unload for better memory management
? Support
- Bug Reports: Create an issue on our GitHub repository
- Feature Requests: Suggest features through GitHub discussions
- Discord: Join our community server for live support
- Wiki: Detailed documentation available on GitHub Wiki
? License
This plugin is provided as-is for use on Minecraft servers. Redistribution or modification requires permission from the author.
?? Author
Timiliris_420 - Lead Developer
? Credits
- Paper team for the excellent API
- Minecraft community for inspiration
- All contributors and testers
CopperPlus - Making copper oxidation fun and fast! ?⚡
评论 0
登录后参与评分
还没有评论,来抢沙发吧