LiteItemList

LiteItemListFabric

一款服务端 Fabric 模组，支持多人协作的材料准备。

功能与用法

该模组提供了命令和图形界面来创建、管理和操作材料准备任务。

任务管理

/liteitemlist task <cancel|join|leave|list|new|switch>

或者手持烟花火箭，潜行并左键点击任意方块，即可打开图形界面菜单（箱子风格）。

创建任务

/liteitemlist task new <project_name> <file_name>

• project_name：由你决定；
• file_name：用于创建任务的 litematica 文件。

LiteItemListFabric 将读取指定的 litematica 文件（通过 syncmetica 上传）。

取消/加入/离开/切换任务

/liteitemlist task <cancel|join|leave|switch> <project_name>

• project_name：要取消的任务。

补充说明：

• 只有创建者或管理员可以取消任务。
• “切换到任务”意味着你当前正在执行该任务，就像切换频道一样。

列表查看与操作

通过 Shift + 左键 点击任务面板中的任务图标打开任务材料列表界面，或使用命令：

/liteitemlist list

当你有正在操作的任务时，可以手持烟花火箭潜行并左键点击任意方块，直接打开任务材料列表界面。

材料列表功能

• 浏览所有所需材料，包括总需求、剩余数量、备注和认领人信息；
• 单击材料图标认领或取消认领材料准备工作；
• Shift + 点击查看物品的详细信息；
• 内置过滤器，可按认领状态、完成状态和标记标签对材料进行排序；
• 支持游戏内单位计量的数量换算。

NPC 虚拟存储管理

该模组提供了可生成的存储虚拟 NPC，用于任务材料的存储：

• 通过材料列表顶部栏中的玩家头颅图标进入虚拟管理界面；
• 创建绑定到特定任务的自动命名虚拟 NPC；
• 点击虚拟图标生成或传送虚拟到你的当前位置；
• 一键命令召唤所有任务存储虚拟；
• 在界面提示中查看虚拟的在线状态、库存使用情况和存储容量。

多人通讯

内置独立的任务内部聊天频道：

• 将与任务相关的消息与全局聊天隔离；
• 避免无关玩家被大量任务消息打扰；
• 所有任务参与者之间实时同步消息。

服务器管理员须知

环境要求

• Minecraft：1.21.4
• Fabric Loader：0.18.4 或更高版本
• 依赖：fabric-api、carpet 1.4.161+、syncmatica 0.3.14-sakura.4+

文件将保存在 .\liteitemlist 文件夹下。

开发

前置条件

• Java 21 或更高版本
• Gradle

从源码构建

1. 克隆仓库
2. 在项目目录中打开终端
3. 运行 ./gradlew build
4. 构建好的模组将在 build/libs/ 中

许可证

本项目采用 CC0 1.0 许可证。

贡献

欢迎贡献代码！请随时提交 Pull Request。

联系方式

如有任何问题或疑虑，请在 GitHub 仓库上提交 issue。