MankeList

模组

· 作者 TVTvirus

一个用于社区建筑共享的材质列表:实时 HUD、聊天清单、领地声明、库存追踪以及自动更新的 Discord 面板。只需一个 jar 文件,客户端部分为可选。

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API

最新 1.0.1+26.3 · 26.3 · Fabric

一键开服(送7天)

这是什么?

你的社区正在建设一个大型工程。每个人都需要知道缺少哪些材料、谁在采集什么、进度如何,而无需 @ 管理员或打开电子表格。

MankeList 在服务端维护一份共享的材料清单,供所有人协作完成:

  • ? 直接从 .litematic 导入:使用 /ml import 解析服务器上的结构图并生成清单(无需外部工具)。
  • ✅ 协作标记:任何人都可以执行 /ml check 来标记某项材料已完成;整个服务器都会看到该公告。
  • ? Manke 的提醒(可选):执行 /ml follow 的玩家会收到一条私聊 "Ooh ooh! Manke sees you carry enough Hopper (48 / 18). Check it off? [✓ Yes]",当他们的背包中已有足够的待采材料时触发。即使玩家没有安装模组也能正常工作(这是普通的可点击聊天消息)。
  • ⛏ 认领:执行 /ml claim obsidian 告诉所有人你正在采集黑曜石。当该项被标记完成后,你的名字将作为 获得者 保留记录。
  • ? 存储区域:使用 /ml stockarea add 标记投放箱所在的房间,服务器会统计其中已存放的物品(包括嵌套的界伏盒)。进度变得 更精细: chests 中的 190k 黑曜石会被计入进度,甚至在有人手动标记该项目之前。
  • ?️ 可选客户端 HUD:一种类似 Litematica 的覆盖层,实时显示 携带 + 库存 / 所需 数量,支持自定义排序和多列表切换。未安装客户端模组的玩家仅失去此覆盖层功能,其他方面不受影响。
  • ? 内置 Discord 看板:在配置文件中粘贴 Webhook URL,模组会将完整清单发布到频道并 持续编辑同一条消息:一个带有进度条、? 库存和 ⛏ 认领状态的实时看板。无需机器人或额外进程。
Checking off a material and claiming another, live on the HUD

安装

请使用与你的 Minecraft 版本匹配的 jar 包:1.21 / 1.21.1 或 26.3。 Minecraft 26.3 需要 Java 25 和 Fabric Loader 0.19.5 或更高版本;1.21 使用 Java 21。 下载可在 Modrinth 和 GitHub Releases 获取。

更新时请保留 config/mankelist/ 目录及 mankelist-*.json 配置文件。 已保存的清单、标记、认领、关注者及存储区域将被保留。活动清单将在专用服务器启动时自动恢复。

服务端(必需):将 mankelist-x.y.z.jar 和 Fabric API 放入服务端的 mods/ 文件夹。仅此而已:以下所有功能均可通过原版客户端使用。

客户端(可选,用于 HUD):在同一客户端侧安装相同的 jar 包。 服务端仅向安装了模组的客户端传输列表数据(采用 Servux 风格的自定义数据包); 原版客户端永远不会收到任何数据。

快速开始

/ml import my_build.litematic     ← 从结构图构建并激活清单
/ml follow                        ← 选择加入 Manke 的背包提醒
/ml stockarea add 100 60 100 120 70 120   ← 材料投放所在的箱子房间坐标
Manke's inventory nudge

然后开始采集:点击 Manke 的 [✓ Yes] 进行标记,或使用 /ml check <material> 手动标记。

命令

所有玩家可用:

命令 功能
/ml 或 /ml status 显示清单进度、库存和认领情况
/ml check <material> 标记某项材料为已完成(全服公告)
/ml uncheck <material> 撤销标记(反悔按钮)
/ml claim <material> 告诉所有人你正在采集该材料
/ml have <amount> <material> 报告部分进度(例如“我目前已有 5,000 丛杜鹃花”):为你认领该项并计入进度条
/ml unclaim <material> 释放你的认领(OP 可释放任何人的认领)
/ml follow / /ml unfollow 选择加入/退出 Manke 的背包提醒
/ml stock 紧凑报告存储区域中已有的物品
/ml lists 活动清单、已保存清单及可用的清单文件

OP(权限等级 2)可用:

命令 功能
/ml import <file.litematic> 将结构图解析为清单并激活
/ml load <list> (重新)读取清单文件并激活(重置所有标记)
/ml switch <list> 重新激活已保存的清单,保留其进度
/ml unload <list> 停用清单(进度保留以便后续 /ml switch)
/ml reset [list] 取消所有标记
/ml stockarea add <x1 y1 z1> <x2 y2 z2> 添加存储区域(基于当前维度)
/ml stockarea list / clear 查看 / 清除存储区域

材料匹配支持短 ID(如 emerald_block)、完整 ID 或显示名称,并提供真实的 Tab 补全。 可同时激活多个清单;若某材料存在于多个清单中,请使用 清单名/材料名 进行区分(例如 /ml check xpfarm/hopper):自动补全和 Manke 的按钮会自动处理此逻辑。

Claiming a material and reporting partial progress Stocking areas counting chest contents as progress

HUD(客户端模组)

The HUD with live inventory counts
按键 操作
J 切换 HUD 显示
Shift+J 打开配置界面(也可通过 Mod Menu 或可重绑定的按键访问)
K 循环切换焦点所在的清单(当有多个活动清单时)

所有按键均可在 选项 → 控制设置 → 按键绑定 下的 MankeList 类别中重新绑定,以防 J/K 与其他模组冲突。

在游戏中使用 Shift+J 调整 HUD

待处理行会显示携带 + 库存 / 所需数量,并与你自己的物品栏(包括潜影盒和包裹内容)进行对比;通过红/黄/绿颜色区分;已勾选的行会折叠为 ✓,认领项渲染为 @Name。可按数量排序或排列完全自定义的顺序(支持拖拽、可搜索)。角标、缩放比例、图标、背景和行数均可在游戏中配置。

Discord 看板

  1. 在你的 Discord 频道中:编辑频道 → 集成 → Webhook → 新建 webhook,复制其 URL。
  2. 将其放入 config/mankelist-server.json → "discordWebhookUrl"。
  3. 重启服务器。模组会发布该看板,此后每当列表发生变化时,它都会原地更新(最多每 10 秒一次)。
游戏中勾选操作实时编辑 Discord 看板

服务端配置

服务端读取 config/mankelist-server.json:

字段 默认值 含义
statePath config/mankelist/state.json 共享状态文件的存放位置(自动创建)。如果已存在旧版 schemlist/MCDR 布局(../config/schemlist/state.json),则复用该文件
importDir schematics /ml import 命令扫描 .litematic 文件的文件夹(自动创建;若该文件夹已存在则使用 syncmatics)
discordWebhookUrl "" 内置看板的 Discord webhook(空字符串表示关闭)
pollSeconds 5 检查状态文件修改时间的频率(秒)
promptsEnabled true Manke 提示功能的总开关
scanSeconds 30 提示功能的物品栏扫描间隔
promptCooldownSeconds 600 每个玩家+每种材料的提示冷却时间
stockScanSeconds 60 库存区容器扫描间隔

列表文件格式

列表是与状态文件同级存储的普通 JSON 文件,便于脚本处理:

{
  "name": "xpfarm",
  "source": "xpfarm.litematic",
  "blocks": [
    { "id": "minecraft:obsidian", "display": "Obsidian", "count": 189746, "done": false }
  ]
}

状态文件为每个条目额外添加了 claim(谁认领)和 stocked(交付了多少)字段,以及一个 active 数组。外部工具可以读取或写入这些文件;服务端会在 pollSeconds 时间内检测到变更。

兼容性

  • Minecraft 1.21 / 1.21.1 和 26.3,需搭配对应的 Fabric API。 使用 python3 tools/multiversion.py 构建所有支持的 jar 包(需要 JDK 21 和 25)。
  • 旧客户端仍能连接至较新的服务端(版本化的网络通道)。
  • 状态格式与 schemlist MCDR 插件兼容,如果你来自该生态体系。

许可证

MIT。HUD 布局灵感源自 Litematica 的材料列表;从零编写,未复制任何代码。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源