舒适的鹅卵石虫子Mod

舒适的鹅卵石虫子Mod

一个自定义模组,用于允许用户从游戏内发送错误报告到支持服务器中的Discord webhook!

舒适鹅卵石 Bug 模组 — v1.1.0 首个版本

让你的玩家无需离开《我的世界》即可报告 Bug。

报告会以丰富的 Discord 嵌入消息形式发送——包含类别、严重程度、可选的截图以及 mclo.gs 日志链接——直接发送到你服务器的 Webhook。


功能特性

游戏内报告表单 (ModernUI)

  • 按 B 键打开交互式指南,或按 Shift+B 直接跳转到报告表单
  • 指南是一个 5 页的自定义 GUI 教程——无需书本物品
  • 字段:标题、描述、复现步骤
  • 循环切换可配置的类别(游戏玩法、崩溃/冻结、视觉/渲染、性能、物品栏/物品、世界/区块、多人游戏/同步、其他——全部可在配置中自定义)
  • 循环切换四个严重程度级别——低 🟢、中 🟡、高 🟠、严重 🔴——并带有匹配的颜色编码 Discord 嵌入消息
  • 可搜索的受影响模组/数据包/资源包选择器,自动从你已加载的模组、启用的数据包和资源包中填充

Discord 集成

  • 报告会以包含类别与严重程度表情符号、玩家名称、整合包名称、时间戳以及与严重程度匹配的彩色侧边栏的丰富 Discord 嵌入消息形式发布
  • 附加最新截图(按 B 键那一刻捕获)作为嵌入图片
  • 附加游戏日志并私密上传至 mclo.gs——嵌入消息中仅显示链接,原始日志数据不会出现在 Discord 上
  • 每条报告可提及一个或多个 Discord 角色
  • 完全支持论坛频道——每条报告会创建一个新主题,并根据类别自动添加可配置的标签

三步命令完成设置

/bugreportsetup webhook https://discord.com/api/webhooks/...
/bugreportsetup packname 你的整合包名称
/bugreportsetup status

Webhook URL 永远不会存储在 config.json 中——它存放在一个随机命名的隐藏文件中,这样检查其配置文件夹的玩家也无法窃取它。

中继模式(高级/整合包分发者)

部署随附的 Cloudflare Worker(cloudflare-worker/worker.js)以完全避免将 Webhook URL 保留在任何客户端机器上。在 config.json 中添加 relayUrl 和 relaySecret 并指向你的 Worker——无需机器人令牌。

自动数据包和资源包加载顺序控制

直接从 config.json 配置 <gameDir>/datapacks/ 和 <gameDir>/resourcepacks/ 中包的加载顺序——对于随模组附带额外包的整合包非常有用。


前置要求

依赖项 版本
Minecraft 1.21.1
Fabric Loader ≥ 0.19.3
Fabric API 0.116.14+1.21.1
ModernUI-MC 3.13.0.1 (适用于 1.21.1)
owo-lib 0.13.0-alpha.15+1.21(可选,用于指南书 UI)
Lavender 0.1.15+1.21(可选,用于指南书)

快速设置

  1. 将模组 JAR 文件与其所需依赖一起放入你的 mods/ 文件夹。
  2. 启动游戏一次——config/cozycobblebugmod/config.json 和 README.md 会自动生成。
  3. 运行 /bugreportsetup webhook <你的 Discord Webhook URL>(需要操作权限等级 2)。
  4. 运行 /bugreportsetup packname <你的整合包名称>。
  5. 运行 /bugreportsetup status 以确认一切正常。
  6. 可选:编辑 config.json 以自定义角色提及、嵌入颜色、类别等。

配置亮点

键 默认值 描述
roleIds [] 每条报告要提及的 Discord 角色 ID 列表
isForumChannel false 当你的 Webhook 位于论坛频道时设置为 true
forumTagIds {} 将类别名称映射到论坛标签 ID
embedColor "E74C3C" 侧边栏十六进制颜色(不含 #)
allowScreenshot true 允许附带截图
allowLog true 允许附带日志
useMclogs true 将日志上传至 mclo.gs 而非附带原始字节
maxReportsPerHour 5 客户端速率限制(0 = 关闭)
reportingEnabled true 总开关
categories 8 个内置 可自由添加、删除或重命名类别

完整参考文档会在首次启动时写入 config/cozycobblebugmod/README.md。


许可证

CC0-1.0 — 公有领域。可自由使用、修改和重新分发。