menu_bookDocumentation

Testing Multiplayer: New Instances, Hotloading, and Local Connect

calendar_today May 20, 2026 schedule ~1 min read person PatrickJr verified 50

s&box provides built-in tools for testing multiplayer without needing another player. You can spawn additional game instances that join your running session, with live code hotloading across all connected clients.

Spawning a New Instance

Click the network status icon in the editor header bar and select "Join via new instance." A second game window appears and joins your session automatically.

Live Code Iteration

While the second instance is connected, you can continue coding on your main instance. Code changes are mirrored to all connected clients (including friends who joined) via hotloading — no restart needed.

Manual Connection

Open a second instance and run connect local in the console to manually join your local editor session.

Reconnecting

If a client disconnects, use the reconnect console command to rejoin without restarting.

Workflow

  1. Press Play in the editor (starts hosting)
  2. Click network icon → "Join via new instance"
  3. Test multiplayer interactions between the two windows
  4. Make code changes — both instances hotload automatically
  5. Use reconnect if the second instance drops
Was this helpful?