diff --git a/README.md b/README.md index c24fc14..658b6c1 100644 --- a/README.md +++ b/README.md @@ -110,7 +110,7 @@ Close Timberborn, then disable MixedStorage in the mod manager or delete its fol Built against **Timberborn 1.1.2.4**. -The bundled multiplayer integration is built against the **[BeaverBuddies Stability Fork](https://github.com/timbermods/BeaverBuddies-Stability-Fork)** (formerly called Stability Preview), which is the build to use. Stability Fork releases 1.0.0 through 1.1.12 were checked to have everything the integration needs; install the latest. At startup, MixedStorage checks the installed BeaverBuddies for every part it uses. If anything is missing, it turns co-op Apply off rather than risk a desync, and Player.log names what is missing. The original [BeaverBuddies](https://github.com/thomaswp/BeaverBuddies) by thomaswp and contributors, and BeaverBuddies MultiColony (Beta), have not been tested with MixedStorage. +The bundled multiplayer integration is built against the **[BeaverBuddies Stability Fork](https://github.com/timbermods/BeaverBuddies-Stability-Fork)** (formerly called Stability Preview), which is the build to use. Stability Fork releases 1.0.0 through 1.1.12 were checked to have everything the integration needs; install the latest. At startup, MixedStorage checks the installed BeaverBuddies for every part it uses. If anything is missing, it turns co-op Apply off rather than risk a desync, and Player.log names what is missing. The original [BeaverBuddies](https://github.com/thomaswp/BeaverBuddies) by thomaswp and contributors, and Timber Together (Beta), have not been tested with MixedStorage. Players have reported successful use of earlier builds, and the **v0.5.8 layout, including the dev-mode panel, and the v0.5.7 storage visuals have been verified in game**; v1.0.0 through v1.2.0 leave both unchanged apart from v1.2.0's orange ring around Apply. The v1.0.0 to v1.2.0 changes (Copy settings, error messages, loading damaged saves, the Supply mode order, the panel's reason for an unavailable Apply, patch order, leaving mixed storage with a removed good or through the map editor's undo, and in v1.2.0 storing nothing and the Apply ring) have not been played in game yet. Automated allocation, geometry, native API, and optional multiplayer loading checks also pass, but these do not replace live gameplay testing. diff --git a/docs/faq.html b/docs/faq.html index 6ec102d..15c4740 100644 --- a/docs/faq.html +++ b/docs/faq.html @@ -76,7 +76,7 @@

Multiplayer and compatibility

Does it work in multiplayer?

Yes, through the BeaverBuddies Stability Fork. Every player installs the same version of MixedStorage (and the same Stability Fork build) and runs the same game version. Applied allocations synchronize through BeaverBuddies, and Apply may briefly show a queued message until the next simulation tick.

Is there a separate multiplayer add-on?

No. The integration is bundled and switches on automatically when BeaverBuddies is present. If you still have the old MixedStorage-BeaverBuddies add-on, remove or disable it.

What about old multiplayer replay recordings?

Old recordings may reference the former add-on and may need the original mod versions.

-
Which BeaverBuddies builds work?

The integration is built against the Stability Fork; install the latest on every computer. At startup MixedStorage checks the installed BeaverBuddies, and if something is missing it turns multiplayer Apply off and names what's missing in Player.log. The original BeaverBuddies and BeaverBuddies MultiColony (Beta) haven't been tested with MixedStorage.

+
Which BeaverBuddies builds work?

The integration is built against the Stability Fork; install the latest on every computer. At startup MixedStorage checks the installed BeaverBuddies, and if something is missing it turns multiplayer Apply off and names what's missing in Player.log. The original BeaverBuddies and Timber Together (Beta) haven't been tested with MixedStorage.

Is it compatible with other mods?

Other mods haven't been specifically tested. If you run into a conflict, open an issue and list your enabled mods.

Is MixedStorage translated?

No. The mod's own text is in English. Good names follow your game language.

The project

diff --git a/docs/install.html b/docs/install.html index 192eecd..b76c1f0 100644 --- a/docs/install.html +++ b/docs/install.html @@ -157,7 +157,7 @@

Multiplayer with BeaverBuddies

  • There is no separate MixedStorage multiplayer download.
  • After upgrading, restart every computer's game and start a fresh multiplayer session.
  • -

    Install the latest Stability Fork on every computer. At startup MixedStorage checks the installed BeaverBuddies for everything it uses; if something is missing it turns co-op Apply off rather than risk players drifting out of step, and Player.log names what's missing. The original BeaverBuddies and BeaverBuddies MultiColony haven't been tested with MixedStorage.

    +

    Install the latest Stability Fork on every computer. At startup MixedStorage checks the installed BeaverBuddies for everything it uses; if something is missing it turns co-op Apply off rather than risk players drifting out of step, and Player.log names what's missing. The original BeaverBuddies and Timber Together haven't been tested with MixedStorage.

    diff --git a/docs/troubleshooting.html b/docs/troubleshooting.html index ab13458..e6817b3 100644 --- a/docs/troubleshooting.html +++ b/docs/troubleshooting.html @@ -68,7 +68,7 @@

    Using the panel

    A building lost its allocation

    Why it happens

    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 while applying the allocation. The panel shows a short reason, and Player.log has the full 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

    MixedStorage's multiplayer support is built against the BeaverBuddies Stability Fork. If the installed BeaverBuddies lacks something it needs, MixedStorage switches its multiplayer support off rather than let players' games drift out of sync, and writes the reason to Player.log at startup. The game still starts, and single-player allocations usually still work.

    What to do

    +
    Apply says multiplayer support could not start with the installed BeaverBuddies

    Why it happens

    MixedStorage's multiplayer support is built against the BeaverBuddies Stability Fork. If the installed BeaverBuddies lacks something it needs, MixedStorage switches its multiplayer support off rather than let players' games drift out of sync, and writes the reason to Player.log at startup. The game still starts, and single-player allocations usually still work.

    What to do

    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

    How it looks

    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.