Troubleshooting
Find your symptom below. Each entry says why it happens and what to do.
Common problems
Installing and starting
MixedStorage doesn't appear in the mod manager
Why it happens
The game only finds mods in the right folder layout. Usually the ZIP wasn't extracted, there's an extra folder, or it's 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. - If Windows' Extract All made
Mods\MixedStorage-v…\MixedStorage, move the innerMixedStoragefolder intoMods. - Make sure you downloaded the ZIP under Assets, 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.
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
The old add-on clashes with MixedStorage's built-in co-op support. The error reads: “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 restart Timberborn. Keep BeaverBuddies itself for co-op.
An error says the bundled multiplayer integration is missing
Why it happens
Your copy of MixedStorage is incomplete, so its co-op support is missing. The error reads: “MixedStorage's bundled multiplayer integration is missing. Reinstall the complete release.”
What to do
Close the game, delete the MixedStorage folder from your Mods folder, and install the ZIP from the 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. It's also missing if the mod isn't enabled or failed to load.
What to do
- Compare your building with the supported list.
- Check that MixedStorage and Harmony are both enabled.
- Search
Player.logfor[MixedStorage]. A working install logs a “loaded” line at startup; a failure logs an error.
Using the panel
Apply 100% is grayed out
Why it happens
Apply unlocks only for a valid draft. The line under the goods list says what's wrong:
- Enter valid percentages (0–100, 2 decimals): a box has 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%, or 0% to store nothing.
- Set unavailable goods to 0% before applying: a good marked “(not accepted here)” or “(unavailable)” still has a percentage. This can happen after a goods mod is removed.
- A co-op 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 a valid draft at once, and Revert restores the current settings. If a co-op change is queued, wait a moment.
Paste allocations is grayed out or rejected
Why it happens
- Nothing has been copied yet. Copy allocations works only on a valid 100% draft.
- The copy is kept only until you close the game.
- The building must accept every copied good. 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 one that accepts the same goods, click Paste allocations, then Apply.
Apply says “Wait for incoming deliveries to finish before lowering their limits”
Why it happens
Haulers are already bringing goods, and the new limit would be lower than what's stored plus what's on its way.
What to do
Wait for the deliveries to finish, then click Apply again.
One of my goods has a limit of 0
Why it happens
Limits are whole items, and a tiny share of a small building can round down to 0. The panel warns you: “N allocated good(s) round to 0 items. Increase their shares or use larger storage.”
What to do
Increase that good's share, or use a larger storage building. The demo on the home page shows the rounding.
Stock is above the limit and shows as “excess”
Why it happens
You lowered a limit while goods were already stored. MixedStorage never deletes goods; it marks the extra as excess.
What to do
Nothing is broken. The extra goods stay until they're used or hauled out.
Goods aren't arriving after I Apply
Why it happens
Allocations reserve space; they don't create or move goods. Normal hauling rules decide what arrives and when.
What to do
Check the building's hauling mode (Accept, Obtain, Supply or Empty) and hauler priority, and that the goods exist in the same district.
Copy settings didn't copy my allocation
Why it happens
The game's Copy settings tool applies the percentages only if the target accepts every allocated good and no delivery on its way clashes with a lower limit. Otherwise the target keeps its goods and percentages; the tool's other settings, such as the hauling mode, still copy. Player.log has a line starting [MixedStorage] Copied allocations were not applied with the reason.
What to do
Copy to a building that accepts the same goods, or wait for deliveries to finish and copy again. For a building that accepts different goods, set its percentages in its own Storage Allocation panel.
A building lost its allocation
Why it happens
- The game's Copy settings tool was used from a normal building. That turns a mixed building back into a normal single-good one.
- Its saved allocation couldn't be read, for example because the save was damaged. MixedStorage skips it so the save still loads. The building keeps its normal single good, and Player.log has a line starting
[MixedStorage] Ignoring an unreadable saved allocation.
What to do
Set the percentages again and click Apply 100%. If a save keeps losing allocations, report it with that log line.
Apply shows “Apply failed”
Why it happens
Something unexpected went wrong. The panel shows a short reason, and Player.log has the details.
What to do
Report it with the Player.log lines that start with [MixedStorage] and the steps that led to it.
Co-op
Apply says multiplayer support could not start with the installed BeaverBuddies
Why it happens
The installed BeaverBuddies lacks something MixedStorage needs. MixedStorage turns its co-op support off so players' games can't drift out of sync, and writes the reason to Player.log. Single player usually still works.
What to do
- Install the latest BeaverBuddies Stability Fork on every computer.
- For single player, you can also disable BeaverBuddies.
- Search Player.log for
[MixedStorage]to see what's missing, and include that line if you report it.
Multiplayer: Apply says “Queued for multiplayer”, or players see different settings
Why it happens
In co-op, Apply goes through BeaverBuddies, so it may say “Queued for multiplayer” until the next simulation tick. That's normal. Different settings between players usually mean mismatched installs.
What to do
- Every player needs the same MixedStorage version, Stability Fork build and game version.
- After upgrading, everyone restarts the game and starts a fresh session.
How it looks
The goods in the world look wrong, narrow, or show only one good
Why it happens
The split in the world is approximate. Whole visible cells can't always match a percentage, so tiny shares may not show, some models look narrower, and banners show one good. A model that can't be divided keeps the game's original look.
What to do
Use the summary cards for exact amounts. If something looks truly broken, report it with a screenshot.
The panel looks cut off or misplaced at my resolution or UI scale
Why it happens
The editor is sized to your screen and shares the building's window with the game's own panels, such as Construction site and the dev-mode panel.
What to do
Make sure you have the newest release. 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 in %USERPROFILE%\AppData\LocalLow\Mechanistry\Timberborn. Player.log is the current session; after a restart, the previous one is in Player-prev.log.
Logs can contain personal information, so review them before sharing.