Ultimate Storage

Ultimate Storage

Storage and crafting from chests: deposit key, protected slots, auto stack and sort, craft from nearby containers, recipe search, bigger stacks and smart auto pickup.

<img src="https://img.shields.io/badge/%E2%8C%A8%20PRESS-F3-f0a020?style=for-the-badge&labelColor=1a1a2e" alt="Press F3" height="90">

⌨️ PRESS F3 IN THE GAME TO OPEN THE SETTINGS PANEL ⌨️

Every feature of this mod is turned on and tuned in the in-game panel.
Can't use F3? Open the console with F5 and type ultimateqol_config.

> ### ⌨️ How to use > 1. Install and start the game. > 2. Press F3 to open the settings panel. > 3. Find the Storage options in the sidebar (or type in the search box at the top) and turn on what you want. > > Everything is off by default, so the game stays vanilla until you turn something on. > > 🔑 To change settings you need admin access with devcommands: be listed in the server's adminlist.txt (on a dedicated server) or be the host of the world. Changes are synchronized to all players in real time.

Features

Storage

• Storage range (default 20 m, 1–50) – how far containers are used by the deposit key.

• Deposit key (default N) – sends items only to nearby containers that already hold the same item. Equipped items and protected slots are never moved. Space is checked before any transfer: no loss, no duplication.
• Protected slots – CTRL + right click on a slot of your inventory. Protected slots get a gold frame and are saved with your character.
• Auto Stack / Auto Sort – run only when a container is opened (never in the background).
• Works with every real container: chests, reinforced/black metal chests, ship storage and carts (never taken from a player who is sailing or pulling them).
• Join items on the ground into piles (off by default) – an item that falls (trees, rocks, creatures, players dropping it) joins a pile of the same item within 4 m (1–10), up to the normal stack size: 5 wood fall as one pile of 5. The game only does this itself above 200 loaded items and for some items; here it works for every stackable item. Fewer objects on the ground = less work for the game and the network. Only identical items are joined; each item is checked once, a second after it appears.
• Sweep items from the ground into chests (off by default) – an item lying on the ground (around carts and boats too) is moved into a nearby container that already holds the same item; empty containers are never used, containers someone has open are skipped, and nothing is taken while a player stands within 8 m of the item. Wait before sweeping (default 5 min, 1–120) and Sweep range (default 10 m, 1–50). It is event driven: each item is looked at once when its wait ends (and again only if it could not be moved), with a tiny time budget per frame and a back-off when frames are slow – big bases cost almost nothing. The item is only removed from the ground after the container accepted it, and exactly the amount that went in.

Crafting

• Craft from nearby containers – the crafting menu shows the total (inventory + containers in range). The inventory is consumed first; only the missing amount comes from storage. Station, DLC and upgrade rules of the game stay intact.
• Crafting range (default 20 m) is independent of the storage range.
• Leave 1 of each item in every chest (off by default) – crafting and building from containers never take the last item of each kind from a chest, and the counts already show one less per chest, so every chest keeps showing what it is for. Your own inventory is always used completely.
• Craft several at once (off by default) – small – and + inside the game's own Craft button (copies of the button's own text, so it looks vanilla) choose how many to craft; the mouse wheel over the button works too, Shift = 10 at a time, up to 100 at a time, never more than the materials and the free space allow. It hands the quantity to the game's own multi-craft (the same as Shift + Craft): the game writes "Craft x 5", shows the total materials, checks them, crafts and charges everything itself, so nothing can be duplicated. Upgrades stay one at a time.

Recipe search

Option on the Crafting page (off by default): a search box above the crafting list. Type part of an item name, its description or an ingredient and only matching recipes are listed; several words must all match.

Auto pickup modes

Option (off by default): the game's auto pickup key cycles ON → only items you already carry → OFF. In the middle mode only items you already have in the inventory (equipped ones count) are picked up, so the bag does not fill with things you do not want. The usual game message shows each mode.

Items and pickup

• Stack size per kind of item (100–1000%, default 100% = vanilla): materials (wood, stone, ores, metals, hides, seeds…), food and potions, ammo (arrows, bolts, bait), trophies and other items (coins, fish, misc). Each card shows the item's picture and a live example ("Wood: stack of 50 → 500"). Items that never stack (weapons, armor, tools) are never changed. Nothing is ever lost: the game cuts a stack down to the current size when it loads an inventory; the mod removes that cut, so lowering the option later never deletes items – a bigger stack simply stays as it is until it is used.
• Auto pickup range (0–20 m, 0 = the game's own 2 m) – how far items on the ground fly to you.

⚠️ Experimental

This mod is still experimental and may contain bugs. Back up your world and your character, and turn features on a few at a time.