Skip to content
Documentation
[02]Licensing

Licence keys and server bindings

How a key activates a server, how to move to new hardware, and what happens when the licensing service is unreachable.

4 minute read

A licence permits a fixed number of concurrent production servers. Single is one, Network is five, Unlimited removes the cap. Licences never gate features — every tier receives the identical product.

One key per mod

Each mod you buy gets its own key, because each carries its own seat count. A server running three of our mods lists all three keys in one file; you never have to work out which key belongs to which mod.

Install the licensing agent

The agent is a single small executable that runs alongside your server. It is what talks to the licensing service, and the mod will not initialise without it. Run it as a Windows service or a systemd unit so it survives a reboot — it cannot be started by the mod itself.

Add your keys

Copy your keys from the account panel into profiles/SP_License/settings.json. The agent creates this file with a template on first start if it is missing.

json
{
  "licenseKeys": [
    "SP-XXXX-XXXX-XXXX-XXXX",
    "SP-YYYY-YYYY-YYYY-YYYY"
  ]
}

Binding is automatic

There is no IP to type anywhere. On first start the agent generates a random installation id, claims a seat, and the server appears in your account within a minute along with the address we actually saw. Nothing about your machine is read or transmitted — no hardware ids, no process list, no files.

Moving to new hardware

Release the old server from your account and the seat frees immediately — no cooldown, no ticket. The new server claims it the next time its agent checks in, or right away if you restart the agent.

If our service is unreachable

Your server keeps running. The agent caches a signed entitlement valid for 48 hours and keeps working for a further 24 beyond that while it retries, so a licensing outage on our side, or a network fault on yours, has to last three days before it touches your players.

Upgrading a tier

Upgrade from your account and pay only the difference against what you already paid. The key you already pasted into your server keeps working throughout — the seat count simply increases, with no reissue and no restart.