License & Server IP

Your license key is what switches CXA Anticheat on. When your server starts, it sends the key to codexart.net, receives your configuration and keeps checking the license while it runs. This page explains how to get a key, how to redeem and extend it, and why one license works on exactly one server IP.

One License, One Server IP

The first server that starts with your key binds the license to its IP address, and only CXA staff can move it. Start the key on the server you want to protect, never on a test machine first.

How It Works

  1. You buy a plan on the CXA Anticheat page. The key is sent to you by email.
  2. The license is linked to your codexart.net account, either automatically or when you redeem the key in the panel. Its time starts at that moment.
  3. You put the key in server.cfg and start the server.
  4. The server sends the key to codexart.net. The first server that does this with an active license binds its IP address to the license.
  5. While the server runs, it checks the license regularly and picks up configuration changes within a minute.
  6. CXA keeps a signed copy of the last verified license status and configuration in data/remote_cache.json. If codexart.net cannot be reached, the server keeps protecting with this copy for a limited time.

The License Key

A key looks like CXA-XXXXX-XXXXX-XXXXX-XXXXX. You add it to server.cfg with set cxa_license, or to SvConfig.License.Key in sv_config.lua. Setup shows both ways step by step.

# Use "set", so the key stays on the server and is never sent to players
set cxa_license "CXA-XXXXX-XXXXX-XXXXX-XXXXX"
ensure cxa-anticheat

To find your key again, open the panel, open your license and look at the Installation card on the Overview tab. The License key field is masked; use Show to reveal it or the copy button to copy it. The Installation card also has a ready server.cfg snippet with a Copy button.

Only the owner of the license and team members with the Admin role can see the key. Everyone else sees "Only owners and admins can see the key".

Buying a License

All plans (1, 3 and 6 months, and yearly) have exactly the same features; they only differ in length. Compare them on the CXA Anticheat page.

After the payment you receive an email with the subject "Your CXA Anticheat license" (in Turkish if your account language is Turkish). It lists every key you bought. What happens next depends on whether the purchase can be matched to your codexart.net account:

CaseWhat happensWhen the time starts
The purchase matches your accountThe license is added to your account and is active right away. The email says "The license is linked to your account and already active."At purchase
The purchase does not match an accountThe key waits until someone redeems it. The email says "Sign in to the panel and redeem the key; the time starts when you redeem it."When the key is redeemed

A purchase matches your account when the email address you enter at checkout is the email address of your codexart.net account. CXA also tries the Discord and Cfx.re accounts linked to your codexart.net account.

Buying for Someone Else

If you buy a license for another person, for example a developer buying for a server owner, use an email address that is not linked to your own codexart.net account. The key then stays unredeemed until the server owner redeems it on their own account, and the time only starts then.

Redeeming a Key

Redeeming links an unredeemed key to your codexart.net account and starts its time.

  1. Go to codexart.net/anticheat/panel and sign in with your codexart.net account.
  2. On the Your licenses page, find the Redeem a license key card.
  3. Paste the key into the field.
  4. Leave the selector on Activate as a new license.
  5. Click Redeem.

The panel shows "License activated" and opens the new license. The end date is the redemption date plus the plan length: 30 days per month, or 365 days for the yearly plan. If your server was already running with this key, it picks up the redemption at its next check, within a minute.

The Redeem button stays disabled until the full key (27 characters, including the dashes) is in the field. You can try 10 redemptions every 15 minutes; after that the panel shows "Too many attempts, try again later."

Extending a License

To add time to a license you already own, redeem a new key on top of it instead of activating it as a new license.

  1. Buy a new key on the CXA Anticheat page. The Extend license button on the Overview tab takes you there.
  2. Open the Your licenses page in the panel.
  3. Paste the new key into the Redeem a license key card.
  4. In the selector, choose Extend: followed by your server name (or the license number if the server has no name yet), for example Extend: My Server.
  5. Click Redeem. The panel shows "License extended".

What extending does:

  • The new key's days are added to the days you have left. If the license has already expired, the days are counted from today.
  • It is still the same license. The key in server.cfg, the locked IP, your configuration and your team stay the same, so you don't need to change anything on the server.
  • A running server notices the extension at its next check and switches protection back on by itself.
  • The key you used is merged into the license. It no longer appears in your list and cannot be started on a server.
  • Only the owner can extend a license. Team members do not see it in the selector and get "Only the owner can extend this license." if they try.
  • Extending a suspended or revoked license adds the days, but the license stays suspended or revoked.
  • A license can run for at most 1 year from today. For example, a 3-month license plus another 3-month key becomes 6 months, but a key that would push the end date more than 365 days ahead is refused. The panel tells you the date from which you can add it, or you can activate it as a new license instead. The key is not used up when it is refused.

If the New Key Was Linked Automatically

If your purchase matched your account, the new key was created as a separate, already active license. It appears as a second license in your list and cannot be redeemed again: the panel shows "This key was already redeemed." In that case, open a ticket on your dashboard and include both license numbers, for example #1024 and #1031.

License Statuses

The panel shows a status badge on every license. Your server prints a matching line in the console at its next check.

Status in the panelMeaningWhat your server prints
ActiveThe license works.License verified (remote), configuration v3.
Not redeemedThe key exists but is not linked to an account yet. It only appears in your list after you redeem it.License key is not redeemed yet, redeem it in the panel first.
ExpiredThe end date has passed.License has expired, renew it on codexart.net/anticheat.
SuspendedCXA staff has put the license on hold. Open a ticket on your dashboard.License is suspended, contact Code X Art support.
RevokedCXA staff has cancelled the license.License is revoked.
MergedThe key was used to extend another license. It is hidden from your list.License key is not valid.

Whenever the license is not usable, a second line follows with the short reason, for example:

Output
[CXA] License has expired, renew it on codexart.net/anticheat.
[CXA] Anticheat is not active: expired

One License, One Server IP

Each license works on one server IP address. This keeps a leaked or shared key from protecting servers it was not bought for.

  • The license binds to the IP of the first server that connects to codexart.net with it while the license is active.
  • The bound address is the public IP your server uses to reach codexart.net. On most hosts this is the same IP players connect to.
  • You see it on the Overview tab, in the Server card, as Locked IP. Before the first start it says "Not bound yet, first server to start takes it". Only the owner and admins can see the address.
  • A server on any other IP is refused. Its console shows the message below, and the Activity tab of the license records "Connection from another IP rejected" (at most once an hour).
Output
[CXA] This license is bound to another server IP. Every server IP needs its own license; open a ticket on codexart.net if you moved to a new host.

Test Servers and Second Servers

A test server, a development machine or a second server on another IP needs its own license. Buy another one on the CXA Anticheat page. The Overview tab has a Buy another license link for this.

Moving to a New Host

Only CXA staff can reset the locked IP; there is no button for it in the panel.

  1. Open a ticket on your dashboard and include your license number, for example #1024. Never post the full key.
  2. Stop the anticheat on the old server before the reset.
  3. After the reset, start the new server. It binds the license to its IP at its first check.

Stop the Old Server First

After the reset, the next server that connects with the key binds it. If the old server is still running, it can take the license back before the new one starts.

When the License Expires or codexart.net Is Unreachable

There are two different situations:

  • codexart.net answers that the license is no longer usable (expired, suspended, revoked, or another IP). Protection pauses at the next check, within a minute. Detections stop acting on players until the license is active again. After you renew or extend, the server switches protection back on by itself, without a restart.
  • codexart.net cannot be reached at all, for example because of a network problem. The server keeps protecting with the last verified configuration for up to OfflineGraceHours (72 hours by default), counted from the last successful check. When the connection comes back, everything continues normally.

If you restart the server while codexart.net is unreachable, CXA starts from the saved copy as long as the grace period has not run out:

Output
[CXA] Loaded cached configuration v3.
[CXA] License verified (cache), configuration v3.

If the grace period runs out before the connection comes back, protection pauses:

Output
[CXA] License could not be verified within the offline grace period, protection is paused.

The grace period never lets a license run past its end date. The saved copy is signed by codexart.net, so editing data/remote_cache.json by hand makes it unusable.

License Settings

These settings are in sv_config.lua, a server-only file that is never sent to players.

OptionKeyDefaultWhat it does
License keySvConfig.License.Key''Your key. Leave it empty to use set cxa_license from server.cfg.
API addressSvConfig.License.ApiUrlhttps://codexart.net/api/anticheatWhere the license is checked. Do not change it unless support tells you to.
Offline graceSvConfig.License.OfflineGraceHours72Hours the server keeps protecting with the saved copy while codexart.net is unreachable. The minimum is 1.
Auto reloadSvConfig.License.AutoReloadtrueReloads the anticheat when you save a new configuration in the panel.

Giving Your Staff Panel Access

Never hand out your key so that staff can use the panel. Add them to the license instead: open the license, go to the Team tab and add them by their codexart.net username or email with the Admin, Editor or Viewer role. Owners and admins can see the key and the locked IP; editors and viewers cannot. Team Access explains every role.

This is web panel access only. In-game commands and the in-game panel are controlled by Staff Roles & Command Access.

Keeping Your Key Private

  • Keep the key in server.cfg (with set) or in sv_config.lua. Never move it to config.lua, because players can read that file.
  • Never use setr or sets for the key. Both make the value visible outside the server.
  • Never post server.cfg, sv_config.lua or screenshots of them in public places.
  • Our support never needs your full key. Give your license number from the panel, for example #1024.
  • A key that has not been redeemed yet can be redeemed by anyone who has it. Redeem new keys soon after you receive them.

If you think your key has leaked, open a ticket on your dashboard.

The Folder Name Rule

The resource folder must be named exactly cxa-anticheat. The anticheat checks its own name when it starts, and codexart.net also refuses renamed copies. A renamed copy prints this line and does not protect your server:

Output
[CXA] This resource must be named cxa-anticheat (current: my-anticheat). Rename the folder and restart the server.

The Overview tab then shows a red banner, "The anticheat is disabled: the resource folder was renamed", and the Activity tab records "Server started with a renamed resource". Rename the folder back, change the line in server.cfg to ensure cxa-anticheat and restart the server.

Recommendations

Recommended:

  • Redeem new keys on the account that owns the server, so the owner can always extend and manage the team.
  • Start the key on your live server first, so the right IP is bound.
  • Give staff panel access through the Team tab instead of sharing the key.
  • Extend before the end date. The remaining days are kept, so you lose nothing by renewing early, as long as the new end date stays within 1 year from today.

Avoid:

  • Starting the key on a local PC or test machine "just to try it", because that machine binds the license.
  • Running the same key on two servers. The second one is refused.
  • Raising OfflineGraceHours to hide connection problems. Fix the firewall instead, so config changes and license checks reach your server.

Setup

  • Setup shows where the key goes and the console lines you should see.
  • Keep sv_config.lua when you update the resource, because it can hold your key.

Team Access

  • Team Access gives other codexart.net accounts access to the panel of this license.
  • Every change your team makes is recorded in the Activity tab.

Config Editor

  • Your configuration is stored with the license. The Config Editor changes it, and the server picks it up within a minute.
  • Extending a license keeps your configuration exactly as it is.

Contact & Tickets

  • IP moves, suspended licenses and leaked keys are handled through tickets. See Contact & Tickets.

Common Problems

"This license is bound to another server IP"

What you see: The console prints This license is bound to another server IP. Every server IP needs its own license; open a ticket on codexart.net if you moved to a new host.

How to fix it:

  • Start the key only on the server it is bound to. Check Locked IP on the Overview tab.
  • If you moved to a new host, open a ticket on your dashboard with your license number.
  • If this is a test or second server, buy an additional license.
  • If your host routes outgoing traffic through a different IP than the one players use, the license binds to that outgoing IP. Ask your host which one it is before you open a ticket.

"License key is not redeemed yet, redeem it in the panel first."

What you see: The server refuses to start the anticheat and prints this line.

How to fix it:

  • Redeem the key on the Your licenses page of the panel.
  • The server picks up the redemption at its next check. If nothing happens within a minute, restart the server.

"This key was already redeemed."

What you see: The panel shows this message when you click Redeem.

How to fix it:

  • The key is already linked to an account. Look for it in your license list; if your purchase matched your account, it was added there automatically.
  • If you wanted to extend another license with it, open a ticket as described in Extending a License.
  • If the key is linked to an account that is not yours, open a ticket on your dashboard.

"This license key is not valid." or "License key is not valid."

What you see: The panel or the server console rejects the key.

How to fix it:

  • Copy the key again from the email or the Overview tab instead of typing it. Keys never contain the letters I or O or the digits 0 and 1.
  • If you used this key to extend another license, it was merged. Put the key of the extended license in server.cfg instead.

I Don't See My License in the Panel

What you see: You bought a license, but Your licenses is empty.

How to fix it:

  • Check that you are signed in with the account whose email you used at checkout.
  • If the purchase did not match your account, the key is waiting in your email. Redeem it on the Your licenses page.
  • If you cannot find the email, open a ticket on your dashboard.

"License could not be verified within the offline grace period, protection is paused."

What you see: The server could not reach codexart.net for longer than OfflineGraceHours.

How to fix it:

  • Check that your host allows outgoing HTTPS connections to codexart.net.
  • Check that ApiUrl in sv_config.lua is still https://codexart.net/api/anticheat.
  • Protection resumes by itself at the first successful check. Restart the server if it does not within a minute.

The License Is Active, but the Server Says It Expired

What you see: The panel shows Active, but the console prints License has expired, renew it on codexart.net/anticheat.

How to fix it:

  • Check that the key in server.cfg or sv_config.lua is the key of the license you extended. A merged or old key does not change when you extend another license.
  • Remember that SvConfig.License.Key wins over set cxa_license when it is not empty.

© 2026 CodeXart Studios · CXA Anticheat