转载 工具 经验修补自动修复 1.4

[MD]
# 经验修补自动修复

让背包中的所有经验修补装备自动恢复耐久。拾取经验时，身上携带的物品都会获得修复，不再仅限于手持物品。

原版经验修补只会修复手持物品和已穿戴的盔甲。以往你需要在经验农场中不断切换：拿出镐子修一会儿，再换剑、换铲子……而经验修补自动修复将结束这一流程。

每当玩家拾取经验时，背包和快捷栏内所有已损坏、附有经验修补附魔的物品都会自动修复，无需将它们拿在手上。

**无需手持，无需切换，无需重复操作。**无论是采矿、战斗还是耕作，装备都会在后台悄然恢复耐久。

## 功能特性

- **全背包经验修补**
每次拾取经验时，插件都会扫描快捷栏和主背包，并使用剩余经验修复其中已损坏的经验修补物品。

- **兼容原版机制**
游戏仍会优先按原版规则修复手持物品和盔甲。插件仅使用剩余经验，不会重复消耗或遗漏经验。

- **可配置修复效率**
可设置每点经验恢复的耐久值。`2` 为原版比例；你可以提高或降低修复成本，也支持小数。

- **可选修复顺序**
可指定优先修复的物品：最接近损坏的物品、接近修满的物品、按快捷栏与背包顺序，或采用类似原版的随机顺序。

- **动作栏反馈**
物品被修复时，动作栏会显示类似“已修复 钻石镐 +14”的提示，并可选播放轻微音效。两项功能均可关闭。

- **玩家独立开关**
使用 `/mar toggle`，玩家可自行开启或关闭自动修复。该设置会保存至玩家数据，并在重新登录或服务器重启后保留。

- **状态查询**
使用 `/mar status` 可查看当前修复效率、修复顺序、携带的经验修补物品数量、其中已损坏的数量、修复全部物品所需的经验，以及下一件将被修复的物品。

- **物品与世界控制**
可将指定物品类型加入黑名单，禁止其自动修复；也可在指定世界禁用插件。

- **兼容其他插件**
插件在事件处理的较后阶段运行，可正确应用经验加成和倍率效果，并且不会处理不可破坏物品。

- **支持翻译与自定义消息**
所有提示文本均位于 `messages.yml` 中，并支持 MiniMessage 格式。你可以翻译、重新设计消息样式，或通过一个开关关闭小型大写字母样式。

- **更新检查**
有新版本发布时，会向控制台和管理员发出提示。

- **零依赖**
仅需一个轻量级 JAR 文件，无需安装其他插件。

## 工作原理

1. 玩家拾取一个经验球。
2. 游戏会先按原版方式修复玩家的手持物品和盔甲。
3. 经验修补自动修复随后使用剩余经验，查找快捷栏和背包中已损坏的经验修补物品，并按照配置的顺序持续修复，直至经验耗尽。
4. 若仍有剩余经验，则会正常计入玩家的经验条。

## 命令

```text
/mar toggle 为自己开启或关闭自动修复
/mar status 查看当前设置及等待修复的物品
/mar help 打开帮助菜单

管理员命令
/mar version 检查更新
/mar reload 重载配置和消息文件
```

别名：`/mendingautorepair,`、`/autorepair`

## 权限

```text
mendingautorepair.use 拾取经验时修复背包内物品（默认：所有玩家）
mendingautorepair.toggle 使用 /mar toggle（默认：所有玩家）
mendingautorepair.status 使用 /mar status（默认：所有玩家）
mendingautorepair.help 使用帮助菜单（默认：所有玩家）
mendingautorepair.update 检查更新，并在登录时接收更新通知（默认：OP）
mendingautorepair.reload 重载配置（默认：OP）
```

## 配置

```yaml
enabled: true
durability-per-xp: 2 # 2 = 原版比例，1 = 修复成本翻倍，4 = 修复成本减半
repair-order: most-damaged # most-damaged | least-damaged | inventory | random
scan:
hotbar: true # 快捷栏槽位，不包括当前手持物品
main-inventory: true # 主背包中的 27 个槽位
equipped: false # 盔甲和双手物品；游戏本身已会修复它们
ignored-items: [] # 例如：[ELYTRA, NETHERITE_PICKAXE]
disabled-worlds: []
feedback:
actionbar: true
sound:
enabled: true
key: block.smithing_table.use
volume: 0.35
pitch: 1.6
update-check:
enabled: true
notify-on-join: true
```

### 修复顺序说明

| 配置值 | 说明 |
|---|---|
| `most-damaged` | 优先修复耐久损失最多的物品。 |
| `least-damaged` | 优先修复最接近修满的物品。 |
| `inventory` | 按背包扫描顺序修复。 |
| `random` | 随机选择物品，效果类似原版机制。 |

## 运行要求

- Paper `26.1.2` 或更高版本；兼容 Purpur 及其他 Paper 分支服务端。
- Java 25。
- 不支持 Spigot。
- 无需安装其他插件。

## 注意事项

- 手持物品和已穿戴装备始终由游戏本身优先修复。插件只会使用原版经验修补后剩余的经验，因此不会改变现有经验农场的机制。
- 修复效率配置仅影响插件执行的修复；手持物品和盔甲的原版修复比例保持不变。
- 不会扫描末影箱、潜影盒或收纳袋中的物品，仅处理玩家实际背包内的物品。
- 若从 `1.3` 或更早版本更新：当前版本为完全重写版。请删除一次旧版配置文件夹，以便重新生成新的配置和消息文件。
[/MD]