PunishmentGUI 是一款为服务器管理员设计的菜单插件，通过直观的图形界面执行警告、禁言、封禁等处罚操作，简化了玩家管理流程。
核心配置
基本设置
- Command: 定义
/punish <player>命令打开的菜单。默认值为{openmenu:main-menu}。 - ConsoleRunsCommands: 设置是否由控制台执行处罚命令。设为
false时，将由执行菜单点击的玩家执行。 - CheckForUpdates: 是否启用更新检查。
菜单系统
菜单在 menus: 节点下配置。默认提供了一个 main-menu 作为模板，你可以通过复制此格式来创建更多菜单。
- 使用
{openmenu:菜单名称}可以在配置中的任何动作选项里打开指定菜单。
默认主菜单详解
菜单标识为 main-menu，是插件的默认入口。
菜单属性
- name:
"main-menu" - menu-title: 菜单标题，显示为
&c&lPunishmentGUI。 - menu-size: 菜单大小，设置为
53（即6行）。 - fill-menu: 背景填充设置。
- `enabled: true` 启用背景填充。- 使用 `material: "STAINED_GLASS_PANE"` 和 `fill-data: 15`（黑色染色玻璃板）进行填充。处罚项目
每个项目都定义了名称、材质、在菜单中的位置（slot）、点击后执行的命令（command）和描述文本（lore）。命令中的 {target} 会被替换为目标玩家名。
分类入口项
这些项目用于打开更具体的子菜单（需自行配置）。
- ClientModOffensesItem (槽位 14): 客户端模组违规，如透视、强制攻击、速度、飞行、背包黑客等。
- GeneralOffensesItem (槽位 12): 一般性违规，如命令/地图/职业/技能漏洞利用等。
- ChatOffensesItem (槽位 10): 聊天违规，如言语辱骂、刷屏、骚扰、挑衅等。
直接处罚项
点击这些物品将直接对目标玩家执行预设命令。
- WarningItem (槽位 43): 执行警告命令
warn {target} Spam/Hack Accusation/Trolling -s。 - PermanentMuteItem (槽位 25): 永久禁言，原因示例为严重广告或其他严重违规。
- Severity1MuteItem (槽位 19): 1小时禁言，适用于轻度刷屏、广告、辱骂或外挂指控。
- Severity2MuteItem (槽位 28): 1周禁言，适用于中度刷屏、广告、辱骂或规避聊天过滤器。
- Severity3MuteItem (槽位 37): 1月禁言，适用于严重刷屏或严重辱骂/骚扰。
- PermanentBanItem (槽位 34): 永久封禁，适用于严重威胁。
- Severity1GeneralBanItem (槽位 21): 1小时封禁，适用于团队击杀、游戏内挑衅或利用地图/Bug。
- Severity1ClientBanItem (槽位 23): 1天封禁，适用于使用伤害显示、玩家雷达等。
- Severity2ClientBanItem (槽位 32): 1周封禁，适用于首次使用强制攻击、速度、攻击距离或其他黑客行为。
- Severity3ClientBanItem (槽位 41): 1月封禁，适用于使用强制攻击、速度、攻击距离、飞行等黑客行为，或作为二次违规的处罚。
- IPMuteItem (槽位 7): IP禁言，执行命令
ipmute {target} IPMUTE -s。 - IPBanItem (槽位 7): IP封禁，执行命令
ipban {target} IPBAN -s。
链接与支持
- 插件统计: 查看插件使用数据，请访问 https://bstats.org/plugin/bukkit/PunishmentGUI。
- 支持与提问: 需要帮助？请加入我们的 Discord 社区：https://bghddevelopment.com/discord。
PunishmentGUI 简介
PunishmentGUI 是一款强大的服务器管理插件，它通过直观的图形用户界面（GUI）简化了玩家处罚流程。管理员无需记忆复杂命令，即可快速执行踢出、禁言、封禁等操作，并自动记录处罚原因与执行者，是维护服务器秩序、提升管理效率的得力工具。
核心功能
- 直观的 GUI 管理：通过简洁的图形界面执行所有处罚操作，告别命令行。
- 全面的处罚类型：支持踢出、警告、禁言、临时封禁与永久封禁。
- 自动化记录：自动记录处罚时间、原因、执行管理员及受罚玩家。
- 历史记录查询：可查看任一玩家的完整处罚历史。
- 高度可定制：支持自定义 GUI 标题、物品、提示信息等。
- 多语言支持：内置多语言系统，方便国际化服务器使用。
- 时间格式灵活：支持多种时间单位（秒、分、时、天、周、月、年）的临时处罚设置。
- 静默处罚：可执行静默处罚，不向其他玩家广播。
- 集成支持：与 LiteBans 等封禁插件兼容。
命令与权限
主要命令
/punish <玩家>- 打开处罚指定玩家的 GUI 界面。/punishmenthistory <玩家>- 查看指定玩家的处罚历史记录。/punishmentgui- 显示插件帮助信息。/punishmentguireload- 重载插件配置文件。
主要权限
punishmentgui.command.punish- 允许使用/punish命令。punishmentgui.command.history- 允许使用/punishmenthistory命令。punishmentgui.command.reload- 允许使用/punishmentguireload命令。punishmentgui.notify- 当玩家受到处罚时接收通知。punishmentgui.bypass- 允许玩家绕过处罚（如免疫禁言）。
安装与配置
安装步骤
- 确保服务器已安装 Java 8 或更高版本。
- 将下载的
PunishmentGUI.jar文件放入服务器的plugins文件夹。 - 重启服务器。
- 根据需求编辑生成的配置文件。
配置文件
插件首次运行后，会在 plugins/PunishmentGUI 目录下生成配置文件，主要文件包括：
config.yml- 主配置文件，用于设置语言、GUI 标题、数据库等。messages.yml- 消息文件，可自定义所有提示文本。gui.yml- GUI 配置文件，可自定义菜单中的物品、名称、提示等。
基本配置
- 打开
config.yml，设置首选语言（如language: "zh"代表简体中文）。 - 根据需要调整数据库设置（默认使用 SQLite，无需额外配置）。
- 在
gui.yml中，可以自定义处罚项目对应的物品材质、名称和提示信息。
常见问题
- 问：如何自定义处罚理由？
答：在 gui.yml 文件中，找到对应的处罚项目（如 ban-item），修改其 name 和 lore 配置即可。
- 问：处罚历史记录存储在哪里？
答：默认使用 SQLite 数据库，文件位于 plugins/PunishmentGUI/punishments.db。您也可以在 config.yml 中配置 MySQL 数据库。
- 问：如何让处罚通知只对管理员可见？
答：确保只有拥有 punishmentgui.notify 权限的管理员才会收到处罚广播消息。
- 问：插件支持哪些 Minecraft 版本？
答：PunishmentGUI 支持 Spigot/Paper 1.8.x 及以上的多个版本，请在下载时选择对应版本。
- 问：如何迁移到 MySQL 数据库？
答：在 config.yml 中，将 storage-method 改为 MYSQL，并填写正确的 host、port、database、username 和 password 信息。
注意事项
- 使用前请备份服务器数据，尤其是在首次配置或更新插件时。
- 确保给予管理员正确的权限节点，否则他们将无法使用处罚命令。
- 自定义 GUI 时，请注意物品材质名称在不同 Minecraft 版本中的差异。
- 重载配置（
/punishmentguireload）可能导致临时 GUI 会话错误，建议在服务器负载较低时进行。 - 定期检查插件更新，以获取新功能和错误修复。
如需更多帮助，请访问官方资源页面：https://www.spigotmc.org/resources/punishmentgui.95487/
