
舒适的鹅卵石虫子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(可选,用于指南书) |
快速设置
- 将模组 JAR 文件与其所需依赖一起放入你的
mods/文件夹。 - 启动游戏一次——
config/cozycobblebugmod/config.json和README.md会自动生成。 - 运行
/bugreportsetup webhook <你的 Discord Webhook URL>(需要操作权限等级 2)。 - 运行
/bugreportsetup packname <你的整合包名称>。 - 运行
/bugreportsetup status以确认一切正常。 - 可选:编辑
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 — 公有领域。可自由使用、修改和重新分发。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。