StackRefill

Stack Refill

Automatic stack and gear refilling for Minecraft.
Keep building, mining, fighting, and exploring without constant inventory interruptions.

---

What is Stack Refill?

Stack Refill is a lightweight Quality of Life mod that automatically replaces used-up item stacks, broken tools, armor pieces, and off-hand items from your inventory.

It helps keep your hotbar and equipment ready, so you can continue playing without stopping to manually move items around.

---

Why Players Install Stack Refill

• Automatically refills used-up stacks from your inventory.
• Replaces broken tools when another matching tool is available.
• Refills armor slots and off-hand items.
• Helps builders, miners, fighters, farmers, and survival players.
• Reduces inventory interruptions during long play sessions.
• Includes useful warnings, notifications, HUD counters, and optional sounds.

---

Feature Highlights

Automatic Stack Refill

When the last item in a stack is used, Stack Refill searches for a matching item and moves it into the same slot automatically.

Main Hand, Off-Hand, Armor, and Tools

The mod can refill the main hand, off-hand, armor slots, and tools when they break.

Configurable Search Priority

Choose how Stack Refill searches for replacements:

• Inventory first
• Hotbar first

Keep Slot Mode

Keep Slot mode keeps selected hotbar slots filled passively whenever matching items are available.

Item Blacklist

Add specific items to the blacklist if you do not want them to be refilled automatically.

Low Stock Warning

Get an actionbar warning when only one matching stack remains.

Refill Notifications

A clean actionbar notification can appear whenever a refill happens.

HUD Counter

When stock is low, Stack Refill can display a small counter on the hotbar slot.

Optional Refill Sound

Enable or disable a small sound effect when a refill happens.

---

Configuration

Stack Refill includes an in-game configuration screen.

Default config keybind:

R

The keybind can be changed from Minecraft’s controls menu.

Configurable options include:

• Main hand refill
• Off-hand refill
• Armor refill
• Tool replacement
• Search priority
• Item blacklist
• Keep Slot mode
• Low stock warning
• Refill notifications
• HUD counter
• Optional refill sound
• Server-side feature restrictions

---

Supported Versions

• Minecraft: 1.21.1
• Loaders: Forge, NeoForge
• Java: 21+
• Dependencies: None

Check the Files tab for the correct build for your loader.

---

Server-Side Control

Stack Refill includes server-side controls for multiplayer servers and modpacks.

Server administrators can:

• Force-disable specific features
• Restrict refill behavior
• Control which client-side options are allowed

---

Compatibility Notes

• Designed to be lightweight and modpack-friendly.
• Does not create items or give free resources.
• Only moves matching items that already exist in the player’s inventory.
• No external dependencies required.
• Recommended for both singleplayer and multiplayer modpacks.

---

Quick Install

1. Install Forge or NeoForge for Minecraft 1.21.1.
2. Use Java 21 or newer.
3. Place the Stack Refill jar file in your mods folder.
4. Start the game.
5. Press R in-game to open the configuration screen.

---

FAQ

Does Stack Refill work in multiplayer?

Yes. Stack Refill can work in multiplayer, but some features may be restricted by the server.

Does the mod create free items?

No. Stack Refill only moves matching items that already exist in your inventory.

Can I disable refill for specific items?

Yes. You can add items to the blacklist.

Can it refill tools?

Yes. Tools can be replaced automatically when they break, if a matching replacement is available.

Can it refill armor?

Yes. Armor slots can be refilled when armor breaks, if replacement armor is available.

What is Keep Slot mode?

Keep Slot mode keeps selected hotbar slots filled whenever possible. It is especially useful for building with many stacks of the same block.

---

Keep your slots filled. Keep your gameplay moving.
Stack Refill is a simple utility mod for smoother Minecraft sessions.