Nebula Multiplayer Mod

An open-source, multiplayer mod for the game Dyson Sphere Program.

Download Prerelease

Note: This is the bleeding edge build, for the more stable build see below. You can use this one if you want to try out the latest development builds, which may contain bugs and unfinished work.

You will also need some extra steps to get this installed, see 2nd point in "How can I play this mod?".

FAQ

Where can I get mod support?

Please join our Discord Server and ask your question in the support channel. We have a really nice community that will be able to answer your questions.

How can I play this mod?

Please do keep in mind that this mod is still in heavy development, it may still contains bugs.

Stable version of the mod can be downloaded from Thunderstore (Recommended).
If you want to install the latest version of the mod, you can install pre-release versions be following the installation guide.
To connect, check hosting and joining guide.

API Documentation

This mod has an API, that makes it easier for other mod developers to make their mods compatible with Nebula. If you are a mod developer and you want your mods to be compatible, follow the instructions here. Also you can always join our Discord Server for help with using the API.

Chat

The chat window can opened/closed using Alt + Backtick (configurable in Settings - Multiplayer - Chat). Type /help to view all commands. Also in settings is an option to disable the chat window from automatically opening when a message is received.

What is the current status?

Major refactors will happen while the project grows or game updates. Join the Discord Server if you want to see to latest state of our development. Check Wiki for overview of features.

The multiplayer mod now supports Dark Fog combat mode in the latest game version (0.10.29.x).
Most of the battle aspect are sync, only few features are still WIP.

List of peace mode syncing features

[x] Server / Client communication
[x] Custom Multiplayer menu in-game
[x] Player Movement syncing on Planet
[x] Player Movement syncing in Space
[x] Player VFX syncing (jetpack, torch, ...)
[x] Player SFX syncing (footsteps sound, torch sound, ...)
[x] Players appearances syncing
[x] Game Time (UPS) syncing
[x] Universe settings syncing
[x] Client planet loading from server
[x] Planet vegetation mining syncing
[x] Planet resources syncing
[x] Build preview syncing
[x] Entity creation syncing
[x] Entity desctruction syncing
[x] Entity upgrade syncing
[x] Dyson spheres syncing
[x] Researches syncing
[x] Factories statistics syncing
[x] Containers inventory syncing
[x] Building Interaction syncing
[x] Belts syncing
[x] Trash (dropped items) syncing
[x] Interstellar Station syncing
[x] Drones events syncing
[x] Foundation syncing (terrain deformation)
[x] Server state persistence
[x] Power network syncing (charger and request power from dyson sphere)
[x] Warning alarm syncing

List of combat mode syncing features

[x] Sync settings of new building (BAB, turrets)
[x] Sync combat settings
[x] Sync DF ground enemy create/destroy events (factory.enemyPool)
[x] Sync DF ground units activate/deactivate event
[x] Sync DF space enemy create/destroy events (spaceSector.enemyPool)
[x] Sync DF space units activate/deactivate events
[x] Sync DF planet base exp level and threat
[x] Sync DF space hive exp level and threat
[x] Sync loot and loot filter table
[x] Sync mecha shooting weapons
[x] Sync mecha bombing
[x] Sync mecha death and respawn animation
[x] Sync mecha personal shield to block projectiles
[x] Sync DF base awake events (player lock with weapon, player nearby, under attack)
[x] Sync DF base threat and launch assault event
[x] Patch DF unit to search for nearest alive mecha (sensor range)
[x] Patch DF turret to search for nearest alive mecha (attack when within attack range or counterattack)
[x] Sync the hatred targets changes so DF units are attacking the same target
[x] Sync building repair drone (imperfect)
[x] Sync building kill event (server fully authorized)
[x] Sync building reconstruct event
[x] Sync DFRelay ArriveBase/ArriveDock/LeaveBase/LeaveDock events
[x] Sync Remove base pit event
[x] Sync TryCreateNewHive, DispatchFromHive events
[x] Sync hive realize and open/close preview events
[x] Sync DF hive awake events (player lock with weapon, player nearby, under attack)
[x] Sync DF hive threat level and launch assault event
[x] Patch DF unit to search for nearest alive mecha (sensor range)
[x] Patch DF turret to search for nearest alive mecha (attack when within attack range or counterattack)
[x] Show base/hive/relay invasion events in chat
[ ] Sync kill stats
[ ] Enable Dark Fog communicator (aggressive change and truce)
[ ] Show remote mecha combat drone fleet
[ ] Show remote mecha space craft fleet
[ ] Show ground-to-space attacks animation on client for remote planets (missile turrets, plasma cannon)
[ ] Show space-to-ground attacks animation for remote planets (lancers invading with sweep laser and bomber)

How can I contribute?

Please join our Discord Server to ask if someone is already working on the task that you want to do. Once, you are done with your modification, simply submit a pull request. Contribution documentation can be found here: Wiki.

How can I support the team?

If you like what we do and would like to support us, you can donate through our Patreon. Thanks for the support <3

Changelog

0.9.3:

@starfi5h: Change chat message format. Player's name now has an underlined link to navigate
@starfi5h: Add new config option Chat - Show Timestamp to enable/disable timestamp before the chat message
@starfi5h: Add new CLI arugment /newgame-cfg to load the parameters from the config file nebulaGameDescSettings.cfg
@starfi5h: Add new chat command /dev
@starfi5h: Fix inventory error in client
@starfi5h: Fix hp bar doesn't vanish after deleting the building when client joins
@starfi5h: Fix enemies and ILS related errors

0.9.2:

Compatible to Steam version 0.10.29.22015 or Game Pass version 0.10.29.21943
@sk7725: Added Korean font and TextMeshPro fallback
@starfi5h: Add new chat command /playerdata
@starfi5h: Launch construction drones if local player is closer or within 15m
@starfi5h: Fix error when activating super nova in the turret window
@starfi5h: Fix desync of dyson sphere when client joins the game
@phantomgamers: Log expected game version and review code

0.9.1:

Support combat mode syncing (game version 0.10.29.21950)
@starfi5h: Implement basic combat syncing framework
@starfi5h: Add new config option EnableBattleMessage to show battle notifications
@starfi5h: Add map ping: when chat is open, Ctrl+Alt+LeftClick on the planet can create a link in chatbox
@mmjr, @phantomgamers, @sp00ktober: Review code and provide suggestions

0.9.0:

Now compatible with Dark Fog game version (DSP 0.10.x). Combat mode is not supported yet.
@phantomgamers: fix compilation after update and overall fixes/cleanup
@phantomgamers: fix UIVirtualStarmap patches
@phantomgamers: reviewing code from other contributers
@starfi5h: fix runtime issues after the update and overall fixes/cleanup
@starfi5h: improve UI and Keybinding
@starfi5h: rework Wireless Power Tower syncing
@starfi5h: add syncing for Battlefield Analysis Base
@mmjr: disable dark fog switch in lobby and prevent df enabled saves to be loaded.
@ajh16: sync dark fog lobby settings
@highrizk: sync storage filters
@highrizk: update serializer and fix broken packets
@highrizk: add serialization support and unit tests for dictionaries
@zzarek: add turret UI syncing
@sp00ktober: add syncing for new mecha settings and features
@sp00ktober: sync mecha and battle base construction drones
@sp00ktober: overall NRE fixes

0.8.14:

@starfi5h: Fix mecha animation when player count > 2
@starfi5h: Fix UIPerformance save test in multiplayer
@starfi5h: Disable build/dismantle sounds when too far away
@starfi5h: Convert strings to string.Translate() to enable translation

All changes

0.8.13:

@starfi5h: Fix compilation with 0.9.27.15466
@starfi5h: Add -newgame launch option for dedicated server

0.8.12:

@PhantomGamers: Remove exe targeting to support game pass version
@starfi5h: Fix errors about logistic bots
@starfi5h: Add -load-latest launch option for dedicated server

0.8.11:

@starfi5h: Added support for DSP 0.9.27 along with syncing for the new logistics distribution system
@starfi5h: Optimized network traffic
@starfi5h: Dedicated servers will now save when gracefully exited (ctrl+c on the console window)
@starfi5h: Fix error when sail capacity increases in dedicated server

0.8.10:

@starfi5h: Fix compilation with 0.9.26.13034
@starfi5h: Fix a bug that makes advance miner power usage abnormal
@starfi5h: Add new chat settings NotificationDuration

0.8.9:

@PhantomGamers: Fixed compilation with 0.9.26
@starfi5h: Added syncing of all of the new Sandbox features introduced in 0.9.26
@starfi5h: Fixed bug that caused the host to sink into the ground
@starfi5h: Increased connection timeout to prevent issues with higher latency connections

0.8.8:

@starfi5h: Added RemoteAccessPassword setting for servers so that users can authenticate to use admin commands
@starfi5h: Fixed bugs related to headless servers
@starfi5h: Chat now stores past commands, accessible with the up and down arrow keys
@PhantomGamers: Fixed white window popping up while headless server is running
@starfi5h: Added syncing for Logistic Station names
@starfi5h: Fixed bug that allowed clients to reduce ILS warp distance below their minimum value
@starfi5h: Added syncing for Mecha energy production and consumption stats
@starfi5h: Made it so new clients now join the game with full energy and some warpers if the tech is unlocked
@starfi5h: Fixed bug when running GalacticScale that caused clients to sink into the ground
@starfi5h: Removed IP addresses from log output

0.8.7:

@mmjr-x: Add Upnp/pmp support
@mmjr-x: Add Ngrok support
@mmjr-x: Add server password support
@PhantomGamers: Add Discord rich presence support
@PhantomGamers: Fix error when unable to obtain documents folder
@starfish: Add headless server support
@starfish: Add player connect/disconnect message (can be disabled in config)
@starfish: Fix NRE when loading a gas giant. Fix planet type mismatch caused by older saves.

0.8.6:

@starfish: Bugfix regarding NRE exception in UpdateDirtyMeshes()
@starfish: Bugfix desync issues regarding ILS and PLS
@starfish: Add milestone syncing
@sp00ktober: Add gracefull error messages regarding broken traffic monitors and broken compression of factory data
@sp00ktober: Add a reconnect command to the chat for easy and fast reconnection of clients

0.8.5:

@starfish: Add Dyson Sphere color syncing
@starfish: Add syncing for fast insert / fast take out of items to / from buildings
@starfish: Add syncing for fractionator and power generator product
@starfish: Save game to Last Quit when exiting multiplayer game.
@starfish: Fix a bug that would lead to an inserter's filter to not set correctly
@starfish: Fix planet terrain not synced when client loads a factory.
@starfish: Fix trash item count incorrect when item count > 256.
@sp00ktober: UI adjustments to account for the game update
@sp00ktober: Disable metadata upgrades for clients in tech tree
@sp00ktober: Add syncing for fast insert / fast take out of items to / from belts

0.8.4:

@kremnev8: add two new events to Nebula API
@starfish: fixed issue where client would sometimes be unable to load in while using GalacticScale
@starfish: custom planet and star names now show up in lobby (not while GalacticScale is active)
@starfi5h: show correct resource amount in UIPlanetDetail
@starfi5h: show custom planet and star names in lobby screen
@starfi5h: the selected starting planet name will now show on the lobby screen
@starfi5h: fixed issue where the nametag on the minimap wouldn't show up for a client that rejoined

0.8.3:

@kremnev8: improved ingame chat
@starfish: added compatibility with BulletTime which enables fluent loading times on Planet and System arrival
@starfish: bugfix regarding too large dyson sphere data
@starfish: bugfix regarding reloading of dyson sphere
@starfish: improved loading of solar systems, this now runs on its own thread
@starfish: developer commands can now be executed from the ingame chat (using /xconsole [command] )
@sp00ktober: added tooltips to the Nebula settings
@sp00ktober: added setting to prevent System.ObjectDisposedException errors resulting in random client disconnect
@sp00ktober: added code to handle IndexOutOfBounds errors when importing PlanetFactory data (very rare issue)
@sp00ktober: fixed wrong array size for storage and slots in ILS
@sp00ktober: added minimap indicator for other players positions (on the same planet)
@sp00ktober: added chat command to list planets in a system
@sp00ktober: added chat command to navigate to star, planet or player by name or id

0.8.2:

@kremnev8: fix issue with EmojiDataManager when a save was loaded multiple times in a row.

0.8.1:

@starfish: Add copy&close error button
@starfish: bugfixes regarding dyson sphere editor
@starfish: bugfix regarding item refund in matrix labs
@starfish: bugfix regarding the ILS UI
@starfish: bugfix regarding placement of spraycoaters, traffic monitors and inserters
@starfish: bugfix regarding drone and ship counts in stations
@PhantomGamers, @sp00ktober: adjust TCP fragment size for faster data transmission
@sp00ktober: bugfix regarding players getting stuck with the "player joining" message
@sp00ktober: bugfix regarding wrong mecha color until hitting "apply" in mecha editor
@sp00ktober: bugfix regarding ILS ship rendering clientside
@sp00ktober: add optional soil syncing
@sp00ktober: add syncing of mecha editor state and items
@mattsemar, @kremnev8: add in-game chat functionality with commands (open with Alt + ~ by default)

0.8.0:

Now compatible with DSP 0.9.24
@starfish: Refactoring of the ILS UI making it more stable and accurate
@starfish: Update Dyson Sphere syncing to match the new features of the game update
@starfish: Add UPS syncing to the game making the overall game state more accurate
@starfish: Updates for the proliferator and advanced miner
@starfish: Bugfix for wrong objId
@sp00ktober: Rework ILS ship rendering to be more accurate for clients
@sp00ktober: Rework ILS item adding (into stations) to be more accurate for clients
@sp00ktober: Bugfixes related to belts placed with a filter set
@sp00ktober: Add syncing of MechaAppearance
@sp00ktober: Fixed a bug that would lock the host with the "player joining" message when multiple clients try to join at the same time

0.7.10:

@starfish: Added WarningSystem syncing
@PhantomGamers: Fixed case of NRE when arriving on another planet
@PhantomGamers: Fixed issue where Universe Exploration tech would break while in a multiplayer game

0.7.9:

@sp00ktober: gracefully tell older nebula versions that there is a mod version missmatch.
@sp00ktober: fix planet detail ui stuck in lobby mode while in game.
@starfish: fix jaggy remote player movement

0.7.8:

@sp00ktober: Added Lobby feature where you can preview solar systems and choose your birth planet.

0.7.7:

@starfi5h, @PhantomGamers: Fixed issue where research removed by clients would not be synced.

0.7.6:

@starfi5h: Added syncing of ray receiver output
@starfi5h: Fixed lighting of remote players
@starfi5h: Fixed clients receiving duplicate items when cancelling manual research

0.7.5:

@sp00ktober: Fixed error caused by warning system introduced in previous update
@PhantomGamers: Fixed compatibility with DSP 0.8.23.9989

0.7.4:

@sp00ktober: adjusted mod to be compatible with game version 0.8.23

0.7.3:

@PhantomGamers: Fixed error when upgrading blueprint previews.
@sp00ktober: Added hotfix to prevent error caused by ILS ships

0.7.2:

@sp00ktober: Fixed issue where the host would render buildings placed by players on other planets on his current planet.

0.7.1:

@starfi5h: Fixed research desync issues
@sp00ktober: Fixed error when client upgrades buildings on different planet from the host.
@PhantomGamers: Fixed compatibility with DSP 0.8.22.9331+

0.7.0:

@phantomgamers: Fixed instance where error would trigger by loading saves made on earlier Nebula versions. WARNING: All previous client inventory and position data will be lost! (should be for the last time!)
@phantomgamers: Fixed error that was triggered by the client loading a planet after traveling to a different planetary system
@phantomgamers: Fixed error that was triggered by the client warping outside of a planetary system
@starfi5h: Added syncing of solar sails and rockets when client does not have the planet they originated from loaded.
@sp00ktober: Implemented smooth loading of factories for clients (fixed clients phasing through planet when flying too fast)

0.6.2:

Fixed error when loading saves that were created before 0.6.0. WARNING: All previous client inventory and position data will be lost!
Improved compatibility with GigaStations mod (thanks to @kremnev8)
Removed extraneous dlls that were mistakenly included in the previous release
Now supports DSP version 0.8.22.8915+ (thanks to @starfi5h!)

0.6.1:

Fixed statistics syncing (thanks to @starfi5h)
Fixed audio playing for all players when pasting building settings and warping (thanks to @starfi5h)
Added syncing for footstep and landing sounds (thanks to @starfi5h)

0.6.0:

Fixed cases where a multiplayer session could hang on the player joining screen.
Fixed issue where foundations built by clients would not sync to other clients.
Fixed issue where the user would not be informed if they were kicked due to a mod mismatch.
Enabled pausing in Multiplayer when no clients are connected. (thanks to @starfi5h)
Now supports DSP version 0.8.21.8562+ (also thanks to @starfi5h!)
Mecha color configuration has been removed from the options in favor of the new option in the Mecha panel

0.5.0:

Added API that enables other mods to sync over multiplayer! (Big thanks to @kremnev8!)
Fixed a bug that caused sorters to break when a client built a belt under preexisting sorters.
Fixed a bug that resulted in the client getting an error after disconnecting from a game that the host left.
Refactored session architecture (big changes to codebase but should be seamless to users)

0.4.0:

Nebula now supports DSP version 0.8.20.7962+

0.3.1:

Fixed issue where if client didn't have enough items to upgrade, the buildings would still be upgraded for the host.
Clients will now retain their detail display settings between sessions (e.g. power grid visibility) (thanks to @Needix)
Fixed issue where players would be able to construct buildings made with blueprints even if they did not have the required items.
Fixed miscellaneous issues related to ILS ship movement
Fixed error related to host building foundations while on a different planet from the client

0.3.0:

Added support for blueprint update (0.8.x)
Improved player name tag rendering
Fixed newly introduced multithread issues

0.2.0:

initial release on thunderstore

Date uploaded	a month ago
Version	0.9.2
Download link	nebula-NebulaMultiplayerMod-0.9.2.zip
Downloads	5196
Dependency string	nebula-NebulaMultiplayerMod-0.9.2

Get the Thunderstore App

NebulaMultiplayerMod

By nebula

This mod requires the following mods to function

xiaoye97-BepInEx

nebula-NebulaMultiplayerModApi

PhantomGamers-IlLine

starfi5h-BulletTime

README