Documentation
Install Noctica in your experience, connect it to your licence and configure it. You never need to edit any script other than Config.
How Noctica works
- Client protection watches each player's character for speed, jump and fly exploits and for tools that appear in the backpack or character.
- Server protection verifies what the client reports (a tool injected by an exploit does not exist on the server), applies your sanction, checks account age and blacklists on join, and challenges every client every 1.5 seconds: if the protection script was removed or hijacked, the player is removed.
- Licence check — when a server starts, Noctica validates your licence, then re-checks it every 10 minutes. On plans with detection logging, sanctions appear in your dashboard.
Installation
- Get a licence. Subscribe — your key appears in My Licenses once the payment is confirmed.
- Assign it to your game. In My Games, add your experience with its Place ID, then assign your licence to it.
- Insert the Noctica package into your place:
- the
Notica🐬Script (with itsConfig) →ServerScriptService - the
Notica🐬LocalScript →StarterPlayer › StarterPlayerScripts
Do not rename, move or edit anything except
Config. - the
- Allow HTTP requests: Studio → Game Settings → Security → Allow HTTP Requests = On.
- Paste your key in Config. Copy it from My Licenses and put it in
LicenseKey:ServerScriptService › Notica🐬 › ConfigLicenseKey = "NOCTICA-XXXX-XXXX-XXXX-XXXX", - Play-test, then publish. The Output window should show
[Noctica] Licence valid (…). Protection enabled.If not, see Troubleshooting.
Configuration
ServerScriptService › Notica🐬 › Config is the only file you edit:
return {
-- Your Noctica licence key (Dashboard → My Licenses)
LicenseKey = "NOCTICA-XXXX-XXXX-XXXX-XXXX",
-- Usernames refused when they join
BlackList = { "Username1", "Username2" },
-- Group ids: members are refused when they join
BlacklistedGroup = { 1234567 },
-- Minimum Roblox account age in days (0 = disabled)
MinAge = 15,
-- Sanction for detected exploiters: "Kick" or "Ban"
-- "Ban" = permanent ban on every place of your universe
Action = "Kick",
-- Turn individual protections on/off
Protections = {
Speed = true,
Jump = true,
Fly = true,
Tool = true,
},
}| Protection | Triggers when |
|---|---|
| Speed | WalkSpeed goes above 25 |
| Jump | JumpPower goes above 50 |
| Fly | a BodyVelocity, BodyGyro or BodyForce is added to the character |
| Tool | a tool exists on the client but not on the server |
| Integrity | the client stops answering the 1.5 s check (always on) |
If your game legitimately gives players more speed or jump power (power-ups, vehicles, gamepasses…) or uses BodyMovers on characters, set the matching protection to false to avoid kicking legitimate players.
Bans use Roblox's ban system and only work on live servers; in Studio the player is kicked instead.
Licences & transfers
- One licence protects one experience. Your plan includes one or more licences.
- The first assignment to a game is free. Moving a licence afterwards counts as a transfer: each plan allows a number of transfers per 30 days, with a cooldown between two transfers.
- Cancelling keeps your licences valid until the end of the paid period. After that they expire and protection no longer starts on new servers.
- If Noctica is temporarily unreachable, your game stays protected: the anticheat keeps running and the licence is re-checked later.
Troubleshooting
Open View → Output in Studio during a play-test and look for lines starting with [Noctica]:
| Message | What to do |
|---|---|
[Noctica] Licence valid (Professional). Protection enabled. | Everything works. |
No licence key: paste your key in Config → LicenseKey | LicenseKey is empty in Config. Copy your key from Dashboard → My Licenses. |
Licence rejected: NO_GAME_BOUND | Your licence is not assigned to a game yet. Assign it in Dashboard → My Licenses. |
Licence rejected: GAME_MISMATCH | The licence is assigned to another experience (universe). Transfer it to this one. |
Licence rejected: EXPIRED / SUSPENDED / REVOKED | Renew your subscription, or open a ticket if you think this is a mistake. |
Licence rejected: INVALID_KEY | LicenseKey is not a valid key. Copy it again from My Licenses. |
Licence server unreachable — protection enabled | HTTP requests are disabled, or Noctica is temporarily unreachable. Protection keeps running and the licence is re-checked every 10 minutes. |
BanAsync a échoué, fallback Kick | Normal in Studio: bans only work on live servers. The player is kicked instead. |
Recent licence checks from your servers (and their result) are listed on each licence's page in the dashboard.
Security
- Keep Config in ServerScriptService. Players never receive anything stored there, so exploiters cannot read your key. Never copy the key into a LocalScript, a StringValue or anything in ReplicatedStorage, Workspace or StarterGui.
- Anyone who can edit your place (collaborators, plugins, free models with server scripts) can read Config. Only give edit access to people you trust.
- Advanced: you can leave
LicenseKeyempty and store the key in Creator Hub → Secrets under the namenoctica_license(domainnoctica.argius.xyz) instead. - Your key only works for the experience it is assigned to. If you think it leaked, open a ticket: we revoke it and issue a new one.
- Keys are stored encrypted on our side; every time you reveal one in the dashboard it is logged.
Still stuck? Open a support ticket.