# DontKillFriends
**保护你的驯服动物免受伤害，即使你离线也不行！**
DontKillFriends 是一个轻量级的 Minecraft 插件，可以防止其他玩家伤害你心爱的宠物。无论你是否在线，你的驯服动物都能免受玩家攻击和环境破坏的侵害。
## 特性
- **完整的宠物保护** - 保护驯服动物免受所有类型的伤害
- **离线保护** - 即便你离线，你的宠物也能安全
- **HEX 颜色支持** - 带有自定义颜色的精美消息 (`&#RRGGBB`)
- **高度可配置** - 自定义保护的方方面面
- **调试模式** - 可选的详细日志记录，用于排除故障
- **轻量级** - 对性能的影响最小
- **多版本支持** - 兼容 Minecraft 1.16.5 - 1.21.8
## 支持的伤害类型
- 玩家攻击
- 爆炸（TNT、苦力怕等）
- 溺水
- 火焰和熔岩伤害
- 篝火伤害
- 雷击
- 坠落伤害
- 恶龙的吐息
- 投射物（箭等）
- 魔法和药水效果
- 毒药和凋零效果
## 指令
| 指令 | 描述 | 权限 |
|---------|-------------|------------|
| `/dkf version` | 显示插件版本 | `dontkillfriends.version` |
| `/dkf reload` | 重新加载插件配置 | `dontkillfriends.reload` |
**别名:** `/dontkillfriends` = `/dkf`
## 权限
| 权限 | 描述 | 默认 |
|------------|-------------|---------|
| `dontkillfriends.version` | 查看插件版本 | `op` |
| `dontkillfriends.reload` | 重新加载插件配置 | `op` |
| `dontkillfriends.bypass` | 绕过宠物保护（可以伤害任何驯服动物） | `op` |
## 配置
```yaml
# 主要保护设置
protect-offline-pets: true # 保护离线玩家的宠物
debug-logs: false # 在控制台中显示调试消息
# 要保护免受的伤害类型
immortal-from-explosion: true # 爆炸
immortal-from-drowning: true # 溺水
immortal-from-suffocation: true #窒息
immortal-from-fire: true # 火焰和熔岩
immortal-from-campfire: true # 篝火
immortal-from-lightning: true # 雷击
immortal-from-fall: true # 坠落伤害
immortal-from-dragon: true # 恶龙的吐息
immortal-from-host: true # 主人伤害
immortal-from-projectile: true # 箭和投射物
immortal-from-magic: true # 药水和魔法
# 消息 (通过 &#RRGGBB 支持 HEX 颜色)
hit-message: "&#FF6B6B&l你打伤了一个驯服的动物！" # 冲击消息
offline-owner-suffix: " &#FFD93D(主人离线)" # 当主人离线时附加的后缀 | 禁用 - ""
reload-message: "ECDC4成功重新加载插件。" # 关于插件重新加载的消息
commandTabComplete: true # 指令 TAB 完成
```
## HEX 颜色示例
你可以在消息中使用 HEX 颜色：
- `&#FF6B6B` - 红色
- `ECDC4` - 碧绿色
- `&#FFD93D` - 黄色
- `bFB98` - 淡绿色
- `&#FF69B4` - 亮粉色
示例：“&#FF6B6B&l危险！ &#FFD93D你不能伤害这只宠物！”
## 安装
1. 从 Modrinth 下载最新版本
2. 将 `DontKillFriends-x.x.x.jar` 放在服务器的 `plugins` 文件夹中
3. 重启你的服务器
4. 在 `plugins/DontKillFriends/config.yml` 中配置插件
5. 使用 `/dkf reload` 应用更改
## 故障排除
如果遇到问题：
1. 启用调试日志记录：在 config.yml 中设置 `debug-logs: true`
2. 使用 `/dkf reload` 应用更改
3. 检查控制台以获取详细信息
4. 在 Discord (@gu.b) 上报告问题，并附上调试日志