Torch Plugin Configs

Please make sure to use the correct Nexus version in the Torch Client. Nexus V3 uses the ‘Nexus Global (NexusV3)’ torch plugin. When torch servers are hosted on the same machine and environment as the controller, you can simply use the local/internal IP of ‘127.0.0.1’ which points the networking basically to itself. If the controller is on another box within the same network, local IPs can be used.

Networking Settings link

In this version, two ports must be configured to match those described in the controller. If you have changed these values, you will need to change the respective values in ALL of the torch plugin configs.

Setting Default Description
Controller IP 127.0.0.1 The IP address of the machine running the Nexus Controller
Subscriber Port 3100 Must match the controller’s subscriber port
Publisher Port 3101 Must match the controller’s publisher port
Server ID 10 Must match the Server ID configured for this server in the controller

Network Encryption link

Network encryption is optional and secures network traffic between controller and torch servers using AES-256 CBC encryption.

Setting Default Description
Enable Network Encryption false Enables encryption of all network traffic between controller and this server
Network Encryption Key (random GUID) Encryption key shared between controller and server - must match on both

Setup Summary:

  1. On controller: Settings → Network Configs → Check “Enable Network Encryption” → Click “Generate New Key”
  2. Copy the generated GUID key
  3. On each torch server: Plugin UI → Check “Enable Network Encryption” → Paste the key
  4. Restart controller and all torch servers

Critical Requirement: All connected servers must have the same encryption key for successful communication.

For complete setup instructions, troubleshooting, and best practices, see the Network Encryption guide.

Warning

If you enable encryption, ALL torch servers connecting to this controller MUST have encryption enabled with the EXACT SAME key. If keys don't match, servers will fail to communicate and you'll see decryption errors in the logs.

Warning

The Publisher and Subscriber ports for each instance MUST be open to the controller and vice versa. It is highly recommended when opening the ports that you restrict the network travel to only authorized IPs of the controller and servers to prevent any un-authorized traffic. Please read through the networking setup at the beginning of this documentation.

Warning

When dealing with networks outside of your sphere of control, please make sure to use caution and understand network safety. Port-forwarding and firewalls may need to be adjusted to talk to other networks internally (LAN) or globally (WAN). It is assumed that you understand how to allow communication in such a manner.

Local Plugin Settings link

When a server is not assigned to a Config Group in the controller, the following settings are configured locally in the torch plugin config. If a Config Group is assigned, these local values are overridden by the group’s settings.

Sync & Transfer Settings link

Setting Default Description
Enable Chat Sync false Enables cross-server chat message synchronization
Enable Respawn Sync false Enables cross-server respawn point sharing
Enable Respawn Share false Allows sharing medical blocks via custom data (Steam IDs / faction tags)
Enable Grid Jump With Suits true Allows players in suits (without a grid) to transfer across sector boundaries
Transfer Static Grids false Allows static (station) grids to be transferred across sector boundaries
Allow Inbound NPCs false Allows NPC grids to be transferred into this server
Allow Outbound NPCs false Allows NPC grids to be transferred out of this server

Chat & Display Settings link

Setting Default Description
Enable Server Abbreviations false Prepends the server abbreviation to cross-server chat messages
Enable Chat Broadcaster Channel Everyone true Allows Laser Antennas to broadcast to “Everyone” across the cluster (see Laser Antenna Broadcaster)
MOTD Title (empty) Message of the Day title shown to players on join
MOTD (empty) Message of the Day body text

Safety & Maintenance Settings link

Setting Default Description
Disable Character Collisions false Disables character-to-character physics collisions
Wipe Grids In Incorrect Sectors On Startup false Removes grids that are in a sector belonging to another server on startup
Auto Yeet Corrupted Entities false Automatically removes corrupted entities that could cause issues
Enable Action Relay Sync true Enables synchronization of action relay block events across servers

Debug link

Setting Default Description
Debug Mode false Enables verbose logging for troubleshooting

Tip

If you are having issues with server connections or transfers, enable Debug Mode temporarily to get detailed logs. Remember to disable it when done as it significantly increases log output.