2,240 ratings
Improved Containers
File Size
0.398 MB
Jul 22, 2016 @ 10:06am
Oct 9 @ 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)
Aug 22 @ 11:19pm
PINNED: Bug reports
Jul 15 @ 6:08pm
Disable full cest pickup option - suggestion
Jul 10 @ 3:21pm
PINNED: Item sorting
< >
Astronomical Oct 9 @ 2:35pm 
Wow thanks for the continued mod compatibility, it's really appreciated!
v6  [author] Oct 9 @ 12:50am 
@The Sole Survivor,
The persistent storage is server-side. If it's not installed then chests will drop everything when broken but you can't place down chests with content or they will be blank afterwards.

If you wish to disable anything for personal use the easiest way would be to get the non-Steam version and edit the script file for the server and just change the config values.
The Sole Survivor Oct 8 @ 7:45pm 
Quick question @v6. Is there a way to have the sort and quick-stack features of this mod without the ability to break a chest and have it keep all of its items in it. I'd rather not play with my friends (or go on to a server) only for me to forget that they don't have the same mod, and I get called out for "hax".
v6  [author] Oct 4 @ 9:58am 
@BoredMan Walking,
That's really not the proper way to write if you need help or report a error.
Did you by any chance install both Improved Containers and Enhanced Storage at the same time.
Make sure to include a log file if you're going to report a issue in the PINNED Bug reports thread.
Lord Kaelan. Oct 2 @ 5:54pm 
Thanks for this, Coming from Terraria chests in this game are so annoying.
v6  [author] Sep 22 @ 9:09am 
@A medium sized bag of left socks,
It was not much of an issue when the sorting & stacking was server-side but it was requested that sorting & stacking should be made client-side so it would still work even on servers without the mod.
I can see if I make it less likely to happen but it's most likely always going to be possible if you do it at the same time.
Sentry's Spying my Sap Sep 21 @ 6:31am 
I found a little glitch. If you take an item or stack of items at the same time that a friend sorts the container, it will duplicate the item or stack.
Uxie Sep 5 @ 6:35am 
A very excellent mod. I'm unsubscribing due to conflicts with others, but I'd recommend this to anyone who needs a lightweight container mod.
Astronomical Aug 28 @ 7:57am 
Excellent mod btw thanks again!
Astronomical Aug 28 @ 7:57am 
Thanks for the great compatibility patch! If you feel like adding more mod support at any time please add Hive Wasp Race and The Nightars. I'd also like to see support for some mods like More Human Furniture, ITA - Dragon Temple, Frontier Expansion, and maybe even Obsidian Furniture.