# 胸部保护
一个简单但强大的 Minecraft 插件,用于通过基于符号的所有权和请求系统来保护箱子。
**作者:juicyyfruittsnackss** - [dsc.gg/fruitsnacks](https://dsc.gg/fruitsnacks)
## 特色功能
- **基于简单符号的保护**: 通过放置带有 `:username:` 格式的符号来保护箱子
- **直接箱子认领**: 使用 `/claimchest` 命令直接认领箱子
- **基于请求的访问**: 玩家可以请求临时访问受保护的箱子
- **交互式聊天组件**: 箱子所有者可点击接受/拒绝按钮
- **权限系统**: 不同的功能具有粒度权限节点
- **可配置的消息**: 所有消息都可以在配置文件中自定义
- **优化性能**: 极低的服务器资源占用
- **Paper 和 Spigot 兼容**: 与 Paper、Spigot 和其他分支兼容
## 安装
1. 下载 ChestProtect 最新版本
2. 选择与你的 Minecraft 版本匹配的 JAR 文件 (例如,`ChestProtect-1.0.0-mc1.21.4.jar` 用于 Minecraft 1.21.4)
3. 将 JAR 文件放入服务器的 `plugins` 文件夹
4. 重启你的服务器或使用插件管理器加载插件
5. 首次运行时将自动生成配置文件
## 使用方法
### 保护箱子
方法 1:使用符号
1. 在世界中放置一个箱子
2. 在箱子的任何一侧放置一个符号
3. 在符号的任何一行上写入 `:username:` (将 username 替换为你的名字)
4. 符号将自动格式化以显示其已受到保护
方法 2:使用认领命令
1. 在世界中放置一个箱子
2. 在箱子的任何一侧放置一个符号 (可以为空)
3. 盯着箱子并输入 `/claimchest`
4. 符号将自动格式化以显示其已受到保护
### 请求访问
1. 尝试打开受保护的箱子 (你会看到一条消息提示它受到保护)
2. 点击建议的命令或手动输入 `/openrequest `
3. 所有者将收到带有可点击的接受/拒绝按钮的通知
4. 如果接受,你将获得临时访问权限,可以一次打开箱子
### 解锁你自己的箱子
1. 直接盯着你受保护的箱子
2. 输入 `/unlockchest`
3. 箱子保护将被移除,任何人都可以访问它
### 命令
- `/openrequest ` - 请求访问玩家受保护的箱子
- `/acceptrequest ` - 接受箱子访问请求
- `/denyrequest ` - 拒绝箱子访问请求
- `/unlockchest` - 移除你正在盯着的箱子的保护
- `/claimchest` - 使用附加的符号认领并保护一个箱子
### 权限
- `chestprotect.request` - 允许请求箱子访问 (默认:true)
- `chestprotect.accept` - 允许接受箱子访问请求 (默认:true)
- `chestprotect.deny` - 允许拒绝箱子访问请求 (默认:true)
- `chestprotect.protect` - 允许保护箱子 (默认:true)
- `chestprotect.unlock` - 允许解锁你自己的受保护箱子 (默认:true)
- `chestprotect.protect.others` - 允许为其他玩家保护箱子 (默认:op)
- `chestprotect.admin.unlock` - 允许解锁任何受保护的箱子 (默认:op)
- `chestprotect.admin` - 所有受保护箱子的管理员访问 (默认:op)
## 配置文件
插件的配置文件存储在 `plugins/ChestProtect/config.yml`。 您可以修改访问请求的超时时长以及向玩家显示的所有消息。
```yaml
# 访问请求将保持有效的时间,以秒为单位
request_timeout: 60
# 消息配置
# 使用 & 用于颜色代码,{0}、{1} 等用于参数
messages:
prefix: "&8[&6ChestProtect&8] &r"
# 错误消息、成功消息等。
# 请参阅默认配置文件以获取所有可用选项
```
## 版本兼容性
ChestProtect 与 PaperMC 完全兼容,并且已在 Minecraft 1.21.4 上测试过。 它采用插件开发的推荐最佳实践,并在可能的情况下避免使用任何已弃用的 API 方法。
JAR 文件名称根据它们构建的 Minecraft 版本命名 (例如,`ChestProtect-1.0.0-mc1.21.4.jar`),这使得轻松选择适合你的服务器的正确版本变得容易。
## 支持
如有任何支持、功能请求或错误报告,请加入我们的 Discord 服务器:[dsc.gg/fruitsnacks](https://dsc.gg/fruitsnacks)。
## 鸣谢
由 juicyyfruittsnackss 创建。 访问 [dsc.gg/fruitsnacks](https://dsc.gg/fruitsnacks) 获取更多插件和支持。