Refiller

Smart QuickStack and inventory sorting mod for Fabric 1.21.9. Transfer matching items to nearby containers and sort inventories with multiple modes.

Features

QuickStack

• Keybind (K): Press K to quick-stack items into nearby containers
• GUI Button: "↓" button in player inventory screen
• Smart Transfer: Automatically finds and fills matching containers
• Server-safe: Works on servers with or without the mod installed

Inventory Sorting

• Multiple Sort Modes: Name (alphabetical) and Category (grouped)
• Sort Buttons: Dedicated buttons in inventory and container screens
• Right-Click: Change sort mode on the fly
• Double-Click: Double-click empty slots to sort
• Middle-Click: Middle-click empty slots to sort
• Smart Compacting: Automatically stacks similar items before sorting
• Hotbar Protection: Sorting ignores hotbar slots (9-36 only)

Configuration

• In-Game Config: Via Mod Menu + Cloth Config
• Flexible Settings: Range, behavior, sounds, sort modes, and more
• File-Based: config/refiller.json

Configuration

Default config location: ./config/refiller.json

{
  "enabled": true,
  "range": 6,
  "rangeY": 3,
  "ignoreHotbar": true,
  "allowEmptyDeposit": false,
  "playSound": true,
  "showToast": true,
  "sortMode": "NAME",
  "requireModifierToScroll": false,
  "enableDoubleClickSort": true,
  "sortHighlightedItem": true,
  "fallbackOpenContainerOnly": true
}

Config Options

QuickStack Settings

• enabled - Enable/disable the mod
• range - Horizontal search radius (X/Z) for container detection
• rangeY - Vertical search radius (Y) for container detection
• ignoreHotbar - Don't move items from hotbar slots (0-8)
• allowEmptyDeposit - Allow depositing into empty chests (false = only into chests already containing that item)
• playSound - Play chest close sound on successful transfer
• showToast - Show action bar message with transfer count
• fallbackOpenContainerOnly - On servers without the mod, limit to currently open container

Sorting Settings

• sortMode - Current sort mode: NAME (alphabetical) or CATEGORY (grouped)
• requireModifierToScroll - Require holding CTRL to change sort modes with scroll wheel (future feature)
• enableDoubleClickSort - Allow double-clicking empty slots to sort
• sortHighlightedItem - When true, only sort the inventory under cursor; when false, sort both player and container

Optional Dependencies

• Mod Menu - Adds config button to mod list
• Cloth Config - Provides in-game config GUI

These are compileOnly dependencies, so the mod runs fine without them.

Building

./gradlew build

Output: build/libs/refiller-<version>.jar

Installation

1. Install Fabric Loader
2. Install Fabric API
3. Download the latest release from GitHub Releases
4. Place refiller-<version>.jar in your mods/ folder

License

MIT License - see LICENSE file

Roadmap

Completed ✅

• QuickStack keybind and GUI buttons
• Inventory sorting with multiple modes
• Container screen sort buttons
• Double-click and middle-click sorting
• Smart item compacting before sort
• Configurable sort modes (Name, Category)

Planned 🚧

• Additional sort modes (Mod ID, Item ID)
• Whitelist/blacklist item tags
• Fabric Transfer API wrapper (for modded inventory support)
• Custom button textures/icons
• Scroll wheel to change sort modes (with modifier key)