Repair Hammers - 修复锤

Repair Hammers 是一款可配置的修复锤插件，允许玩家使用自定义的锤子来修复物品。只需将锤子拖放到背包中需要修复的物品上即可。锤子可以设置为修复固定耐久值或百分比，可以是一次性使用或无限使用，并且如果安装了 Vault，还可以设置购买和使用成本。插件支持 RPGItems，并允许你修复来自该插件的物品。

💡下载

根据你的服务器版本选择对应的插件版本

• 如果服务器运行 1.8 - 1.12，请下载版本 1.1.3
• 如果服务器运行 1.13+，请下载版本 1.1.4
• 如果服务器运行 1.15+，请下载版本 1.1.8
• 如果服务器运行 1.16+，请下载版本 1.2.0

✨安装

要求

• 需要 Java 8 或更高版本。

安装步骤

• 将插件 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑配置文件。
• 使用 /hammers reload 重载配置。

注意事项

• 如果你计划使用 RPGItems，请注意锤子只能修复到 durabilityUpperBound 或 maxDurability 中较低的值，请确保两者都已正确设置。
• 本插件使用 bStats 收集匿名数据。你可以在 plugins 文件夹中禁用 bStats。

🎮命令

• /hammer - 别名：/rh, /hammers
• /hammer help - 显示配置中的帮助信息
• /hammers list - 列出所有已设置的锤子及其修复量
• /hammers give <player> <hammer> (number) - 给予玩家一个或多个指定锤子
• /hammers buy <hammer> (number) - 购买指定数量的锤子
• /hammers reload - 重载配置文件
• /hammers info - 显示插件信息
• /hammer shop - 打开锤子商店
• /hammershop - 别名：/rhshop, /hammersshop，打开锤子商店

❓权限

管理员权限

• hammers.admin - 授予所有其他权限

命令权限

• hammers.reload - 允许使用 /hammers reload
• hammers.info - 允许使用 /hammers info
• hammers.help - 允许使用 /hammers 或 /hammers help
• hammers.listall - 允许在 /hammer list 中查看所有锤子
• hammers.list - 允许列出可以购买的锤子
• hammers.shop - 允许使用 /hammershop 和 /hammer shop
• hammers.update - 登录时若有插件更新则发送消息
• hammers.debug - 允许使用 /hammer debug item 查看物品信息

给予权限

• hammers.giveall - 授予 hammers.give 和所有 hammers.give.<name> 权限
• hammers.give - 允许使用 /hammers give 命令（仍需每个锤子的具体权限）
• hammers.give.<name> - 允许给予名为 <name> 的锤子（需要 hammers.give 权限）

购买权限

• hammers.buyall - 授予 hammers.buy 和所有 hammers.buy.<name> 权限
• hammers.buy - 允许购买锤子（用于命令和商店，仍需每个锤子的具体权限）
• hammers.buy.<name> - 允许购买名为 <name> 的锤子（需要 hammers.buy 权限）

使用权限

• hammers.useall - 允许使用所有锤子
• hammers.use.<name> - 允许使用名为 <name> 的锤子

权限组合示例

• 允许玩家购买和使用所有锤子：hammers.buyall, hammers.useall, hammers.shop, hammers.list
• 允许玩家购买和使用特定锤子：hammers.buy, hammers.buy.<name>, hammers.use.<name>, hammers.shop, hammers.list
• 允许管理员给予任何锤子：hammers.listall, hammers.giveall
• 允许管理员给予特定锤子：hammers.listall, hammers.give, hammers.give.<name>

🔧配置概述

主要配置文件 (config.yml)

配置文件允许你自定义插件行为、消息、可修复物品列表等。主要设置包括：

• 使用方式：设置是否允许通过背包拖放 (inventory)、右键点击 (rightclick) 或铁砧 (anvil) 来修复物品。
• 可修复物品类型：控制可以修复哪些插件添加的物品（如原版物品、RPGItems、AdditionsAPI 等）。
• 音效：启用/禁用使用锤子时的音效，并设置具体音效类型。
• 商店设置：配置 /hammershop 命令、商店布局和外观。
• 消息：自定义各种操作反馈和错误消息。
• 修复列表：定义可修复物品的列表组（例如 all 包含所有原版工具和盔甲，swords 仅包含剑）。

锤子配置文件 (hammers.yml)

此文件用于创建和自定义具体的修复锤。每个锤子都是一个独立的配置节点，例如 test1:。关键配置项包括：

• 基础属性：

- `name`: 锤子在游戏中的显示名称（支持颜色代码）。

- `type`: 锤子对应的物品材质（如 `IRON_INGOT`）。

- `enchanted`: 是否让锤子带有附魔光效。

• 修复属性：

- `amount`: 修复量，可以是具体数值（如 `50`）或百分比（如 `50%`）。

- `consume`: 锤子是否具有会被消耗的耐久度（百分比修复的锤子此项无效）。

- `destroy`: 使用后锤子是否被销毁（如果 `consume` 为 `true`，则在耐久为 0 时销毁）。

• 合成与成本：

- `crafting`: 设置锤子是否可合成及其合成配方。

- `cost`: 设置购买 (`buy`) 和使用 (`use`) 锤子所需的货币成本（需要 Vault）。

- `type`: 指定成本类型（金钱 `money`、等级 `level`、经验 `experience` 或无 `none`）。

• 功能与显示：

- `fixall`: 设置为 `true` 可修复玩家背包和盔甲栏的所有物品；`false` 则仅修复点击的物品。

- `fixlist`: 指定该锤子可以修复的物品列表（引用 `config.yml` 中定义的列表名，如 `all` 或 `swords`）。

- `lore`: 锤子的描述文本。

- `use` / `cantuse`: 使用成功或失败时发送给玩家的消息。

⭐可用值与资源

材料列表

锤子的 type 字段可以使用大量的 Minecraft 物品材质，例如 IRON_INGOT、DIAMOND、STICK 等。完整的列表非常长，涵盖了从 ACACIA_BOAT 到 ZOMBIE_VILLAGER_SPAWN_EGG 的几乎所有游戏内物品。

音效列表

config.yml 中的 sound 字段可以设置为各种游戏音效，例如默认的 BLOCK_ANVIL_USE。可用音效范围广泛，包括环境音、方块音、实体音、物品音和 UI 音效等。

🔧待办事项与已完成功能

计划添加的功能

• 通过命令编辑锤子
• 为修复量添加占位符
• 修复方块（例如损坏的铁砧变为完好的铁砧）

已完成的功能

• 添加使用锤子的权限
• 为每个锤子添加可修复物品列表
• 重做错误消息
• 添加使用锤子的成本
• 添加使用后不被消耗的锤子
• 支持 RPGItems
• 添加物品数据以更改染料颜色
• 支持 Additions API
• 支持插件扩展
• 添加具有耐久度的锤子
• 支持以经验和等级作为成本
• 支持合成锤子
• 支持 1.13 至 1.16 版本的物品
• 更新默认 config.yml
• 添加 API 事件
• 在铁砧中使用锤子修复物品
• 修复物品时播放音效

🔧示例与链接

• 在线示例：你可以在服务器 play.vivacitymc.com 的 /blacksmith 处找到修复锤。
• 统计信息：本插件使用 bStats，相关数据可在 https://bstats.org/plugin/bukkit/RepairHammers/7430 查看。