PunishmentGUI - LiteBansGUI, AdvancedBan & More (1.8-1.21.x+) - PunishmentGUI - 多功能处罚菜单插件

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/