Guide
Troubleshooting
Find your symptom below. Each entry explains why it happens and what to do.
Common problems
MixedStorage doesn't appear in the mod manager
Why it happens
The game only finds mods in the expected folder layout. The usual causes are a ZIP that wasn't extracted, an extra nested folder, or the wrong download.
What to do
- Close Timberborn.
- Check that
Documents\Timberborn\Mods\MixedStorage\version-1.1\manifest.jsonexists. - If you see
MixedStorage\MixedStorage\version-1.1, move the inner folder up one level. - Make sure you downloaded the ZIP under Assets on the release page, not Source code.
- Restart the game.
MixedStorage won't enable, or Harmony is missing
Why it happens
MixedStorage requires Harmony 2.4.1 or newer, and declares it as a required mod.
What to do
Install Harmony from the Steam Workshop, enable both Harmony and MixedStorage in the mod manager, and restart when prompted.
A startup error mentions the old MixedStorage-BeaverBuddies add-on
Why it happens
Since v0.5.0, multiplayer support is built into MixedStorage. The old separate add-on conflicts with it, and MixedStorage stops with this message: “MixedStorage now includes multiplayer support. Remove or disable the old MixedStorage-BeaverBuddies addon and restart Timberborn.”
What to do
Remove or disable MixedStorage-BeaverBuddies, then fully restart Timberborn. Keep BeaverBuddies itself if you play multiplayer.
An error says the bundled multiplayer integration is missing
Why it happens
BeaverBuddies is loaded, but the MixedStorage file doesn't contain its embedded multiplayer integration. That happens with a partial or incorrectly built copy. The message reads: “MixedStorage's bundled multiplayer integration is missing. Reinstall the complete release.”
What to do
Close the game, delete the existing MixedStorage folder from your Mods folder, and install the ZIP from the official release again.
There's no Storage Allocation panel when I select a building
Why it happens
Only the supported warehouses and piles get the panel. Tanks, map-editor reserve storage, and other storage buildings don't. It's also missing if the mod isn't enabled or failed to load.
What to do
- Compare your building with the supported list.
- Confirm MixedStorage and Harmony are both enabled.
- Search
Player.logfor[MixedStorage]. A working install logs a “loaded” line at startup, and a failure shows an error there.
Apply 100% is grayed out
Why it happens
Apply only unlocks when the draft is valid. The line under the goods list tells you which rule you're breaking:
- Enter valid percentages (0–100, 2 decimals): one box has something invalid, such as letters, a negative number, more than two decimals, or a value over 100.
- NN% / 100% — NN% remaining (or over): the total must be exactly 100%.
- A good with a nonzero percentage isn't accepted by this building. Set it to 0%.
- A multiplayer change is queued and hasn't been applied yet.
What to do
Fix the box or total the message points at. Max on one good gives you a valid draft instantly, and Revert restores the current settings. If a multiplayer change is queued, wait a moment for the next simulation tick.
Apply says “Wait for incoming deliveries to finish before lowering their limits”
Why it happens
Haulers are already carrying goods to this building, and the new limit would be lower than what's stored plus what's on its way. Incoming deliveries count toward limits.
What to do
Wait for the deliveries to finish, then click Apply again.
Paste allocations is grayed out or rejected
Why it happens
- Nothing has been copied yet. Copy allocations works only on a valid draft totaling 100%.
- Copied settings last only for the current game session, so restarting the game forgets them.
- The destination must accept every good with a nonzero copied percentage. Otherwise you'll see “Cannot paste: this building does not accept all copied goods. Draft unchanged.”
What to do
Copy from a valid building, select a compatible destination, click Paste, and then click Apply to confirm. Stock, hauling mode, and hauler priority are never copied.
One of my goods has a limit of 0
Why it happens
Percentages become whole-item limits, and a tiny share of a small building can round down to zero items. The panel warns you: “N allocated good(s) round to 0 items. Increase their shares or use larger storage.” The limits still add up to the building's full capacity.
What to do
Increase that good's share, or use a larger storage building. The demo on the home page shows how the rounding works.
Stock is above the limit and shows as “excess”
Why it happens
You lowered a limit or changed the split while goods were already stored. MixedStorage never deletes goods; it flags the extras as excess in the summary.
What to do
Nothing is broken. The extra goods stay until they're used or hauled out through the game's normal hauling rules.
Goods aren't arriving after I Apply
Why it happens
Allocations reserve space. They don't create goods or move them. Normal hauling rules still decide what arrives and when.
What to do
Check the building's storage mode (Accept, Obtain, Supply, or Empty), hauler priority, and that the goods actually exist in the same district. Then let your haulers work.
The goods in the world look wrong, narrow, or show only one good
Why it happens
The in-world split is approximate on purpose. Whole visible cells can't always match a percentage exactly. Tiny shares may have no visible cell, some models look narrower, banners show one representative good, and excess goods may not be fully represented.
What to do
Use the summary cards for exact amounts. If a model can't be divided, MixedStorage falls back to the original visuals. If something looks truly broken, report it with a screenshot.
Multiplayer: Apply says “Queued for multiplayer”, or players see different settings
Why it happens
In multiplayer, applied allocations synchronize through BeaverBuddies, so Apply may briefly show a queued message until the next simulation tick. That's normal. Different settings between players usually mean mismatched installs.
What to do
- Install the same MixedStorage version, matching BeaverBuddies versions, and Harmony on every computer.
- After upgrading, restart every computer's game and start a fresh multiplayer session.
- Old replay recordings may reference the former add-on and may need the original mod versions.
The panel looks cut off or misplaced at my resolution or UI scale
Why it happens
The editor is sized to your window and shares the entity window with the game's own panels. Older versions could push the Construction site panel off the bottom of the screen on unfinished buildings.
What to do
Update to the newest release. v0.5.5 fixed the cut-off Construction site panel. If it still looks wrong, report it with a screenshot, your resolution and UI scale, the building type, and its allocations.
Reporting a problem
Still stuck, or found a bug? Open an issue on GitHub and include:
- Your Timberborn and MixedStorage versions, and the other mods you have enabled.
- Whether you were playing multiplayer.
- Steps to reproduce the problem.
- For layout or visual problems: a screenshot, your resolution and UI scale, the building type, and its allocations.
- For crashes: the relevant error and stack trace from the game log.
Where the logs are
On Windows they're normally in %USERPROFILE%\AppData\LocalLow\Mechanistry\Timberborn. Player.log is the current session. After a restart, the previous session is usually in Player-prev.log.
Logs can contain personal information, so review them before sharing.