Chomagerie

Chomagerie is a Fabric mod that adds an automatic item refill system using shulker boxes stored in a player's inventory or ender chest.

The mod detects when an item stack is fully consumed through normal gameplay and automatically refills it from available shulker boxes, improving building and survival workflows without requiring manual inventory management.

Features

Automatic Item Refill

• Automatically refills an item stack when it is fully consumed (block placement, item usage, etc.)
• Searches for matching items inside shulker boxes
• Refills directly into the emptied inventory slot
• Only triggers on active item usage (not on manual inventory manipulation)

Smart Search Logic

• Prioritizes the player inventory before checking the ender chest
• Prevents unnecessary refills if the item already exists elsewhere in the inventory
• Respects vanilla stack size limits when refilling items

Server-Side Design

• Designed primarily for server-side usage
• Clients must install the mod to use its features
• Fully compatible with Fabric-based environments

Client Configuration

Players can enable or disable the refill system using:

• Integrated ModMenu interface
• In-game commands
• Configuration file

Requirements

• Minecraft 1.21+
• Fabric Loader (latest recommended version)
• Fabric API
• ModMenu (optional, for graphical configuration)
• Cloth Config (optional, for configuration screens)

Installation

1. Download the mod JAR file
2. Place it in the mods/ directory of your Fabric server or client
3. Ensure Fabric API is installed
4. Restart the game or server

Usage

1. Store one or more shulker boxes (any color) in your inventory or ender chest
2. Fill the shulker boxes with items
3. Use items normally during gameplay
4. When a stack is fully consumed, it is automatically refilled from the first shulker box containing the same item

Example

• Player holds a stack of 64 stone blocks
• A shulker box contains additional stone blocks
• The stack is fully placed
• A new stack of stone is automatically refilled into the same slot

Commands

/chomagerie shulkerrefill toggle
/chomagerie shulkerrefill enable
/chomagerie shulkerrefill disable
/chomagerie shulkerrefill status

Configuration

Configuration file: config/chomagerie.json

Available options:

• enabled — Enables or disables the refill system
• showRefillMessages — Enables or disables refill messages

License

This project is distributed under an All Rights Reserved license.

• The source code is publicly available on GitHub for transparency and contribution purposes.
• Inclusion of the mod in modpacks is explicitly permitted, provided proper attribution is given.
• Redistribution, modification, or reuse of the source code is not permitted.
• Contributions are accepted via pull requests on the official repository, without granting any right to fork or redistribute the code.

Contributing

Pull requests and issues are welcome.
Please provide clear descriptions and reproduction steps when reporting bugs.