Skip to content

Whitelisting

Temporarily exempt one player from one detection, without weakening protection for everyone else.

Updated View as Markdown

Detections sometimes fire on someone who is not cheating: a developer testing noclip, a scripted cutscene that looks like godmode, a stunt event where vehicles behave unusually.

Whitelisting exempts one player from one detection for a limited time, rather than turning the detection off for everyone.

What a whitelist is

Part Value
Who A specific player
What A detection’s config name, or * for all of them
How long A fixed duration, or until the resource restarts

While active, that detection is skipped for that player. Everyone else is unaffected, and every other detection still applies.

Whitelists never persist

Whitelists are held in memory only. They disappear when the resource restarts — deliberately, so a forgotten entry can never leave someone exempt indefinitely.

From the admin menu

Open /asphyxia → Whitelists (needs the whitelistPlayers permission). Add whitelist asks for the player, the detection (or Every detection), and a duration from 15 minutes to Until the next restart. The table shows every active entry with a countdown; remove one with the bin icon.

Detection names

Whitelists use a detection’s config name from Detections, or print them in the console:

asphyxia detections

Names are not case sensitive and the display name also works, so noClip, noclip and "No-Clip Detected" are equivalent. An unrecognised name is refused rather than creating a whitelist that protects nobody.

From the server console

asphyxia whitelist 12 noClip 30  # exempt player 12 from noclip for 30 minutes
asphyxia whitelist 12 *           # exempt them from everything until restart
asphyxia unwhitelist 12 noClip    # clear one exemption
asphyxia unwhitelist 12           # clear all of them
asphyxia whitelists               # list what is active

From another resource

exports.asphyxia:whitelistPlayer(source, "vehicleBoost", 600)
exports.asphyxia:whitelistPlayer(source, "*")

-- Wrap scripted content that legitimately trips a detection:
RegisterNetEvent("myserver:cutsceneStart", function()
    exports.asphyxia:whitelistPlayer(source, "godMode", 120)
end)

RegisterNetEvent("myserver:cutsceneEnd", function()
    exports.asphyxia:removeWhitelist(source, "godMode")
end)

Full signatures are on Exports.

Using *

* exempts a player from everything. Always give it a duration where you can — an untimed * leaves that account completely unprotected until restart.

Auditing

Every whitelist added or removed is written to your audit log with who did it, who it applies to, which detection and for how long. Find it on the Logs page filtered to Admin action.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close