Repair Shop

插件

· 作者 AlessyJay

RepairShop 是一款 Minecraft 插件,可将 Citizens NPC 转化为铁匠。玩家右键点击该 NPC 后,会弹出一个菜单,列出他们携带的所有受损物品,并根据物品的磨损程度、材质以及附魔情况定价,支付通过 Vault 完成。

0 本站下载 0 关注 更新于 6 天前

最新 2.3.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

RepairShop

一款 Minecraft 插件,将 Citizens NPC 转化为铁匠。玩家右键点击该 NPC,菜单会列出他们携带的所有受损物品,每项单独定价,价格取决于磨损程度、材质以及附魔情况。支付通过 Vault 进行。

交互模式借鉴自 dtlTradersPlus:点击 NPC 获取商店窗口,但这里是用于修理而非交易。


玩家功能

右键点击铁匠 NPC。菜单会显示主背包、快捷栏、盔甲槽和副手槽中所有受损物品,并显示其剩余耐久度、价格和之前被修理过的次数。

  • 修理一件物品:点击即可。
  • 修理所有物品:一个按钮为所有物品计价。如果总价超出承受范围,它将优先修理最便宜的物品,从而让玩家用现有资金修复尽可能多的物品。
  • 先查看价格:/repairshop quote 对手中物品进行计价并显示完整明细;/repairshop prices 列出每种材质等级完全修理的费用。

没有固定费用。一把耐久度为 95% 的木斧最低收费为 2₽;而一把附魔且几乎报废的下界合金斧价格将超过 2,000₽。

管理员功能

  • 多个商店。每个 NPC 指向一个带有独立标题、价格倍数、权限要求、接受的材质等级和拒绝的材质定义的商店配置。例如,村庄铁匠可以拒绝下界合金,而首都城市的顶级铁匠则以高价处理任何物品。
  • 游戏内编辑器。使用 /repairshop shops 可以在图形界面中浏览、创建和编辑商店。它生成的 shops/<id>.yml 文件包含与手动编写文件相同的解释性注释。只有在按下“保存”后才会保存数据,且保存后的商店立即生效,无需重载。
  • 等级折扣。基于权限的倍数折扣;玩家符合条件的最低倍数生效。
  • 按商店的审计日志。每次付费修理都会追加记录到 shops/<id>/logs/<date>.log,格式为固定列、管道分隔的表格,便于 grep 搜索和导入电子表格。在第一次付费修理时创建,此前不存在。
  • 完全可配置的文本。messages.yml 中包含 179 个消息键,全部使用 MiniMessage 格式。缺失的键会回退到 jar 包中捆绑的副本,因此插件更新永远不会破坏已编辑的文件。

定价机制

完全由配置文件驱动,代码中没有硬编码的数字。每一项都是 config.yml 中的键值。

damageRatio = damage / maxDurability
baseValue   = item-values[MATERIAL]  OR  tiers[TIER]
enchantAdd  = SUM( enchantment value * level )

cost = (baseValue * typeMultiplier + enchantAdd)
     * damageRatio ^ curve
     * shopMultiplier
     * rankDiscount
     * workPenalty

cost = max(cost, minimum-cost)

**工作惩罚(work penalty)**是值得理解的术语。插件的修理完全绕过了原版铁砧的“过于昂贵”限制,否则附魔装备将永久耐用。因此,插件对该物品执行的每一次修理都会增加复合附加费,每次 +15%,最高上限为 4 倍。此计数存储在物品本身之上。


支持的平台

该插件完全不使用 NMS 或 CraftBukkit 内部实现,仅基于 Bukkit API 底层。这正是它能够在各个分支间移植的原因:因为没有服务器内部实现可供分支更改。

平台 支持情况
Paper 完全支持。这是在此开发、调优和启动测试的原生目标平台。
Purpur, Pufferfish, Leaf 及其他 Paper 分支 完全支持。它们保留了完整的 Paper API。
Spigot 功能完整,但有两项自动降级,见下文。
CraftBukkit 与 Spigot 相同。
Mohist, Arclight, CatServer, Ketting (Forge/Fabric 混合端) 应该可以使用——它们实现了 Bukkit API,且本插件未触及低于该 API 的部分。未经测试,且混合端通常更不稳定。

在 Spigot 和 CraftBukkit 上,有两项内容处理方式不同。这两者在启动时自动检测,无需配置:

  • 文本 Spigot 从未提供 Adventure 库,因此 MiniMessage 通过内置的传统 § 翻译器渲染。颜色、十六进制色值和五种装饰样式均保留;渐变折叠为其第一个颜色,悬停/点击文本被丢弃但保留其内容。
  • 聊天提示 使用 AsyncPlayerChatEvent 替代 Paper 的 AsyncChatEvent。

运行 /repairshop compat 可查看当前服务器采用了哪种路径。

不支持

  • Folia Folia 的区域化线程移除了 Bukkit.getScheduler(),而本插件使用它来处理聊天提示超时、重新打开菜单和异步日志写入。此外,Folia 拒绝加载未声明 folia-supported: true 的插件,因此它会干净地失败而不是行为异常。要支持它,需要将这些调用站点移植到 Folia 的调度器,并审查“所有操作都在主线程上运行”这一修理流程所依赖的假设。
  • BungeeCord / Velocity 代理服务器,而非 Bukkit 服务器。
  • Vanilla、Forge 或 Fabric(无 Bukkit 桥接) 完全没有 Bukkit API。

支持的 Minecraft 版本

一个 JAR 文件支持 Minecraft 1.9 至 26.2。 插件在启动时通过检测服务器中已迁移的 API 的具体版本来确定兼容性,其判断依据始终是某个类或方法_是否存在_,而不是解析版本号字符串。这一点至关重要,因为 Minecraft 在 2026 年转向了基于年份的版本命名体系,因此将 1.21 与 26.2 进行比较是完全错误的。

api-version 固定为 1.13:这是现代服务器接受的最旧值,而 1.9–1.12 版本的服务器完全忽略该键。结合编译为 Java 8 字节码,这使得单个 JAR 文件能够覆盖整个版本范围。

在较旧服务器上的变化:

完整版本支持 其他情况
MiniMessage 渐变、悬停提示、点击事件 Paper 1.16.5+ 使用传统的 § 代码;颜色和装饰效果依然保留
工作惩罚 1.14+ 不生效。 它需要持久化数据容器来存储每件物品的修理计数;在 1.14 以下版本中没有地方可以保存这个计数,因此每次修理都被视为首次修理。控制台会在启动时打印一次说明。
每件物品的最大耐久度 1.20.5+ 使用该材质的默认值,这也是这些旧版本唯一可用的答案
附魔闪烁按钮 1.20.5+ 使用较旧的隐藏附魔技巧。外观完全相同。
shops/*.yml 中的注释 1.18.1+ 数值相同,保留标题,省略每行键的注释
超过 32 个字符的 GUI 标题 1.13+ 截断以适应宽度,绝不会在颜色代码中间截断

材质和附魔名称的处理方式是“适配”而非“降级”:配置文件会同时读取扁平化之前和之后的词汇表,因此一个文件可以将 GOLDEN_AXE 和 GOLD_AXE,或者 DIG_SPEED 和 efficiency 视为同一事物进行定价。

要求

服务器 Minecraft 1.9 – 26.2,任何 Bukkit-API 实现(见上文)
Java 取决于你的服务器本身所需的版本。该 JAR 文件是 Java 8 字节码,所有后续的 JVM 都能加载,因此它自身不增加任何额外要求
必需依赖 Vault 以及任意经济提供商(EssentialsX 是经过测试的)
可选依赖 Citizens 如果没有它,NPC 功能不可用,但 /repairshop open 仍然可用

如果没有注册任何 Vault 经济提供商,插件会记录错误并禁用自身,因为它没有任何方式来收取费用。

命令与权限

/repairshop,别名 /rshop 和 /repairnpc。

Command 功能 权限
/repairshop help 帮助页面,仅显示发送者可以运行的命令
/repairshop quote [shop] 查看手中物品的价格,并提供详细分解 repairshop.quote (默认: true)
/repairshop prices 查看每种材质等级全额修理的费用 repairshop.quote (默认: true)
/repairshop shops 浏览、创建和编辑图形界面中的商店 repairshop.admin (默认: op)
/repairshop create|edit|delete <shop> 管理单个商店 repairshop.admin
/repairshop assign <shop> / unassign 将选定的 NPC 设置为修理商店,或取消此设置 repairshop.admin
/repairshop open [shop] [player] 打开商店菜单 repairshop.admin
/repairshop list 列出已配置的商店 repairshop.admin
/repairshop compat 显示本服务器的 API 差异是如何解决的 repairshop.admin
/repairshop reload 重新加载配置、消息和商店 repairshop.admin

开启由 NPC 经营的商店需要 repairshop.use 权限 (默认:true)。

EssentialsX 拥有 /repair(以及 fix、efix、erepair),而 RepairShop 故意不占用该命令。

设置

将 Vault、一个经济插件提供者、Citizens 和 RepairShop-<version>.jar 放入 plugins/ 目录,启动服务器,然后执行:

/npc create Blacksmith
/repairshop assign default

这就是全部的设置步骤。


有关版本发布历史,请参阅 CHANGELOG.md。项目主页位于 C:\Coding\Java\Repair Shop Plugin,包含完整的文档集 docs/PRICING.md、docs/CONFIGURATION.md、docs/ARCHITECTURE.md、docs/BUILDING.md 和 docs/COMPATIBILITY.md。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源