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

  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. If Windows' Extract All made Mods\MixedStorage-v…\MixedStorage, move the inner MixedStorage folder into Mods.
  5. Make sure you downloaded the ZIP under Assets, not Source code.
  6. 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

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