二次开发 付费 闭源 娱乐 [XiaoMengMaid]晓萌女仆——纯插件实现模组”车万女仆“的功能 1.0.0

把「车万女仆」从客户端模组搬到了服务端插件：女仆、椅子家具、棋类对弈、祭坛合成、饰品背包全部服务端实现，玩家用纯净客户端就能进服游玩。

特性​

女仆​

• 原生实体载体：女仆以原版 minecraft:villager 为载体保存身份，AI 由实例 Brain 驱动，支持 Folia 多线程区域调度
• 206 个女仆模型，通过 BetterModel 挂载，客户端零安装
• 工作模式：种田、收割小麦、甘蔗收割、畜牧/养殖等全部移植
• NBT 恢复：女仆完整存档恢复（模型、装备、背包、工作模式、好感度等）
• 跨区域传送 / 载体静音 / 受击粒子过滤：解决了 Folia 多线程下实体同步、音效、粒子的一系列问题

家具与装饰​

• 63 个椅子模型 + 6 件带座位的娱乐家具（野餐垫、电脑、书架、麻将桌……）
• 45 条祭坛配方：原版祭坛多方块结构完整还原
• 椅子/家具放置后有真实碰撞箱，玩家与女仆均可交互

棋类（女仆陪你下棋！）​

• 五子棋 / 中国象棋 / 国际象棋 三种棋盘
• 女仆可自动入座棋盘，与玩家对弈（内置 AI 引擎）
• 同一棋盘互斥入座，防止多人抢位

其他​

• 饰品 / 背包 / 无线 IO：原版模组的装备系统完整移植
• 管理命令 /tlm：模型预览、骨骼调试、棋盘几何标定、召唤女仆等
• 权限节点：xiaomengmaid.admin

版本与兼容性​

请按你的服务端版本选择对应的 XiaoMengMaid-<版本>-mc26.1.2 / -mc26.2 / -mc26.3.jar，只装一个。 开源义务包 XiaoMengMaidLib.jar 通用（api-version 26.1.2），26.1.2/26.2/26.3 都能加载。

点击展开...

安装​

1. 安装 CraftEngine 26.9.2 与 BetterModel 3.6.0；
2. 放入 核心包（按服务端 MC 版本选一个 -mc*.jar）；
3. 放入 开源义务包 XiaoMengMaidLib-*.jar（首次启动会释放全部转换资源到 plugins/CraftEngine、plugins/BetterModel、plugins/XiaoMengMaidLib/runtime）；
4. 冷启动服务器（不支持 /reload、PlugMan、运行中启停）。

升级时请把两个数据目录一起改名（如果从旧版本升级）：

快速上手​

• /tlm model <键> [动画] —— 生成女仆模型预览（方便挑模型）
• /tlm board <id> <surfaceY> <spacing> <pieceSize> … —— 棋盘几何标定
• /tlm count / /tlm clear / /tlm inspect <键> —— 调试辅助
• 召唤女仆：原版模组的召唤流程（祭坛合成 / 电影等）均已移植

已知限制​

• 只支持 STARTUP 冷启动：不支持 /reload、PlugMan、运行中卸载/热重载
• 旧版自定义实体（touhou_little_maid:maid）的存档需要离线迁移后才能使用（仓库内提供迁移工具）
• 椅子/家具物品在物品栏使用统一占位图标（CE 资源包限制，不影响 3D 模型外观）
• 不支持 1.21.x 及更早版本（1.21 系需要另一套 NMS 适配与构建链）

许可与致谢​

• 原作：Touhou Little Maid by TartaricAcid、Snownee
• 美术素材：CC BY-NC-SA 4.0
• 开源义务包 XiaoMengMaidLib：GPL-2.0（转换资产 + 棋类引擎），地址见原帖地址
• 本插件是服务端移植/重写，与原模组无官方关联，原作版权归原作者所有，并且核心代码逻辑完全不同，已和原作者沟通，原作者知晓本项目。

常见问题​

Q：我要一个 26.x 通用的版本，应该装哪一个？ A：开源义务包 XiaoMengMaidLib.jar 是通用的（api-version 26.1.2，26.1.2/26.2/26.3 都能加载）； 但核心包 XiaoMengMaid 没有"通用版"，必须按你的服务端小版本三选一：
不确定服务器是哪一版？看启动日志第一行的 Starting minecraft server version，或问你的服主。 装错版本会在启动或运行时报 NoSuchMethodError / NoSuchFieldError 之类的错误——这不是通用包能解决的， 原因是三个小版本的 NMS 方法签名确实不同（只能各自编译）。
Q：客户端要装模组吗？ A：不用，原版纯净客户端即可。
Q：能 /reload 热重载吗？ A：不能，只支持冷启动（完整重启服务器）。

Q：1.21.x 能用吗？ A：暂不支持（1.21 系需要另一套 NMS 适配与构建链）。