HelpTickets - 游戏内问题追踪与工单管理插件

HelpTickets 是一款功能强大的插件，用于在游戏内追踪和管理玩家提交的问题。当玩家遇到问题时，可以创建一张工单，随后由管理团队成员进行处理和解决。

💡核心特性

• 信息全面：每张工单自动包含完整的上下文信息。
• 权限简洁：简化的权限节点系统。
• 操作可追溯：所有针对工单的操作都会被记录并保存。
• 高效存储：使用 MySQL 或 SQLite 数据库，运行快速。
• 优先级支持：可为工单设置不同的优先级级别。
• 灵活搜索：支持按状态、创建者、处理者、关键词或优先级搜索工单。
• 游戏内通知：工单更新时，相关玩家会收到游戏内通知。
• 高度可配置：所有命令名称和提示信息均可自定义。
• 多服支持：使用 MySQL 数据库可实现多服务器支持，无需 BungeeCord 桥接。
• 网页界面：提供全新的 Web 界面（需额外安装 HelpTickets - WebUI）。

🎮命令与权限

所有游戏内操作均通过 /ticket 命令及其子命令完成。

• 玩家使用指南：https://goo.gl/DhPNhJ
• 管理团队使用指南：https://goo.gl/Tkt7as

权限节点的详细说明请参阅管理使用指南。

🔧配置说明

插件配置简单明了，主要选项如下

常规设置

• check_updates
• 默认值：true
• 设为 false 将禁用自动更新检查。

• date_format
• 默认值："MM/dd/yyyy"
• 日期格式字符串。

• time_format
• 默认值："HH:mm:ss"
• 时间格式字符串。

• show_open_tickets_on_login
• 默认值：true
• 设为 true 时，拥有 helptickets.manage 权限的玩家登录时会看到未处理工单的提示。

• language
• 默认值："en_US"
• 设置插件使用的语言文件。语言文件位于 HelpTickets/languages/{language}.json。如果文件未找到，将默认使用 en_US.json。

• archive_tickets
• 默认值：true
• 设为 false 时，已关闭的工单将在 keep_tickets_for 设定的天数后被永久删除。

• keep_tickets_for
• 默认值：5
• 当 archive_tickets 为 false 时，此选项决定已关闭工单的保留天数。

• override_helpop
• 默认值：true
• 设为 true 时，任何尝试使用 /helpop 的玩家将被引导使用本插件创建工单。

• reminder_interval
• 默认值：6000
• 未处理或已更新工单的提醒间隔（单位：游戏刻）。设为 0 或负数将禁用提醒。

• strip_console_colors
• 默认值：false
• 设为 true 时，控制台所有输出将移除颜色和格式代码。

• strip_ingame_colors
• 默认值：false
• 设为 true 时，游戏内所有输出将移除颜色和格式代码。

数据库设置

• use_mysql
• 默认值：false
• 设为 true 时，插件将尝试使用 MySQL 数据库而非 SQLite。

以下选项在 use_mysql 为 true 时必须正确配置，否则插件无法工作：

• db.name
• 默认值：null
• 数据库名称（需用双引号包裹）。

• db.host
• 默认值：null
• 数据库地址（需用双引号包裹）。

• db.port
• 默认值：null
• 数据库端口（通常为 3306）。

• db.username
• 默认值：null
• 数据库用户名（需用双引号包裹）。

• db.password
• 默认值：null
• 数据库用户密码（需用双引号包裹）。

网页界面设置

> 注意：以下选项仅在安装了 HelpTickets - WebUI 后生效。

• web_interface.enabled
• 默认值：false
• 设为 true 以启用网页界面。

• web_interface.host
• 默认值："0.0.0.0"
• Web 服务器绑定的地址。

• web_interface.port
• 默认值：8080
• Web 服务器监听的端口。

❓语言与翻译

语言文件结构

如果您遇到 “missing language element: xxx” 的错误提示，可以在下方找到默认的语言元素，并将其添加到您的 languages/en_US.json 文件中。或者，如果您未对语言文件进行任何修改，或希望恢复默认设置，只需删除该文件并重载插件即可。

默认语言文件内容如下

{
"plugin.prefix": "&b[&6HelpTickets&b]",
"ticket.name": "ticket",
"ticket.created_by": "created by",
...
（此处为完整的语言键值对，内容与原文提供的 JSON 代码一致）
...
"yes.name": "yes",
"no.name": "no"
}

贡献翻译

我们欢迎社区贡献翻译！如果您希望将此插件翻译成其他语言：

• 复制默认的 en_US.json 文件。
• 将其翻译为您的目标语言。
• 将翻译好的文件发送给开发者。

开发者会很高兴将其包含在插件发行版中，并会注明您的贡献。感谢以下贡献者：

• @montlikadani - 匈牙利语 (hu_HU)
• @DarkFort - 俄语 (ru_RU)
• @ShuriZma - 德语 (de_DE)

✨安装与依赖

• 版本要求：
• HelpTickets 1.7 及以上版本无需任何依赖。
• 1.7 之前的版本依赖 ShortUtils 插件。

• 数据库：
• MySQL 数据库是可选的，但强烈建议大型服务器使用以获得更好的性能和跨服支持。
• 使用 SQLite 则无需额外配置。

⭐注意事项与支持

• 本插件免费提供，但如果您喜欢它，请考虑捐赠以支持开发。
• 使用 MySQL 数据库可实现真正的多服务器工单系统，无需依赖 BungeeCord。
• 如果遇到数据库错误，请尽快通知服务器管理员。