Webhooks
One Launcher. Infinite Worlds.
Subscribe to real-time events like game_launched, update_complete, or mod_installed to power your automation tools, Discord bots, or CI/CD pipelines.
Supported Event Types
NexusLaunch emits structured JSON payloads over HTTPS when specific lifecycle milestones are reached in the client or connected game sessions.
Configure your endpoint to listen for these triggers. All payloads include a signed HMAC-SHA256 header for verification.
game_launched
Fires when the executable starts. Includes process ID, launch arguments, and target title (e.g., Stellar Drift: Remastered).
update_complete
Triggers after a delta patch finishes downloading and verifying. Contains build version, manifest hash, and total bytes patched.
mod_installed
Emitted when a community mod is applied to the game directory. Reports mod ID, author slug, and dependency tree status.
session_terminated
Sent on graceful exit or crash. Includes uptime duration, exit code, and optional crash dump URL for telemetry.
Payload Examples
Inspect the raw JSON structure delivered to your callback URL. All timestamps follow ISO 8601 format.
game_launched Event
{
"event": "game_launched",
"timestamp": "2024-11-15T14:32:09Z",
"client_id": "nx_cl_8f9a2b1c",
"data": {
"title_id": "stellar_drift_2024",
"process_id": 48291,
"launch_args": ["-novid", "-force-d3d11"],
"user_handle": "Kaelen_Vex"
}
}
mod_installed Event
{
"event": "mod_installed",
"timestamp": "2024-11-15T15:10:44Z",
"client_id": "nx_cl_8f9a2b1c",
"data": {
"mod_id": "wd_thermal_overhaul_v3",
"author": "Gearhead_Devs",
"version": "3.2.1",
"dependencies_met": true,
"target_directory": "/Games/Stellar Drift/Mods/"
}
}
Validate incoming requests by checking the X-Nexus-Signature header against your webhook secret. Retry logic automatically attempts failed deliveries up to 5 times with exponential backoff.