Bug Report - 玩家反馈管理插件

Bug Report 是一款帮助服务器管理员管理玩家提交的 Bug 报告的插件。所有报告可通过图形界面（GUI）便捷查看和处理，并自动记录玩家提交时的详细信息，让问题追踪和管理变得轻松高效。

💡核心功能

Bug Report 会自动收集并存储每份报告提交时的完整上下文信息，包括：

• 服务器名称
• 玩家名称
• 玩家 UUID
• 当前世界名称
• 完整的报告信息
• 分类 ID（如果启用该选项）
• 状态（可通过 GUI 自定义）
• 日期与时间
• 玩家坐标位置
• 玩家游戏模式

此外，你还可以

• 归档、取消归档或删除 Bug 报告。
• 完全自定义“报告详情”GUI 的界面。
• 自定义所有报告状态。
• 使用多语言选择器。

🎮命令与权限

命令列表

• /bugreport <信息> - 提交新的 Bug 报告。可直接输入信息，若启用分类则会打开 GUI 选择类别。
• /buglist - 打开设置页面中所有报告的列表 GUI。
• /buglistsettings - 打开 Bug 列表设置 GUI。
• /buglistarchived - 在 GUI 中查看所有已归档的报告。
• /buglinkdiscord <Webhook URL> - 设置 Discord Webhook 以接收所有 Bug 报告。

命令别名

• /br <信息> 对应 /bugreport <信息>
• /bl 对应 /buglist
• /bla 对应 /buglistarchived
• /bls 对应 /buglistsettings
• /bld <Webhook URL> 对应 /buglinkdiscord <Webhook URL>

权限节点

• bugreport.admin - 允许玩家管理 Bug 报告。
• bugreport.notify - 接收新 Bug 报告的通知。
• bugreport.archived - 允许玩家访问已归档的报告。
• bugreport.settings - 允许玩家访问和修改插件设置。
• bugreport.list - 允许玩家访问报告列表。
• bugreport.use - 允许玩家使用 /bugreport 命令。
• bugreport.archive - 允许玩家归档报告。
• bugreport.delete - 允许玩家删除报告。

🔧集成与支持

Plan 支持

Bug Report 现已支持 Plan API。只需在 Spigot 服务器上安装 Plan，插件便会自动完成所有设置。

PlaceholderAPI 支持

Bug Report 支持 PlaceholderAPI，当前可用的占位符有：

• %bugreports_totalBugReports% - 返回 Bug 报告总数。
• %bugreports_totalArchivedBugReports% - 返回已归档的报告总数。
• %bugreports_totalNonArchivedBugReports% - 返回未归档的报告总数。

自定义 GUI 支持（Beta）

现在你可以自定义报告详情 GUI 的样式。通过编辑 custom_bug_report_details_GUI.yml 文件即可实现。请注意，此功能目前处于 Beta 测试阶段，可能会存在一些问题。

配置文件要点：

• 槽位（slot）从 0 开始，最大值取决于 guiSize。
• 有效的 bugReportItem 类型包括：BugReporter, BugReportUUID, BugReportWorld, BugReportMessage, BugReportCategory, BugReportStatus, BugReportTimestamp, BugReportLocation, BugReportGamemode, BugReportArchive, BugReportBack, BugReportDelete, BugReportServerName。
• 部分物品可以设置自定义头颅纹理（texture），纹理值可从 minecraft-heads.com 获取。
• 只有 BugReportStatus 可以接受材质数组，其他类型则不行。
• 对于 BugReporter 类型，可以使用 %player_texture% 来显示玩家皮肤。

✨配置与文件

主要配置文件示例

以下为 config.yml 中的部分关键配置选项：

webhookURL: https://discord.com/api/webhooks/
enableDiscordWebhook: false
language: en_US
serverName: "My Server"
max-reports-per-player: 25 # 0 表示无限制
bug-report-cooldown: 0 # 0 表示禁用冷却
databaseType: local # 可选 "mysql" 或 "local"

其他配置项包括：

• Discord 嵌入消息的颜色、标题、脚注和字段。
• 是否启用分类选择 GUI 或标签补全。
• 报告类别和状态的自定义列表。
• BungeeCord 消息传递设置。

语言文件

插件的语言文件可在 GitHub 仓库查看

https://github.com/ItsLeon15/Bug-Reports/tree/main/src/main/resources/languages

❓其他信息

数据统计

Bug Report 使用 bStats 收集匿名的服务器使用统计。如果你希望禁用此功能，可以编辑 plugins/bStats/config.yml 文件。

支持与反馈

如果需要任何支持或有新功能建议，欢迎加入 Discord 社区：

https://discord.gg/jXsV3xQJD4

下载里程碑

• 500 次下载：已完成！
• 1,000 次下载：已完成！
• 2,000 次下载：已完成！