Nebula Local Resync

One-key recovery from Nebula multiplayer client desynchronization.

Nebula Local Resync adds a configurable hotkey that performs Nebula's built-in fast reconnect operation. It is intended for situations where the client has fallen out of sync with the host and Nebula's /reconnect command restores the session correctly.

The default shortcut is:

Ctrl + Shift + R

Pressing the shortcut invokes the same Nebula reconnect path used by the built-in:

/reconnect

No chat command needs to be typed.

When to use it

Use the hotkey when the local client appears desynchronized from the server, including symptoms such as:

• Dark Fog enemies that remain visible but cannot be targeted or attacked.
• Factory or combat state that no longer matches what the host is simulating.
• Other client-side synchronization problems that are corrected by Nebula's /reconnect command.

The mod does not attempt to guess which individual entity is wrong. Instead, it delegates recovery to Nebula's own established reconnect procedure.

How it works

Version 0.2.0 intentionally replaced the experimental local factory/enemy reconciliation used by earlier releases.

When the hotkey is pressed, the mod directly calls Nebula's fast reconnect operation—the same recovery path behind /reconnect. This avoids modifying live factory pools, enemy pools, belts, or other DSP simulation structures independently of Nebula.

Client only

Nebula Local Resync 0.2.0 is client-side only.

• Install it through Thunderstore or r2modman on the client that needs the shortcut.
• No companion installation is required on the dedicated/headless server.
• The server only needs its normal compatible Nebula installation.

Configuration

The shortcut can be changed in the BepInEx configuration file:

BepInEx\config\com.local.nebulalocalresync.cfg

Default configuration:

[Client]
ResyncHotkey = R + LeftShift + LeftControl

The existing ResyncHotkey setting name is retained so users upgrading from 0.1.x keep their configured shortcut.

Installation

Install and update the mod through Thunderstore/r2modman.

Do not manually install a second copy of the DLL into the same profile. Let the mod manager own deployment and updates.

Requirements

• Dyson Sphere Program
• Nebula Multiplayer Mod
• Nebula Multiplayer Mod API
• BepInEx dependencies supplied through the normal Nebula/Thunderstore dependency chain

Compatibility

Nebula and Dyson Sphere Program are actively updated. This mod intentionally relies on Nebula's own fast-reconnect implementation instead of maintaining a separate synchronization protocol.

If Nebula's reconnect API changes in a future release, the mod may require an update.

Version history

0.2.0

• Replaced experimental targeted factory/Dark Fog resynchronization with Nebula's built-in fast reconnect.
• Ctrl+Shift+R now performs the same reconnect operation as /reconnect.
• Removed all custom resync network packets and server-side synchronization code.
• Changed the mod to client-only operation.
• Preserved the existing configurable hotkey for upgrades from 0.1.x.

Changelog

0.2.0

• Replaced the experimental local factory/Dark Fog reconciliation system with Nebula's built-in fast reconnect operation.
• Ctrl+Shift+R now calls the same GameStatesManager.DoFastReconnect() path used by Nebula's /reconnect command.
• Removed all custom resync request/response packets and server-side synchronization logic.
• The mod is now client-only; no companion installation is required on the headless server.
• Preserved the existing Client.ResyncHotkey configuration key so upgrades retain the configured shortcut.
• Rewrote the Thunderstore Details page and package description to match the new reconnect-only functionality.
• Retained build/package-only behavior; the build process does not install files into r2modman.

0.1.4

• Changed Thunderstore/r2modman packaging so the mod manager owns deployment into the active BepInEx profile.
• Removed automatic profile installation behavior from the build script.

0.1.3

• Added experimental host-authoritative Dark Fog ground-enemy reconciliation.

0.1.0

• Initial experimental local host-authoritative resync implementation.