Material Preparer

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

| 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