Material_Plan

一个面向 Minecraft 仓库管理与材料统计的单页网页工具，用于快速查询物品存放位置、生成材料收集清单，并维护全物品位置对照表。

在线访问：

Open Material_Plan System

项目简介

Material_Plan 是一个纯前端的 Minecraft 协同仓库管理工具。项目主要由 index.html 组成，可直接在浏览器中打开使用，也可以通过 GitHub Pages 在线访问。

当前页面名称为“我的世界 · 协同仓库管家”，主要用于：

• 查询物品所在仓库编号、区域或位置；
• 粘贴或导入材料表，生成缺失材料清单；
• 自动换算材料所需的盒、组、个数量；
• 导出材料计划 Excel 文件；
• 导入、编辑和导出全物品位置对照表；
• 在本地浏览器中保存对照表数据；
• 支持深色模式和手机端浏览。

核心功能

1. 物品速查

在搜索框中输入物品名称后，可以快速查询该物品对应的仓库位置。

支持内容包括：

• 物品名称搜索；
• 匹配对应编号；
• 显示区域或备注信息；
• 未找到时给出提示。

2. 材料计划生成器

材料计划生成器可以根据原理图或投影类材料表生成收集清单。

目前支持两种输入方式：

1. 手动粘贴 TXT 文本内容；
2. 点击“导入 TXT”按钮导入 .txt 文件。

注意：当前材料计划导入只支持 TXT 文件，不支持 Excel、CSV 或其他格式。

支持的材料表格式示例：

+----------+--------+---------+-----------+
| 原理图'Unnamed'材料列表（1/1区域）       |
+----------+--------+---------+-----------+
| Item     |  Total | Missing | Available |
+----------+--------+---------+-----------+
| 石头     |    128 |     128 |         0 |
| 末影珍珠 |     32 |      32 |         0 |
+----------+--------+---------+-----------+

程序会读取以 | 分隔的材料行，并主要使用：

• Item：物品名称；
• Missing：缺失数量。

生成结果会包含：

• 物品名称；
• 缺失数量；
• 盒组个换算结果；
• 对应仓库编号；
• 对应区域信息。

3. 盒组个换算规则

材料计划会根据物品名称自动判断堆叠数量，不再全部按 64 堆叠计算。

当前规则如下：

普通物品

默认按 64 堆叠计算。

• 1 组 = 64 个
• 1 盒 = 27 组 = 1728 个

16 堆叠物品

识别到常见 16 堆叠物品时，按 16 个一组计算。

当前内置关键词包括：

• 末影珍珠
• 雪球
• 鸡蛋
• 旗帜
• 告示牌
• 悬挂式告示牌
• 蜂蜜瓶

换算规则：

• 1 组 = 16 个
• 1 盒 = 27 组 = 432 个

不可堆叠物品

识别到不可堆叠物品时，按 1 个一组计算。

当前内置关键词包括：

• 水桶、岩浆桶、熔岩桶、牛奶桶、细雪桶
• 鱼桶、河豚桶、鳕鱼桶、鲑鱼桶、热带鱼桶、蝌蚪桶
• 矿车、船、床、潜影盒
• 剑、镐、斧、锹、锄
• 头盔、胸甲、护腿、靴子
• 弓、弩、三叉戟、钓鱼竿、剪刀、打火石
• 盾牌、鞍、马铠、附魔书、药水

换算规则：

• 1 组 = 1 个
• 1 盒 = 27 个

例如：

• 潜影盒 27 会换算为 1盒
• 潜影盒 28 会换算为 1盒1组
• 末影珍珠 432 会换算为 1盒

如果发现有遗漏的 16 堆叠或不可堆叠物品，可以继续补充关键词列表。

4. 全物品位置对照表

全物品位置对照表用于维护物品和仓库位置之间的映射关系。

支持功能包括：

• 手动新增行；
• 编辑已有数据；
• 删除单行；
• 清空当前表；
• 导入 Excel 对照表；
• 导出当前表为 Excel；
• 拖拽 Excel 文件上传；
• 自动保存到浏览器本地存储。

注意：全物品位置对照表仍然支持 Excel 导入和导出。材料计划的 TXT-only 限制不会影响该功能。

5. Excel 导出

材料计划生成后，可以导出 Excel 清单，方便分工、收集或归档。

导出的清单会包含材料名称、缺失数量、换算结果和仓库位置信息。

6. 本地保存

项目使用浏览器本地存储保存对照表数据。

这意味着：

• 刷新页面后数据仍会保留；
• 数据保存在当前浏览器中；
• 更换浏览器或清理浏览器数据后，本地数据可能丢失；
• 建议定期导出 Excel 作为备份。

7. 手机端适配

页面已针对手机端做了基础适配，包含：

• 顶部区域自适应；
• 卡片单列显示；
• 按钮区域自动换行；
• 表格横向滚动；
• 输入框适配移动端操作；
• 深色模式支持。

在手机上查看较宽表格时，可以左右滑动表格区域查看完整内容。

使用方式

在线使用

打开以下链接即可使用：

https://MilkyPark142008.github.io/Material_Plan/

本地使用

下载项目后，直接用浏览器打开：

index.html

无需安装后端服务。

技术说明

项目为纯前端单页应用，主要使用：

• HTML
• CSS
• JavaScript
• Vue 3
• SheetJS / xlsx-js-style

主要文件：

README.md
index.html

当前限制

• 材料计划导入目前只支持 TXT 文件；
• 材料计划解析依赖 | 分隔的表格文本格式；
• 物品堆叠数量通过关键词识别，可能需要根据实际服务器物品名称继续补充；
• 对照表数据默认保存在浏览器本地，建议定期导出备份；
• 材料替换功能暂未实现。

后续计划

后续可以继续扩展：

• 材料替换功能；
• 更完整的特殊堆叠物品识别；
• 更灵活的 TXT 格式解析；
• 多套仓库数据切换；
• 更完善的移动端交互体验。

License

该项目当前未声明具体开源协议。如需公开分发或协作开发，建议后续补充 License 文件。