Portable Storage

Project Introduction

Portable Storage is a Minecraft mod based on Fabric and Fabric API, providing players with portable storage functionality. The storage currently uses an infinite stacking design, intelligently storing items by variant (including components and NBT data), and supports multi-player sharing and interaction with automation devices.

"Unlimited" is not truly unlimited; the maximum stack size for a single item type is Long.MAX_VALUE.

Main Features

This mod adds a storage interface above the player's inventory UI. The top of the interface features a search bar (supporting searches by item name, mod ID, and item description), while the bottom displays items stored in the storage, allowing free taking and placing of items.

The left side of the storage interface has 5 upgrade slots where specific items can be placed to unlock additional functions for the storage. The right side is the storage settings panel.

You need to use a Nether Star to enable the full storage (configurable).

Starting from version 1.4.6, you can also use a Heart of the Sea to activate a basic storage, which is limited to storing 46 types of items with unlimited stack sizes. However, some upgrade functionalities will be unavailable. Other than that, it is identical to the full storage.

Features restricted in the basic storage: Bound Barrel, Rift (Dragon Egg), Spectral Arrow, Experience Bottle, Piston.

Mod UI

Upgrades (Place items in upgrade slots; right-click the upgrade slot to disable):

• Crafting Table: Displays the storage interface at the bottom of the crafting table interface, supporting crafting replenishment (automatically replenishes items from storage to crafting grid).
• Hopper: Automatically picks up dropped items within a 5-block radius into the storage.
  • Middle-click the slot to open the filter interface, where you can configure filtering and destruction.
  • Filtering: Configure items to filter; filtered items will not be automatically picked up.
  • Destruction: Configure items to destroy; destroyed items will be automatically picked up and destroyed, not entering your storage.
• Chest: Adds 5 additional upgrade slots.
• Barrel: Creates a bound container, supporting multi-player storage sharing and automation device access:
  • Placing it in the slot upgrades it to a special bound container.
  • Removing it from the slot allows it to be placed as a block; right-click to open and deposit items into storage.
  • Automation devices can extract/deposit items from/to the player's storage via the bound barrel.
  • Placing another player's bound barrel allows sharing storage (merged display).
  • Supports multiple players sharing the same storage, but includes an anti-loop mechanism.
  • Shift + right-click to open the filter interface; items added to the blacklist will be directly destroyed.
• Dragon Egg (Rift Upgrade): Right-click to enter the Rift dimension.
  • A private space, 16x16 in size (one chunk), configurable.
  • The Rift chunk loads and follows the player, whether inside the Rift or not.
  • The Rift has perpetual daylight and requires no lighting.
  • When a player leaves the Rift, a "copy" is generated to receive effects (e.g., you can place a beacon in the Rift to gain beacon effects).
  • If you die in the Rift, the storage key will drop at the location where you entered the Rift.
  • Falling into the Rift void will exit the Rift without generating a copy.

Extended Upgrade Slots

• Spectral Arrow: Shot normal arrows will make the target glow for 10s.
• Bed: Right-click the enabled bed upgrade to sleep in place (does not set spawn point).
• Experience Bottle: Displays "Bottled Experience" in the storage.
  • Right-click the slot to switch access levels (1, 5, 10, 100).
  • Middle-click the slot to toggle the "Level Maintenance" function.
  • Level Maintenance: Maintains the player's current level, depositing excess or withdrawing when levels change.
  • Right-click bottled experience with an empty hand to deposit corresponding levels of experience; left-click to withdraw.
  • Right-click bottled experience with an empty glass bottle to exchange 11 experience points for 1 experience bottle; excess glass bottles will be placed into storage if experience is insufficient.
• Piston: Automatically replenishes main-hand and off-hand items. Left-click with a piston in hand to rotate blocks.
• Enchanted Golden Apple: Automatic feeding, with options to feed when hunger is below 6, 14, or 18.

Special Slots

• Fluid: Right-click this slot with a fluid bucket to store fluids, located at the top of the upgrade slots.
  • Can store Lava, Water, Milk.
  • After storing fluid, the fluid will be displayed in the storage.
  • Right-click the fluid with an empty bucket to retrieve a fluid bucket.
  • When Auto-Transfer is enabled, Shift+Click to deposit a fluid bucket will separate it into an empty bucket and fluid for storage.
  • When Auto-Transfer is enabled and you have an empty bucket in your inventory, Shift+Click the fluid in storage to quickly retrieve a fluid bucket.
• Trash Can: Available if the chest upgrade is installed; can place any item, located at the top of the extended upgrade slots.
  • Items will be destroyed when exiting the save or going offline.
  • Overwrite with a different item to destroy.
  • Items can be retrieved before destruction.

Client Settings

The following settings are saved client-side and will not be lost upon game restart or interface switching:

• Collapse Storage: Displays the storage interface as a tabbed form.
• Sorting Scheme: Supports four sorting methods:
  • Quantity (by item count)
  • Item Name (alphabetically)
  • Mod ID (by mod name)
  • Update Time (recently operated items first)
• Sort Order: Toggle between ascending or descending order.
• Crafting Replenishment: When used in the crafting table interface, automatically replenishes items from storage to the crafting grid, supporting continuous crafting.
• Auto-Transfer: When using Shift+Left Click on an item, prioritizes storing the item in storage rather than the inventory or hotbar.
• Smart Collapse: Collapses items that cannot be stacked due to different NBT data; expands during search (right-click collapse automatically searches).
• Search Position: Adjust the position of the search bar:
  • Bottom: Display below the storage UI.
  • Top: Above the player inventory UI (closer).
  • Top 2: Above the player inventory UI (higher).
  • Middle: Insert between the inventory UI and storage UI.
• Return to Vanilla: Click to open the vanilla crafting table interface; requires opening the crafting interface by right-clicking the crafting table to return (has recipe book).

Other Mechanisms

• Arrows for bows and crossbows are deducted from storage (unless they are infinite).
• Middle-click an item in storage to favorite or unfavorite it; favorited items are displayed before others.
• Pinyin Search: Supports initial letter search.
• Hide the recipe book button in the inventory interface (requires the crafting table upgrade).
• Quick Deposit (Auto-Transfer supplement): When holding an item with the cursor, hold Shift + double-click the same item to deposit all identical items from the inventory into storage.
• Infinite Fluids: When the fluid quantity in storage exceeds a threshold, the quantity displays ∞ (unlimited); depositing or withdrawing does not change its quantity.
  • Default lava threshold is 10000; default water threshold is 2.
• Item Size Limit: The storage checks the size of a single item; if it exceeds the limit, it cannot be stored (and will be lost upon attempting to store).

---

If you have suggestions or issues, feel free to leave feedback in the Issue section or Q Group 726741344!