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

  1. Close Timberborn.
  2. Check that Documents\Timberborn\Mods\MixedStorage\version-1.1\manifest.json exists.
  3. If you see MixedStorage\MixedStorage\version-1.1, move the inner folder up one level.
  4. Make sure you downloaded the ZIP under Assets on the release page, not Source code.
  5. 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

  1. Compare your building with the supported list.
  2. Confirm MixedStorage and Harmony are both enabled.
  3. Search Player.log for [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.