- 版权类型
- 原创
- 插件中文名称
- 星辰铁匠
- 插件英文名称
- DreamRepair
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- Purpur
- 语言支持
- 多语言
- 前置组件
- Vault
- 适配版本(Java)
- 最新版本
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
- 1.7
[MD]
# DreamRepair
> 一款轻量级付费修理插件
`MC 1.7.x – 1.21.x` · `Spigot / Paper / Purpur · `Java 8` · `Vault`
[ATTACH type="full" size="1080x1620"]152520[/ATTACH]
---
## 简体中文
### 让每一次修理,都物有所值
**DreamRepair** 是一个面向 Minecraft 生存、RPG 与经济服的轻量级付费修理插件。玩家手持需要修理的装备输入 `/dr`,插件按实际损耗耐久计算费用,通过 Vault 扣款后恢复耐久,并把流水写入 YAML 日志。
> 不改变玩法,只给服务器增加一个稳定、透明、可配置的金币回收点。
### 一览
| 项目 | 内容 |
|---|---|
| 插件名称 | DreamRepair |
| 当前版本 | 1.0.0 |
| Minecraft | 1.7.x – 1.21.x |
| 服务端 | Spigot / CraftBukkit / Paper / Purpur |
| 经济前置 | Vault + EssentialsX / CMI / CraftConomy 等 |
| 语言 | en_us / zh_cn / 自定义语言文件 |
| 数据存储 | YAML 文件日志,无数据库 |
### 核心功能
- **按损耗耐久计费** — 费用 = 损耗点数 × 基础单价 × (1 + 服务费率%),支持单次上限,金额保留两位小数。
- **二次确认防误触** — 第一次 `/dr` 显示费用与超时时间,第二次确认才扣款;确认超时或临时更换物品会自动重新发起。
- **Vault 经济接入** — 兼容 EssentialsX、CMI、CraftConomy 等主流经济插件;扣款前检查余额,失败时有明确提示。
- **多语言 i18n** — 内置 `en_us` / `zh_cn`;支持自定义语言文件;玩家提示、命令描述、控制台日志、货币名、物品名均可本地化;`/dr reload` 热切换。
- **YAML 流水日志** — 按玩家与日期生成 `log/{玩家}_{日期}.yml`,记录时间、物品、损耗、费用;支持按天保留与自动清理。
- **轻量开箱即用** — 仅依赖 Vault;无数据库、无额外前置;放入 `plugins/` 即可使用。
- **安全细节** — 空手、无耐久、无损、不可破坏物品都有校验;玩家退出会清理待确认状态;经济未连接时拒绝启动,而不是静默出错。
### 30 秒上手
1. **手持损坏物品** — 主手选中要修理的装备或工具。
2. **输入 `/dr`** — 查看本次损耗、费用和确认超时时间。
3. **再次输入 `/dr`** — Vault 扣款,耐久恢复,流水写入日志。
> 关闭二次确认后,一次执行即可直接修复;费用为 0 时也会直接修复且不扣款。
### 命令与权限
| 命令 | 说明 | 权限 | 默认 |
|---|---|---|---|
| `/dreamrepair` / `/dr` | 修理手持物品 | `dreamrepair.use` | true |
| `/dreamrepair help` | 查看帮助 | `dreamrepair.use` | true |
| `/dreamrepair reload` | 重载配置与语言文件 | `dreamrepair.admin` | op |
- 主命令仅玩家可执行;`help` / `reload` 也支持控制台。
- Tab 补全会按权限显示 `help` / `reload`。
- 无权限提示同样使用语言文件,不受 Bukkit 默认英文提示影响。
### 计费示例
```text
损耗 100 点 × 基础单价 1.0 × (1 + 2%) = 102.00 金币
```
- 公式:`费用 = 损耗耐久 × base-per-durability × (1 + service-percent%)`
- `max-cost: 0` 表示不设单次上限。
- 单价、费率、上限都在 `config.yml` 的 `economy` 段调整。
### 多语言(i18n)
- 语言文件位于 `plugins/DreamRepair/Language/*.yml`,使用 UTF-8 编码。
- 内置:`en_us`(英文,默认)、`zh_cn`(简体中文)。
- 切换:在 `config.yml` 设置 `language: "zh_cn"`,执行 `/dreamrepair reload`。
- 回退顺序:当前语言文件 → jar 内同语言文件 → `en_us`;升级后新增 key 不会出现空白。
- 自定义语言:复制 `en_us.yml` 为 `xx_xx.yml`,翻译后把 `language` 设为 `xx_xx`。
- 支持 `&` 颜色代码和 `{cost}`、`{currency}`、`{timeout}`、`{item}`、`{damage}` 等占位符。
- `messages.help` 中以 `[admin]` 开头的行只对拥有 `dreamrepair.admin` 权限的玩家显示。
- 控制台日志会自动剥离颜色代码,不会出现 `§a` 之类的乱码。
### 安装
1. 安装 Vault 与一个经济插件(如 EssentialsX)。
2. 把 `DreamRepair-1.0.0.jar` 放入服务器 `plugins/` 目录。
3. 重启服务器,首次启动会生成 `plugins/DreamRepair/`。
4. 编辑 `config.yml`,执行 `/dreamrepair reload` 即可生效。
### 配置示例
```yaml
language: "zh_cn"
economy:
base-per-durability: 1.0 # 每损耗 1 点耐久的基础费用
service-percent: 2.0 # 服务费率(%)
max-cost: 0 # 单次上限,0 = 不限
confirm:
enabled: true # 是否启用二次确认
timeout: 10 # 确认超时(秒)
options:
allow-unbreakable: false # 是否允许修复不可破坏物品
log:
enabled: true # 是否写入 YAML 流水日志
retention-days: 30 # 日志保留天数,0 = 永不清理
```
[/MD]