Quantum Space Buddies (QSB) is a multiplayer mod for Outer Wilds. The mod uses the OWML mod loader and customized UNET code (internally referred to as QNet or QuantumUNET) for networking.
QNet code adapted in part from Unity Technologies' UNET.
Copyright (C) 2020 - 2021 : Henry Pointer (_nebula or misternebula) - Aleksander Waage (AmazingAlek) - Ricardo Lopes (Raicuparta)
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
TL;DR - Don't use any mods with QSB that aren't marked as QSB compatible.
QSB relies on exact orders of objects found using Resources.FindObjectsOfTypeAll to sync objects, so any mod that changes the hierarchy at all risks breaking QSB. Also, QSB relies on certain game events being called when things happen in-game. Any mod that makes these things happen without calling the correct events will break QSB. Some mods will work fine and have been tested, like CrouchMod. Others may only work partly, like EnableDebugMode and TAICheat. NomaiVR compatibility is currently not planned and likely will never happen, due to extensive changes needed to both mods for it to work.
|System / Mechanic||Synced?|
|Brittle Hollow fragments||No|
|Conversations with NPCs||Yes|
|Eye of the Universe ancient glade||No|
|Eye of the Universe instrument hunt||No|
|Eye of the Universe jam session||No|
|Eye of the Universe quantum lightning||No|
|Nomai shuttle||Kind of|
|Orbital Probe Cannon (direction)||No|
|Timber Hearth satellite||No|
QSB also changes some mechanics of the base game, to better fit a multiplayer experience. These include :
If nothing here works, many people have got QSB working through programs such as Hamachi. Also make sure you are not running through a VPN while trying to connect.
Note - _nebula has no idea how Hamachi works and has never used it, so don't ask them for help setting it up! As said before, we are tech support for the mod. If you cannot connect to someone, or someone cannot connect to you, that is not QSB's fault.
QSBdirectory to the
OWML.Launcher.exeto start the game.
localhostwith the server's public IP address.
7777on your router.
QSB/QSB.csproj.userin your favorite text editor
<GameDir>to point to the directory where Outer Wilds is installed
<OwmlDir>to point to your OWML directory (it is installed inside the Mod Manager directory)
QSB.slnin Visual Studio
Referencesin the Solution Explorer > Manage NuGet Packages > Update OWML to fix missing references
git update-index --skip-worktree QSB/QSB.csproj.user
After doing this, the project references should be working.
When you build the solution, the QuantumUNET dll and all the mod files/assets are copied to
[Mod Manager directory]/OWML/QSB from the dev folder.
QSB.dll is first built to the dev folder as usual, then QNetWeaver is ran on it to weave in QNet/UNet serialisation code. This program outputs to the
WeavedFiles folder, and then the weaved dll is also copied to
[Mod Manager directory]/OWML/QSB.
If for some reason none of this is working, you might have to set everything manually:
If QNetWeaver does not work and does not output anything to
Join the unofficial Outer Wilds Discord, we have a nice
#modding channel where you can discuss all types of things.