Piggy Inventory

A simple yet powerful mod designed to enhance your inventory management experience in Minecraft. Piggy Inventory aims to streamline your interactions with items, tools, and containers.

---

Screenshots

⚠️ Disclaimer

This is a personal project. It comes AS IS and might have issues.

• No Support: Do not expect regular support or bug fixes.
• No Forge Port: There are NO plans to port this mod to Forge/NeoForge.
• Use at your own risk.

Feel free to fork the project or submit a Pull Request if you want to contribute fixes or features!

---

Features

⚡ Automatic Swapping

• Auto Tool Swap: Automatically selects the best tool for the block you are mining.
  • Supports Silk Touch/Fortune preferences (configurable per-ore).
  • Respects enchantments (Efficiency, Unbreaking, etc.).
• Auto Weapon Swap: Automatically switches to your best weapon when attacking.
  • Considers damage, enchantments (Sharpness, Smite, Bane of Arthropods, etc.).
  • Configurable preferences for different target types.

🔄 Auto Refill

• Tool/Weapon Refill: Never stop fighting or mining - broken tools are automatically replaced.
• Food Refill: Eat continuously without opening inventory.
• Smart Matching: Finds the next best item in your inventory automatically.

🎒 Inventory Management

• Inventory Sorting: Sort your inventory or containers instantly with R or Middle Click.
  • Advanced Sorting Engine: A robust, prioritized algorithm that clears mega-stacks and avoids infinite loops.
  • Smart Categorization: Groups items logically (Tools, Weapons, Resources, Food) before applying secondary sorting (Material, Alphabetical).
  • Anti-Glitch Logic: Gracefully handles unswappable items and network latency to prevent the "sorting dance" (ping-ponging items).
  • Multiple algorithms: Smart Category, Alphabetical, Creative Order, Rarity, Type, Material, Color, Tag.
  • Customizable via JSON lists.
• Fast Loot / Deposit:
  • Refined QuickLoot: Improved stability when interacting with large containers or during rapid scrolling.
  • Shift + Scroll: Move matching items between inventories.
  • Ctrl + Scroll: Move ALL items between inventories.
  • Note: This only works when looking at a Container (Chest, Barrel, etc.) to preserve vanilla crouching!
• Slot Locking: Lock inventory slots to prevent accidental sorting or quick-looting.
• Continuous Crafting: Hold your click to craft, trade, or move items repeatedly. No more clicking spam!

---

Controls

You can rebind these keys in the standard Minecraft Controls menu under "Piggy Inventory".

Action	Default Key	Description
Tool Preference Menu	H	Opens radial menu to set Silk Touch/Fortune preference.
Weapon Preference Menu	G	Opens radial menu to configure weapon swap behavior.
Sort Inventory	R (in inventory)	Sorts your player inventory.
Sort Container	Middle Click	Sorts the container you're looking at.
Fast Loot Matching	Shift + Scroll (unbound by default)	Moves matching items while looking at container.
Fast Loot All	Ctrl + Scroll (unbound by default)	Moves all items while looking at container.

🎮 Hybrid Key System

To avoid conflicts with vanilla controls:

• Loot Matching: Defaults to Unbound. When unbound, uses Shift.
• Loot All: Defaults to Unbound. When unbound, uses Control.
• Customization: Bind to specific keys in Controls menu if you prefer not using Shift/Ctrl.

---

Configuration

Access the configuration menu via Mod Menu.

• Sorting: Choose default algorithm and layout (Compact, Rows, Columns, Grid).
• Tool/Weapon Swap: Toggle auto-swapping, configure preferences.
• Slot Locking: Set which slots to lock.
• Quick Loot: Adjust delays and behavior.
• Custom Lists: Configure Silk Touch blocks, tool priorities, etc.

---

Dependencies & Installation

Requirements

• Minecraft: ~1.21.1
• Fabric Loader: >=0.18.1
• Java: >=21

Required Mods

• Fabric API: Any version
• YACL (Yet Another Config Lib): ~=3.6.1+1.21-fabric
• Piggy Lib: >=1.0.1
• (Optional) Mod Menu: >=11.0.3 - Highly recommended for accessing configuration.

Installation

1. Download the .jar file from Releases.
2. Install Fabric Loader for Minecraft 1.21.1.
3. Place the piggy-inventory jar (along with Fabric API, YACL, and Piggy Lib) into your .minecraft/mods folder.
4. Launch the game!

---

Inspiration

This mod was inspired by:

• Tweakeroo - For advanced inventory management features and auto-refill mechanics.
• Inventory Profiles Next - For sorting algorithms and inventory organization.
• Mouse Tweaks - For scroll-based item movement and quick loot features.
• Inventory Tabs - For UI/UX inspiration in inventory management.

---

License: CC0-1.0