Smart Inventory Utilities (Click for More)

Smart Inventory Utilities (SIU) is an essential quality-of-life tool for Minecraft Bedrock. Stop interrupting your gameplay to manually swap broken tools or refill blocks. This addon manages your inventory intelligently, automatically, and is highly configurable via scripts.

Smart Inventory Utilities Banner

What Does This Addon Do?

SIU combines two critical systems into a single optimized script: Stack Refill and Durability Monitor. The addon detects when an item is depleted or about to break and instantly looks for an identical replacement in your inventory to equip it.

Key Features

✅ Smart Stack Refill: Automatically replenishes blocks, food, or potions from your inventory when the current stack reaches zero.
✅ Item Saver (Auto-Swap): Swaps tools/armor to your inventory before they break, preventing the loss of expensive enchantments.
✅ Dynamic Lore: Adds a "Durability" line to your items' description, showing exact remaining uses in real-time.
✅ Multi-Level Alerts: Visual and audible warnings (Action Bar, Titles, and Particles) when durability reaches 15%, 5%, or critical levels.
✅ Drop Detection: If you throw the last item of a stack, the system detects it and refills your hand immediately.

Durability Alert Levels

Level	Condition	Effect
Warning	15% Durability	Yellow message in the Action Bar.
Danger	5% Durability	Bass sound, lava particles, and chat alert.
Critical	3 Uses Left	On-screen Title, break sound, and explosion particles.

🛠️ Technical Configuration

You can customize the behavior by editing the constants at the top of scripts/main.js. Adjust refill logic, warning percentages, or item saver thresholds to fit your playstyle.

const REFILL_CONFIG = {
  ENABLE_STACK_REFILL: true,
  ENABLE_TOOL_REFILL: true,
  HOTBAR_ONLY: true
};

const DURABILITY_CONFIG = {
  WARNING_PERCENT: 0.15,
  ITEM_SAVER_USES: 1,
  LORE_ENABLED: true
};

Compatibility & Requirements

✅ Achievements Compatible: This addon does not require Experimental Gameplay/Beta APIs, meaning you can use it in your world while still earning Xbox Achievements!
✅ Version: Optimized for Minecraft Bedrock 1.21.60+ (v26.3).
✅ Multiplayer: Fully works on Realms and Dedicated Servers.
✅ Cross-Addon: Compatible with custom items from other addons.

How to Use

Equip any tool or armor piece.
The addon will automatically start monitoring durability and adding lore information.
Keep backup tools or item stacks in your inventory for the auto-replacement to trigger.
To mute warnings, you can add the tag durability_mute to yourself.

Found a bug or have a suggestion? Join our Discord Server for support and community updates!