Skip to content
Thomas P edited this page May 14, 2024 · 12 revisions

BeaverBuddies

BeaverBuddies is a Timberborn mod that adds multiplayer co-op!

If you're already sold, dive right into our installation guide.

BeaverBuddiesDemo

Features

  • Players work together to build a Beaver civilization.
  • Players work on the same map in real-time, but each player has their own camera and user interface.
  • The multiplayer works similar to co-op games like Stardew Valley, Factorio, Dungeons 3, and Parkitect.
  • All resources and abilities are shared among players, but players who want more independence can create their own Districts to control separate areas, while still being able to trade resources as needed.
  • New: Host and connect from in-game menus.

Note: BeaverBuddies is still undergoing heavy testing and improvement. You may experience desyncs or game crashes. The mod may not work on the most complex saves yet. It also may not work on all systems equally well. You can help improve the mod by playing and reporting any bugs you find.

FAQ

Q: How does this mod work and what can I expect?

BeaverBuddies works by making sure that the Host's and Client's game progress in the exact same way. If they diverge even a little, then the game desyncs, and will quickly diverge (like the butterfly effect). The mod uses a combination of strategies to make sure this doesn't happen, though they're not perfect. You can read more about them on the How does it work? page.

So you can expect:

  • There will be a tiny amount of lag for the Host (<0.3s)
  • There may be a bit more lag for the Client's actions (<1s on a good network connection).
  • There may sometimes be desyncs, where we're still working to improve the mod. If that happens, see the Troubleshooting page.

Q: What features of Timberborn work in co-op mode?

All feature should work. If you find one that doesn't work as expected, or causes a desync, let us know.

Q: Will this mod break my save file?

We strongly recommend backing up your saves before using any mod. However, this mod does not directly change your game's save, so there should not be any problems. You may experience crashes, which could lose some temporary work, but the game should still autosave as normal. You may also experience desyncs, but this will not prevent you from saving.

We recommend starting with a new save when playing multiplayer, to start fresh with your Buddy.

Q: Something isn't working - what do I do?

See the Troubleshooting page.

Q: How do I use this mod?

See the Installation and Setup page.

Q: What other mods work with BeaverBuddies?

Currently, it is discouraged to use mods with BeaverBuddies, since they would likely cause desyncs. It is possible some simple mods, which do not involve any randomness or user interface actions may work if both Host and Client install them, but this is not currently supported.

Q: How do I stop using co-op mode?

  • If you used the ModManager to install BeaverBuddies, simply disable it.
  • Otherwise, the simplest way is to edit the config file Installation and Setup page changing the mode to "None".
  • If you are still having issues, a more thorough way is to remove the BeaverBuddies folder from your plugins folder.

Q: Does the mod work cross-platform (e.g. Windows and Mac)?

Some users have reported that this does work. If you run into problems, let us know!

Q: How many players does the game support?

Theoretically, any number of players can join. In practice, the mod has only been tested with 2. This will hopefully change in the future.

Q: Do we both need to own Timberborn to play?

Yes. Both players need their own copy. More copies sold means more improvements to the game, so invite your buddies!

Q: Can I suggest a feature?

Yes, though the goal of BeaverBuddies is intentionally limited to supporting the main game in co-op mode. To suggest a feature, create a new issue using the "Feature request" template.

If you are a developer and want to create a mod that is compatible with BeaverBuddies, this is certainly possible.

Q: How can I contribute?

If you are a mod developer and want to contribute, instructions for how to set up BeaverBuddies are on the main GitHub page. You can make a pull request to fix bugs or create improvements. Consider filing an Issue first to discuss your idea.