2,696 ratings
Improved Containers
File Size
0.398 MB
Jul 22, 2016 @ 10:06am
Oct 9, 2017 @ 2:36am
30 Change Notes ( view )

Subscribe to download
Improved Containers

In 1 collection by v6
Extended and Improved UI
7 items
Improved Containers adds quality of life features to containers in Starbound.
The aim is to keep the mod multiplayer friendly so you will still be able to play with friends that do not have the mod installed.

It is not compatible with other container mods that add similar features.

This is a client- & server-side mod. That means that the mod must be installed for the client (you) and the server for all features to work as intended.

Steam Workshop version:
Non-Steam version:

Added features
- Persistent storage
- Mass selling (Container sell-price)
- Renaming
- Searching
- Sorting
- Quick stacking

Feature breakdown
Some features listed below are client-side but have a server-side container lock that prevents other players from manipulating anything when you are. This is put in place to prevent items from disappearing.
If the mod is not installed on the server or if it's running an outdated version, the rename button will be grayed out. This means you should be careful and avoid sorting or stacking the same container as someone else is currently using.

Persistent storage (server-side)
Looted containers that have been opened once will keep items inside instead of spilling everything on the floor.
If a looted container has content, it will be highlighted with a red border and a different tooltip indicating how many items there are inside of it.

Mass selling (server-side)
The container value, or sell price, will include all the items inside of it.

Renaming (server-side)
Write a name or leave blank to reset, and hit enter. The container UI will close and update its name.
Accepted characters are A-Z 0-9 . ' - ( )

Searching (client-side)
Search for item names or search for tags (category, type, etc) by placing a number sign/hashtag first. E.g. #consumable, #storage, #weapon, #armor
You can find up to 32 items at a time, if the textbox turns red then you need to narrow your search.

Sorting (client-side)
Items are sorted by an weighted item sort system with categories > rarity > name > count.
Suggestions can be left in the Item sorting thread.

Quick stacking (client-side)
Will attempt to fill up stacks with items from your inventory and it will also attempt to fill empty slots with the same items that are already inside.
Due to limitations, it will not stack any objects or containers with item slots, crafting stations or items with durability.

Configuration is disabled in 1.3 as there is no way to read config.
If you want to play with the default settings, just skip over this. All settings default to false and are opt-in.

For singleplayer you can use the admin debug command /eval change your settings or manually edit storage/starbound.config.
Example: /eval root.setConfigurationPath("modconfig.improvedcontainers.dropOnBreak", true)

For servers you will need to manually edit storage/starbound_server.config and add.
"modconfig" : {
"improvedcontainers" : {
"storeContainers" = false,
"dropOnBreak" = false,
"fridgeNoSpoil" = false

After changing a settings, you have to unload the currently loaded worlds for container settings to take effect. The easiest way to do this is to restart a server or go to the main menu in singleplayer.

storeContainers = true|false
Setting to true will allow storing containers, with content, inside placed containers. Will only allow 1 level deep (container inside container) and will always eject containers when broken.

dropOnBreak = true|false
Setting to true, containers will always drop content when broken.

fridgeNoSpoil = true|false
Setting to true, food will not spoil inside of broken refridgerated containers when inside your inventory.

Mod support
To support mods and new containers, patch files must be manually created.
While I am not able to actively maintain patch files for mods that I do not use, you can just report back if you find any containers that need patches.

Currently supported:
Argonian, Avali, Elithian Races Mod / Avikan, Bunnykin, Callistan, Draconis, Frackin' Universe, Felins, Frontier Expansion, GardenBot2, Greckan, Gyrusens+, Human Furniture, Inkling, ISE4, Kybin, MadTulips Spaceship Mod, More Farming, Munari, Neko Species, Obsidian Furniture, Orcana, Penguin Piracy, Pixel Goods Store, Sallok, Sanglar, Saturnians, Sergal, Skath, Skelekin, Slime race, Small Improvements, The Pony Modpack, Temple of the Water Serpent (ITA - Dragon Temple), Terrakin, The Viera Race of Ivalice, Wasp Hive Race

Click Subscribe and start the game. Make sure the mod is loaded at the main menu by pressing the Cogwheel in the bottom right corner.

Non-Steam version
Click Download Now and save file to your Starbound/mods/ folder.
Make sure you delete older versions if you update.

Bug reporting
When bug reporting, please use the forum thread and not the comment section.
Include your starbound.log file that is located in your Starbound installation folder under the storage folder.
Windows: C:\Program Files (x86)\Steam\SteamApps\common\Starbound\storage\starbound.log
Open the file and copy the contents to

This mod is not compatible with Enhanced Storage or other container mods that add similar features.
Popular Discussions View All (11)
Mar 1 @ 6:55am
PINNED: Bug reports
Dec 7, 2017 @ 8:48am
PINNED: Item sorting
Jun 25 @ 7:54am
Mod Compatibility
< >
Tylerius Maximus Jul 4 @ 4:58pm 
Caused crashes for me every time I opened some containers and eventually caused crashes every time I tried to play. Unsubscribed and my game works perfectly.
The New Meta™ Jun 21 @ 6:28am 
I'm guessing that is incompatible with existing characters?
Spider with a Gun Jun 20 @ 4:11pm 
@Issah it is indeed this mod. I CTD'd when I tried openning the weapon chest in the intro. Uninstalling this specific mod fixed it for me.
Exaelitus Jun 7 @ 5:22pm 
@Issah, If you copy/paste your crash log to pastebin, and paste the link here, we could probably help better.
Issah Jun 5 @ 6:58pm 
my game crashes when I open a chest. Does anyone know what mod does this?
Southern Wind Jun 3 @ 8:08pm 
Wow this mod is awesome. I open the chest and click the quick stack button. I thought it just merge the same items in the storage but it move same item and stack it on the storage. It works like Terraria quick stack button. So awesome must have this mod
Morhe May 28 @ 2:23pm 
It merges small stacks and averages their remaining spoil time. It's not from this mod, though; it's from the Food Stack mod by the same author.
Genocide May 26 @ 9:03am 
Okay so... what does the little food icon do with food storage devices? I hit it and half my food disappeared...
Vithor14 May 20 @ 9:28am 
me and my friend wants to use this mod, he is hosting the server, its possible to play without the mass selling and persistent storage?
Mythril Boomstick May 8 @ 2:06pm 
is there any chance of just a client side version of this without mass selling