Sophisticated Item Actions

Sophisticated Item Actions adds player-driven item interactions that work directly in the world, without requiring an inventory GUI.
It allows you to highlight nearby storages, deposit items, and restock items based on what you are holding, hovering, or selecting via modifier keys, making everyday inventory management faster and more intuitive.

---

🔍 Highlight Storage

Highlights nearby storages that contain the selected item when the highlight keybind is used, making it easy to locate where that item is stored.

How it works

• The selected item can be:
  • the item you are holding
  • an item hovered in an inventory GUI
  • an item hovered in JEI item lists or bookmarks
• Press the Highlight keybind to highlight nearby storage containing that item

Highlight colors

• Green – exact item match (including item components)
• Blue – item type
  match (same item, different components)

This makes it easy to distinguish exact matches from more general storage locations at a glance.

---

📦 Deposit Items

Moves items from your inventory into nearby storages when the deposit keybind is used, without opening any containers.

By default, depositing:

• respects the selected item or item type
• only deposits items that already exist in the target storage

Modifier keys

• Shift – deposit items selected from the main inventory
• Alt – deposit items selected from the hotbar
• Ctrl – ignore item matching and allow depositing items that do not match into empty storage slots

All modifiers can be combined, allowing precise control over:

• which part of your inventory is used
• whether only matching items are deposited

---

🔄 Restock Items

Pulls items from nearby storages directly into your inventory when the restock keybind is used.

By default, restocking:

• matches the exact item
• only fills partially filled stacks in your inventory

Modifier keys

• Shift – restock items into the main inventory
• Alt – restock items into the hotbar
• Ctrl – also fill empty inventory slots targeted by the Shift and/or Alt modifiers above, based on the held or hovered item

Ctrl on its own does not change restocking behavior; it only affects how items are restocked when combined with Shift and/or Alt.

---

📦 Supported Storage and Integration

This mod works with:

• Vanilla storage blocks (chests, barrels, etc.)
• Modded storage blocks and entities that provide item storage
  (technically, anything that exposes an item handler)

Additionally, it integrates with:

• JEI, allowing items hovered in JEI item lists and bookmarks to be used as filters

---

⚙️ General Notes

• All actions can be used even when no GUI is open
• Actions are based on the currently selected item, or on a set of items selected using modifier keys
• Storage targets can be blocks or entities that provide item storage