Material Preparer
一个 Minecraft Fabric 模组,帮助你自动收集和组织材料。
[!WARNING]
本模组为客户端模组,理论上无需在服务器端安装。然而,由于其辅助性质较强,部分服务器可能会禁止使用。
使用前请确保服务器允许使用此类功能,以免被封禁。
因使用本模组导致的任何封禁、损失或法律纠纷,均由使用者自行承担,模组作者概不负责。
功能
? 智能物品收集
- 配置所需物品列表,并自动从附近的箱子中收集
- 支持精准移动,仅取用所需数量
- 可忽略背包中已有的物品,仅收集缺失部分
?️ 容器探索
- 自动探索附近的容器并缓存物品信息
- 支持黑名单标记,跳过不需要的容器
- 支持输出容器标记——当背包满时自动存入物品
? 多种导入方式
- 从 Litematica 结构文件导入物品列表
- 游戏内文件选择界面,支持子文件夹浏览
- CSV 格式存储,便于手动编辑
⚡ 可配置的操作速度
? 调试可视化
- 在容器周围显示调试边界框
- 不同颜色区分不同类型的容器
- 轻松查看已探索的容器
安装
- 安装 Fabric Loader 和 Fabric API
- 安装 Mod Menu 和 YACL
- 将模组的
.jar 文件放入 mods 文件夹
使用指南
配置物品列表
- 打开 Mod Menu
- 找到 Material Preparer 并点击“Configure”
- 在“Item List”类别中添加所需的物品和数量
- 点击 Save
收集物品
- 设置好你的物品列表
- 确保附近有装有你需要物品的箱子
- 按下“Collect Items”
- 模组将自动打开附近的箱子并收集物品
从 Litematica 导入
- 将你的
.litematic 结构文件放入 schematics 文件夹
- 打开配置界面
- 在“Item List”类别中找到“Load item list from Litematica”
- 在文件选择界面中选择要加载的结构文件
- 点击“Load”按钮
标记容器
黑名单:
- 将准星对准你想标记的箱子
- 按下“Toggle Blacklist”
- 再次按下取消标记
输出容器:
- 将准星对准你想用作输出的箱子
- 按下“Toggle Output Container”
- 当背包满时,物品将自动存入输出容器
配置
常规设置
| 选项 |
描述 |
默认值 |
| Minimum Click Interval |
容器点击之间的最小间隔(刻),0 = 无限制 |
0 |
| Always Quick Move |
是否始终使用 Shift+点击进行快速移动 |
Disabled |
| Ignore Existing Items |
是否仅收集背包中缺失的物品 |
Disabled |
容器管理
| 操作 |
描述 |
| Toggle Blacklist |
添加/移除目标方块到黑名单 |
| Toggle Output Container |
设置/取消设置目标方块为输出容器 |
| Clear All Marks |
清除所有容器标记 |
调试
| 选项 |
描述 |
默认值 |
| Show Debug Borders |
是否在容器周围显示调试边框 |
Disabled |
按键绑定
所有按键绑定均可在配置界面中自定义。
| 功能 |
默认按键 |
| Open Configuration Interface |
Unbound |
| Explore All Nearby Containers |
Unbound |
| Collect Items |
Unbound |
| Load Item List from Litematica |
Unbound |
| Load Item List from CSV |
Unbound |
| Open Recent Crafting Table |
Unbound |
| Toggle Debug Borders |
Unbound |
| Toggle Always Quick Move |
Unbound |
| Toggle Ignore Existing Items |
Unbound |
| Toggle Blacklist |
Unbound |
| Toggle Output Container |
Unbound |
| Clear All Marks |
Unbound |
文件位置
- 配置文件:
config/material_preparer/config.json5
- 物品列表:
config/material_preparer/item_list.csv
- 结构目录:
schematics/
项目文档
想了解更多的实现细节、架构和未来计划吗?请查阅 项目文档。
支持版本
- Minecraft 1.21.1, 26.2
- Fabric Loader
依赖项
- Fabric API
- Mod Menu
- YACL (Yet Another Config Lib) v3
AI 披露
图标、文档、部分代码和翻译由 AI 生成。
许可证
MIT License
Material Preparer
A Minecraft Fabric mod that helps you automatically collect and organize materials.
[!WARNING]
This mod is a client-side mod and theoretically does not require server installation. However, due to its strong assistant nature, some servers may prohibit its use.
Before use, make sure that the server allows the use of such features to avoid being banned.
Any bans, losses, or legal disputes resulting from the use of this mod are not the responsibility of the mod author.
Features
? Smart Item Collection
- Configure a list of required items and automatically collect them from nearby chests
- Supports precise movement, taking only the needed quantity
- Can ignore items already in your inventory, collecting only what's missing
?️ Container Exploration
- Automatically explores nearby containers and caches item information
- Supports blacklist marking to skip unwanted containers
- Supports output container marking – automatically stores items when inventory is full
? Multiple Import Methods
- Import item lists from Litematica schematic files
- In-game file selection interface with subfolder browsing support
- CSV format storage for easy manual editing
⚡ Configurable Operation Speed
- Adjustable container click interval
- Prevents issues caused by clicking too quickly
? Debug Visualization
- Displays debug bounding boxes around containers
- Different colors distinguish different container types
- Makes it easy to see which containers have been explored
Installation
- Install Fabric Loader and Fabric API
- Install Mod Menu and YACL
- Place the mod's
.jar file into the mods folder
Usage Guide
Configuring the Item List
- Open Mod Menu
- Find Material Preparer and click "Configure"
- Add the items and quantities you need in the "Item List" category
- Click Save
Collecting Items
- Set up your item list
- Ensure there are chests nearby containing the items you need
- Press "Collect Items"
- The mod will automatically open nearby chests and collect the items
Importing from Litematica
- Place your
.litematic schematic file into the schematics folder
- Open the configuration interface
- In the "Item List" category, find "Load item list from Litematica"
- Select the schematic file you want to load from the file selection interface
- Click the "Load" button
Marking Containers
Blacklist:
- Aim your crosshair at the chest you want to mark
- Press "Toggle Blacklist"
- Press again to unmark it
Output Container:
- Aim your crosshair at the chest you want to use as output
- Press "Toggle Output Container"
- When your inventory is full, items will be automatically stored in the output container
Configuration
General Settings
| Option |
Description |
Default |
| Minimum Click Interval |
Minimum interval between container clicks (ticks), 0 = no limit |
0 |
| Always Quick Move |
Whether to always use Shift+click for quick movement |
Disabled |
| Ignore Existing Items |
Whether to collect only items missing from inventory |
Disabled |
Container Management
| Action |
Description |
| Toggle Blacklist |
Add/remove the targeted block from the blacklist |
| Toggle Output Container |
Set/unset the targeted block as output container |
| Clear All Marks |
Clear all container marks |
Debug
| Option |
Description |
Default |
| Show Debug Borders |
Whether to display debug borders around containers |
Disabled |
Keybindings
All keybindings can be customized in the configuration interface.
| Function |
Default Key |
| Open Configuration Interface |
Unbound |
| Explore All Nearby Containers |
Unbound |
| Collect Items |
Unbound |
| Load Item List from Litematica |
Unbound |
| Load Item List from CSV |
Unbound |
| Open Recent Crafting Table |
Unbound |
| Toggle Debug Borders |
Unbound |
| Toggle Always Quick Move |
Unbound |
| Toggle Ignore Existing Items |
Unbound |
| Toggle Blacklist |
Unbound |
| Toggle Output Container |
Unbound |
| Clear All Marks |
Unbound |
File Locations
- Configuration file:
config/material_preparer/config.json5
- Item list:
config/material_preparer/item_list.csv
- Schematics directory:
schematics/
Project Documentation
Want to learn more about implementation details, architecture, and future plans? Check out the project documentation.
Supported Versions
- Minecraft 1.21.1, 26.2
- Fabric Loader
Dependencies
- Fabric API
- Mod Menu
- YACL (Yet Another Config Lib) v3
AI Disclosure
The icon, docs, part of the code and translation are generated by AI.
License
MIT License
评论 0
登录后参与评分
还没有评论,来抢沙发吧