// TicketManager - TicketManager

TicketManager 是一个旨在让玩家轻松创建和理解支持工单，同时让管理团队也能便捷处理和查看这些工单的插件。

💡核心功能

• SQL 或 Flatfile 存储：可选择使用 SQL 数据库实现多服务器间工单同步，或使用 Flatfile 以获得更好的性能。
• 可配置的命令别名：如果玩家习惯使用其他命令来请求支持，你可以将其添加到别名列表中。
• 可配置的 GUI 点击音效：开启后，操作 GUI 时将会有响应音效。
• 工单创建/关闭通知：当工单被处理或创建时，相关人员会收到通知。
• 工单创建禁令：可以禁止特定玩家创建工单，防止滥用。
• 完全自定义的物品：所有 GUI 中的物品都可以在 config.yml 中自定义。
• 完全自定义的 GUI 名称：所有 GUI 的标题都可以自定义。
• 五个自定义分类：默认的工单分类可以完全替换为你自己的分类。
• 工单包含坐标：工单会自动记录玩家创建时的坐标，方便管理员处理位置相关的问题，即使玩家已下线。

🎮命令

• /ticket - 打开主工单 GUI。（无需权限）
• /ticket admin - 打开管理员工单 GUI。（需要权限：ticketmanager.admin）
• /ticket reload - 重载插件配置。（需要权限：ticketmanager.admin，执行后无反馈但生效）

🎮权限

• ticketmanager.admin - 允许打开管理员工单菜单。
• ticketmanager.notify - 当有新工单创建时通知拥有此权限的玩家。
• ticketmanager.bancreation - 拥有此权限的玩家将被禁止创建工单。

- 注意：拥有 `*` 全权限的管理员默认不受此限制。如需对其生效，可在权限插件中为其添加 `-ticketmanager.bancreation`。OP 玩家和拥有 `ticketmanager.admin` 权限的玩家自动豁免此限制。

🔧使用指南

玩家创建工单

• 输入 /ticket 打开主菜单，点击“创建工单”按钮。
• 进入创建界面，首先为工单选择一个分类（创建后仍可修改）。
• 选择重要性等级（1-5级）。
• 点击最终的“创建”按钮，然后在聊天框中输入你的工单描述信息。

管理处理工单

• 拥有权限的管理员输入 /ticket admin 打开管理菜单。
• 在管理菜单中，你可以选择查看：

- 所有未处理的工单

- 所有已关闭的工单

- 按五个分类分别查看的工单

• 点击进入相应列表后，可以看到所有相关工单及其摘要信息。
• 点击任意一个工单可以查看详情并进行操作：

- **直接私聊玩家**：点击提交者信息。

- **添加工单备注**：点击消息区域，可以为工单添加后续备注（供玩家或管理员查看）。

- **关闭工单**：点击关闭状态按钮。

- **注意**：即使工单关闭后，管理员仍然可以为其添加备注，此功能被设计为不显眼以防止滥用，但在需要时可用。

❓已知问题

• 与 MassiveCore 插件的冲突：当安装了 MassiveCore 插件时，在创建工单输入描述信息的过程中，消息会被发送到公共聊天频道。目前无法解决。

- 报告者：TITKATA_BG

⭐配置概览

配置文件 (config.yml) 结构清晰，允许深度自定义。主要配置区域包括：

• 基础设置：

- `Command_Aliases`: 命令别名列表，例如 `[tm, report]`。

- `Use_SQL`: 是否启用 SQL 存储 (`true`/`false`)。

- `SQL_*`: 数据库连接信息（当 `Use_SQL` 为 `true` 时生效）。

- `GUI_Click`: 是否启用 GUI 点击音效。

- `Category_One` 到 `Category_Five`: 五个可自定义的工单分类名称。

- `Whisper_Command`: 用于私聊玩家的命令（默认为 `whisper`）。

• GUI 物品自定义：配置文件为每一个玩家和管理员界面的每一个按钮物品都提供了独立的设置项，包括：

- `id`: 物品ID（格式如 `"160:13"`）。

- `name`: 物品显示名称（支持颜色代码）。

- `lore`: 物品描述文本（支持颜色代码）。

• 版本控制：文件底部的 VERSION 项请勿手动修改。

> 提示：配置文件中包含详细的中文索引，你可以使用 Ctrl + F 搜索“Player Ticket Setup”、“Staff Ticket Setup”等关键词快速定位到需要修改的区块。

✨支持与捐赠

如果您喜欢这个插件并想支持开发者（一名大学生），可以通过以下链接进行捐赠：

https://paypal.me/AaronSkeels