这是什么?
你的社区正在建设一个大型工程。每个人都需要知道缺少哪些材料、谁在采集什么、进度如何,而无需 @ 管理员或打开电子表格。
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,模组会将完整清单发布到频道并 持续编辑同一条消息:一个带有进度条、? 库存和 ⛏ 认领状态的实时看板。无需机器人或额外进程。
安装
请使用与你的 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 的 [✓ 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 的按钮会自动处理此逻辑。
HUD(客户端模组)
| 按键 |
操作 |
J |
切换 HUD 显示 |
Shift+J |
打开配置界面(也可通过 Mod Menu 或可重绑定的按键访问) |
K |
循环切换焦点所在的清单(当有多个活动清单时) |
所有按键均可在 选项 → 控制设置 → 按键绑定 下的
MankeList 类别中重新绑定,以防 J/K 与其他模组冲突。
待处理行会显示携带 + 库存 / 所需数量,并与你自己的物品栏(包括潜影盒和包裹内容)进行对比;通过红/黄/绿颜色区分;已勾选的行会折叠为 ✓,认领项渲染为 @Name。可按数量排序或排列完全自定义的顺序(支持拖拽、可搜索)。角标、缩放比例、图标、背景和行数均可在游戏中配置。
Discord 看板
- 在你的 Discord 频道中:编辑频道 → 集成 → Webhook → 新建
webhook,复制其 URL。
- 将其放入
config/mankelist-server.json → "discordWebhookUrl"。
- 重启服务器。模组会发布该看板,此后每当列表发生变化时,它都会原地更新(最多每 10 秒一次)。
服务端配置
服务端读取 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 的材料列表;从零编写,未复制任何代码。
What is it?
Your community is building something big. Everyone needs to know what
materials are missing, who is farming what, and how far along you are,
without pinging an admin or opening a spreadsheet.
MankeList keeps ONE shared material list on the server that everybody
works against:
- ? Import straight from a
.litematic: /ml import parses the
schematic on the server and builds the list (no external tools).
- ✅ Collaborative checks: anyone can
/ml check a finished material;
the whole server sees the announcement.
- ? Manke's nudge (opt-in): players who
/ml follow get a private
"Ooh ooh! Manke sees you carry enough Hopper (48 / 18). Check it off?
[✓ Yes]" when their inventory covers a pending material. Works for players
without the mod too (it's plain clickable chat).
- ⛏ Claims:
/ml claim obsidian tells everyone you are on it. When it
gets checked off, the name sticks as who got it.
- ? Stocking areas: mark the drop-off chest room with
/ml stockarea add and the server counts what is already stored (nested
shulkers included). Progress becomes fine-grained: 190k obsidian in
chests counts, even before anyone checks the item off.
- ?️ Optional client HUD: a Litematica-style overlay with live
carrying + stocked / needed counts against your own inventory, custom
ordering, and multi-list cycling. Players without the client mod lose
nothing but the overlay.
- ? Discord board built in: paste a webhook URL in the config and the
mod posts the full list to a channel and keeps editing the same
messages: a live board with progress bars, ? stock and ⛏ claims. No bot,
no extra process.
Installation
Use the jar matching your Minecraft version: 1.21 / 1.21.1 or 26.3.
Minecraft 26.3 needs Java 25 and Fabric Loader 0.19.5 or newer; 1.21 uses Java 21.
Downloads are available on Modrinth and
GitHub Releases.
Keep config/mankelist/ and the mankelist-*.json configuration files when updating.
Saved lists, checks, claims, followers and stocking areas are retained. Active lists
are restored as the dedicated server starts.
Server (required): drop mankelist-x.y.z.jar + Fabric API
into the server's mods/ folder. That's it: everything below works with a
vanilla client.
Client (optional, for the HUD): install the same jar client-side. The
server streams the list to modded clients only (Servux-style custom payloads);
vanilla clients are never sent anything.
Quick start
/ml import my_build.litematic ← builds + activates the list from the schematic
/ml follow ← opt into Manke's inventory nudges
/ml stockarea add 100 60 100 120 70 120 ← the chest room where materials get dropped
Then farm away: check things off by clicking Manke's [✓ Yes], or manually
with /ml check <material>.
Commands
Everyone:
| Command |
What it does |
/ml or /ml status |
List(s) with progress, stock and claims |
/ml check <material> |
Check a material off (announced server-wide) |
/ml uncheck <material> |
Oops button |
/ml claim <material> |
Tell everyone you are farming it |
/ml have <amount> <material> |
Report partial progress ("I have 5,000 of the azaleas so far"): claims it for you and counts toward the progress bars |
/ml unclaim <material> |
Release your claim (OPs can release anyone's) |
/ml follow / /ml unfollow |
Opt in/out of Manke's inventory nudges |
/ml stock |
Compact report of what is already in the stocking areas |
/ml lists |
Active lists, saved lists and available list files |
OPs (permission level 2):
| Command |
What it does |
/ml import <file.litematic> |
Parse a schematic into a list and activate it |
/ml load <list> |
(Re)read a list file and activate it (resets checks) |
/ml switch <list> |
Re-activate a saved list keeping its progress |
/ml unload <list> |
Deactivate (progress kept for later /ml switch) |
/ml reset [list] |
Uncheck everything |
/ml stockarea add <x1 y1 z1> <x2 y2 z2> |
Add a stocking area (your current dimension) |
/ml stockarea list / clear |
Inspect / remove stocking areas |
Materials match by short id (emerald_block), full id or display name, with
real tab-completion. Several lists can be active at once; when a material
exists in more than one, disambiguate as list/material (e.g.
/ml check xpfarm/hopper): the autocomplete and Manke's buttons do this for
you.
The HUD (client mod)
| Key |
Action |
J |
Toggle the HUD |
Shift+J |
Open the config screen (also via Mod Menu or a rebindable key) |
K |
Cycle the focused list (when several are active) |
All keys are rebindable in Options → Controls → Key Binds under the
MankeList category, in case J/K clash with your other mods.
Pending rows show carrying + stocked / needed against your own inventory
(shulker and bundle contents included) with red/yellow/green coloring; checked
rows collapse to a ✓ and claims render as @Name. Sort by amount or arrange a
fully custom order (grab & drop, searchable). Corner, scale, icons, background
and line count are all configurable in-game.
Discord board
- In your Discord channel: Edit channel → Integrations → Webhooks → New
webhook, copy its URL.
- Put it in
config/mankelist-server.json → "discordWebhookUrl".
- Restart. The mod posts the board and from then on edits it in place
whenever the list changes (at most once every 10 s).
Server config
The server reads config/mankelist-server.json:
| Field |
Default |
Meaning |
statePath |
config/mankelist/state.json |
Where the shared state lives (auto-created). If a legacy schemlist/MCDR layout (../config/schemlist/state.json) already exists, it is reused |
importDir |
schematics |
Folder scanned for .litematic files by /ml import (auto-created; syncmatics is used if that folder already exists) |
discordWebhookUrl |
"" |
Discord webhook for the built-in board (empty = off) |
pollSeconds |
5 |
How often the state file's mtime is checked |
promptsEnabled |
true |
Master switch for Manke's nudges |
scanSeconds |
30 |
Inventory scan interval for the nudges |
promptCooldownSeconds |
600 |
Per player+material nudge cooldown |
stockScanSeconds |
60 |
Stocking-area container scan interval |
List file format
Lists are plain JSON next to the state file: trivially scriptable:
{
"name": "xpfarm",
"source": "xpfarm.litematic",
"blocks": [
{ "id": "minecraft:obsidian", "display": "Obsidian", "count": 189746, "done": false }
]
}
The state file adds claim (who) and stocked (how many delivered) per
entry, and an active array. External tools can read or write these files;
the server picks changes up within pollSeconds.
Compatibility
- Minecraft 1.21 / 1.21.1 and 26.3, with the matching Fabric API.
Build all supported jars with
python3 tools/multiversion.py (JDK 21 and 25).
- Old clients keep working against newer servers (versioned network channels).
- The state format is compatible with the schemlist MCDR plugin, if you come
from that ecosystem.
License
MIT. HUD layout inspired by Litematica's material list; written
from scratch, no code copied.
评论 0
登录后参与评分
还没有评论,来抢沙发吧