Copper Plus

添加关于铜的机制。

资源图片
# CopperPlus - 高级铜氧化插件 [![Minecraft 版本](https://img.shields.io/badge/Minecraft-1.21-brightgreen.svg)](https://www.minecraft.net/) [![Paper API](https://img.shields.io/badge/Paper%20API-1.21-blue.svg)](https://papermc.io/) [![语言](https://img.shields.io/badge/Languages-11-orange.svg)](#支持的语言) ## 🎮 概述 CopperPlus 是 Minecraft 1.21+ 的一个生活质量插件,它彻底改变了铜的氧化机制。使用篝火和水将缓慢的自然氧化过程转变为快速、可控的系统 - 非常适合需要快速氧化铜的建筑师和红石工程师! ## ✨ 主要特性 ### ⚡ 加速氧化系统 - **快速氧化**: 将铜块放在点燃的篝火上方,附近有水来显著加快氧化速度 - **智能检测**: 自动检测有效的设置并开始氧化过程 - **水速度乘数**: 更多的水块 = 更快的氧化速度 (每水块可配置的奖励) - **视觉反馈**: 氧化期间的粒子效果和声音通知 - **进度跟踪**: 实时氧化进度消息 ### 🌍 多语言支持 (11 种语言!) - **英语** (en_US) - 默认 - **简体中文** (zh_CN) - 简体中文 - **西班牙语** (es_ES) - Español - **印地语** (hi_IN) - हिन्दी - **阿拉伯语** (ar_SA) - العربية - **葡萄牙语** (pt_BR) - Português - **俄语** (ru_RU) - Русский - **日语** (ja_JP) - 日本語 - **德语** (de_DE) - Deutsch - **法语** (fr_FR) - Français - **韩语** (ko_KR) - 한국어 ### 🛠️ 其他特性 - **入门套件**: 包含篝火、铜块、水桶和打火石的快速启动套件 - **投掷器支持**: 投掷器可以放置自动开始氧化的铜块 - **消息切换**: 玩家可以启用/禁用氧化通知 - **智能区块管理**: 通过可配置的每个区块限制进行高效处理 - **完全可配置**: 所有功能都具有广泛的配置选项 ## 📋 命令 所有命令都使用主命令 `/copperplus` (别名: `/cp`, `/copper+`): | 命令 | 描述 | 权限 | |---------|-------------|------------| | `/copperplus help` | 显示所有可用命令 | `copperplus.use` | | `/copperplus kit` | 获取铜氧化入门套件 | `copperplus.kit` | | `/copperplus language` | 查看你当前的语言 | `copperplus.use` | | `/copperplus language set ` | 更改你的语言 | `copperplus.use` | | `/copperplus language list` | 列出所有可用语言 | `copperplus.use` | | `/copperplus language admin ` | 设置服务器默认语言 | `copperplus.admin` | | `/copperplus togglemsg` | 切换氧化消息的开关 | `copperplus.use` | | `/copperplus reload` | 重新加载插件配置 | `copperplus.admin` | ## 🔧 工作原理 ### 基本设置 1. 放置一个 **篝火** (普通或灵魂篝火) 2. 将 **铜块** 放置在篝火的正上方 3. 放置 **水** 块在附近 (1 个方块半径内) 4. 氧化发生时,篝火必须 **点燃** 5. 观看你的铜在几秒钟内氧化,而不是几个小时! ### 氧化速度公式 - **基础速度**: 可配置的持续时间 (默认: 完整氧化需要 60 秒) - **水奖励**: 每个水块都会增加速度乘数 - **最大值**: 最多 26 个水块可以影响氧化速度 - **公式**: `速度 = 1.0 + (水块 × 水速度奖励)` ### 氧化阶段 该插件支持所有原版铜氧化阶段: - 铜块 → 裸露铜 - 裸露铜 → 风化铜 - 风化铜 → 氧化铜 适用于所有铜变体:方块、楼梯、石板和切割铜! ## ⚙️ 配置 ### 关键配置选项 ```yaml 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` | 管理命令 (重新加载,设置默认语言) | 操作员 | ## 📦 安装 1. **要求**: - Paper 服务器 1.21 或更高版本 - Java 21 或更高版本 2. **安装步骤**: - 从发布版下载最新版本的 `copper-plus-1.0.jar` - 将 JAR 文件放入服务器的 `plugins` 文件夹中 - 重新启动你的服务器 - 在 `plugins/CopperPlus/config.yml` 中配置设置 - (可选) 在 `plugins/CopperPlus/languages/` 中自定义语言文件 ## 🎯 用途 ### 建筑师 - 快速获取氧化铜,无需等待数小时 - 创建具有不同氧化阶段的渐变效果 - 大规模生产风化铜用于屋顶和装饰 ### 红石工程师 - 快速测试铜线圈的氧化状态 - 创建可控的氧化农场 - 试验不同的氧化模式 ### 服务器管理员 - 为玩家提供生活质量改进 - 与滴加速方法相比,减少服务器负载 - 完全控制氧化速度和机制 ## 🌟 独特特性 ### 为什么选择 CopperPlus? 1. **逼真的机制**: 使用篝火的热量和水 (就像真正的氧化化学一样!) 2. **性能优化**: 通过智能检查间隔进行高效的区块处理 3. **完全整合**: 支持投掷器、所有铜类型和原版机制 4. **玩家选择**: 可选通知,每位玩家的语言偏好 5. **管理友好**: 所有功能的广泛配置和无需重启即可重新加载 ## 🔄 更新路线图 ### 计划中的功能 - [ ] 自定义氧化模式和模板 - [ ] 氧化自动化系统 - [ ] 使用闪电进行氧化逆转 - [ ] 用于语言和设置管理的用户界面 - [ ] PlaceholderAPI 支持 - [ ] 经济整合以进行套件购买 - [ ] 自定义氧化变体配方 ## 📊 性能 - **轻量级**: 智能检查间隔可使服务器影响最小 - **可扩展**: 可配置的限制可以防止性能问题 - **高效**: 仅处理活动氧化设置 - **干净**: 当区块卸载时自动清理 ## 🐛 故障排除 ### 常见问题 **氧化没有开始:** - 确保篝火点燃 (不是仅仅放置) - 检查水是否在 1 个方块半径内 - 验证铜块是否在篝火正上方 - 确保在配置文件中启用插件 **消息没有显示:** - 检查您是否使用 `/copperplus togglemsg` 切换了消息 - 验证语言文件是否存在且有效 - 确保您在氧化铜的 16 个方块范围内 **性能问题:** - 在配置中减少 `max-per-chunk` - 增加 `check-interval` 以获得不太频繁的更新 - 启用 `clear-on-unload` 以获得更好的内存管理 ## 💬 支持 - **错误报告**: 在我们的 GitHub 存储库中创建一个问题 - **功能请求**: 通过 GitHub 讨论建议功能 - **Discord**: 加入我们的社区服务器以获得实时支持 - **Wiki**: 在 GitHub Wiki 上提供详细文档 ## 📜 许可证 此插件作为“按原样”提供给 Minecraft 服务器使用。未经作者许可,禁止重新分发或修改。 ## 👨‍💻 作者 **Timiliris_420** - 首席开发人员 ## 🙏 鸣谢 - Paper 团队提供出色的 API - Minecraft 社区提供灵感 - 所有贡献者和测试者 --- *CopperPlus - 让铜氧化变得有趣和快速!* 🎮⚡