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

1. Install Fabric Loader and Fabric API
2. Install Mod Menu and YACL
3. Place the mod's .jar file into the mods folder

Usage Guide

Configuring the Item List

1. Open Mod Menu
2. Find Material Preparer and click "Configure"
3. Add the items and quantities you need in the "Item List" category
4. Click Save

Collecting Items

1. Set up your item list
2. Ensure there are chests nearby containing the items you need
3. Press "Collect Items"
4. The mod will automatically open nearby chests and collect the items

Importing from Litematica

1. Place your .litematic schematic file into the schematics folder
2. Open the configuration interface
3. In the "Item List" category, find "Load item list from Litematica"
4. Select the schematic file you want to load from the file selection interface
5. Click the "Load" button

Marking Containers

Blacklist:

1. Aim your crosshair at the chest you want to mark
2. Press "Toggle Blacklist"
3. Press again to unmark it

Output Container:

1. Aim your crosshair at the chest you want to use as output
2. Press "Toggle Output Container"
3. When your inventory is full, items will be automatically stored in the output container

Configuration

General Settings

Container Management

Debug

Keybindings

All keybindings can be customized in the configuration interface.

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

License

MIT License