SimpleJail - 简易监狱

简介

SimpleJail 是一款轻量级、易于使用的监狱插件。它允许拥有权限的玩家将其他玩家关入监狱、释放他们，并查看监狱状态。插件还提供了命令白名单功能，可限制囚犯在狱中只能使用特定命令。所有消息均可自定义，并支持 UUID。插件理论上支持 /reload 重载，但更推荐完全重启服务器以确保稳定。

💡依赖与要求

• Java 版本: 需要 Java 8 或更高版本。
• 服务端核心:

- 插件版本低于 2.2：需要 Spigot/Bukkit 1.8 至 1.12。

- 插件版本 2.2 及以上：需要 Spigot/Bukkit 1.16 或更高版本。

🎮安装与设置

基础安装

• 将插件文件放入服务器的 plugins 文件夹。
• 启动或重载服务器，插件会自动生成配置文件。
• 配置文件选项的详细说明可在下文“示例配置”部分找到。

重要准备

• 建造牢房：你需要手动建造一个无法破坏的监狱牢房。本插件不提供方块保护功能，囚犯有可能破坏方块越狱。建议使用其他保护插件或将牢房建在基岩中。
• 设置传送点：使用下方提供的命令设置“关押传送点”和“释放传送点”。

🔧命令与权限

所有命令默认仅限 OP 管理员使用。命令格式说明：<必填参数> [可选参数] (解释)。

• /jail <player> <time (#mon|#d|#h|#m)> <reason>

- **权限**: `simplejail.jail`

- **示例**: `/jail Prunt 7d2h Griefing is not allowed!`

- **功能**: 将指定玩家关入监狱一段时间。会将其传送至预设的监狱点。时间格式可组合使用（例如 `1mon2h`）。

• /unjail <player>

- **权限**: `simplejail.unjail`

- **示例**: `/unjail Prunt`

- **功能**: 释放指定玩家。会将其传送至预设的释放点。

• /checkjail <player>

- **权限**: `simplejail.checkjail`

- **示例**: `/checkjail Prunt`

- **功能**: 检查指定玩家是否在狱中。如果在，则显示其关押信息。

• /setjail

- **权限**: `simplejail.setjail`

- **功能**: 设置玩家被关押时的传送点。请确保此地点安全（如用基岩建造或用其他插件保护）。

• /setunjail

- **权限**: `simplejail.setunjail`

- **功能**: 设置玩家被释放时的传送点。例如，可以设置为服务器出生点或监狱外部。

• /simplejail

- **权限**: `simplejail.reload`

- **功能**: 重新加载插件配置文件。

⭐配置

完整的配置文件示例可在插件的 GitHub 页面找到。所有游戏内的提示消息都可以在配置文件中进行自定义。

❓常见问题与支持

反馈与支持

• 如有任何问题、功能请求或错误报告，请在插件的 Discussion（讨论区） 板块提出，请勿在评论（Review）区发布。
• 如果你喜欢这个插件，请在评论区给它评分。如果不喜欢，请在讨论区告诉我们原因。

开发状态

• 请注意，作者已不再积极开发此插件，因此很可能不会添加新功能。
• 欢迎在 GitHub 上提交 Pull Request 来贡献代码。

✨未来可能的功能 (TODO 列表)

以下是作者设想中但尚未实现的功能列表，供社区开发者参考：

• 支持多个监狱：例如 /setjail [name], /jails 命令。
• 支持永久监禁，以及年、秒级时间单位。
• 添加保释系统。
• 添加“警棍”物品：用其击打玩家可将其关押指定时间，并可配置没收其特定物品（如“毒品”）。
• 为每个牢房添加显示惩罚信息的牌子。
• 添加 /jailtime 命令。
• 添加“手铐”功能（冻结玩家）。
• 在消息变量中添加 %length%（显示刑期）和 %punisher%（显示处罚者）。
• 添加 simplejail.jail.exempt 权限（免于被关押）。
• 添加查看所有在押玩家及其信息的命令。
• 添加查看玩家历史处罚记录的命令。
• 配置项：允许管理员设置在线与离线时间流逝比例（0 到 2 之间）。
• 选项：禁止囚犯使用聊天功能。
• 选项：广播玩家被关押的消息，并添加静默选项 /jail -s。
• 选项：禁止囚犯使用或交互特定的物品/方块。