Exports

Whitelisting

Whitelisting tells the anticheat that a specific player action is legitimate for a short window, so it isn't flagged. Use these when your framework or admin tools legitimately teleport, heal, revive, or buff a player. Durations are in milliseconds; the default is 5000ms.

Keep windows tight. The client-side grace is capped at ~55 seconds; longer durations are still honored server-side, but a permanent whitelist defeats detection. Whitelist right before the action and let it expire.

SolarAC__WhitelistTeleportServer

SolarAC__WhitelistTeleport(src, durationMs?)

Allows a position change (SetEntityCoords / teleport) within the window without triggering teleport detection.

Parameter	Type	Description
src	number	Connected player id.
durationMs	number?	Trust window in ms. Defaults to 5000.

lua

exports['SolarAC']:SolarAC__WhitelistTeleport(src, 4000)
SetEntityCoords(GetPlayerPed(src), x, y, z, false, false, false, true)

SolarAC__WhitelistHealthRefillServer

SolarAC__WhitelistHealthRefill(src, durationMs?)

Permits health / armour writes (SetEntityHealth, SetPedArmour, AddArmourToPed, SetPlayerMaxArmour) for the window.

Parameter	Type	Description
src	number	Connected player id.
durationMs	number?	Trust window in ms. Defaults to 5000.

lua

exports['SolarAC']:SolarAC__WhitelistHealthRefill(src, 3000)
-- now your heal logic runs without a godmode / health false-positive

SolarAC__WhitelistInvincibleServer

SolarAC__WhitelistInvincible(src, durationMs?)

Permits invincibility / damage-proof writes (SetPlayerInvincible, SetEntityInvincible, SetEntityCanBeDamaged, SetEntityProofs).

Parameter	Type	Description
src	number	Connected player id.
durationMs	number?	Trust window in ms. Defaults to 5000.

SolarAC__WhitelistReviveServer

SolarAC__WhitelistRevive(src, durationMs?)

Marks an upcoming revive as legitimate (commonly paired with health refill for ambulance / EMS scripts).

Parameter	Type	Description
src	number	Connected player id.
durationMs	number?	Trust window in ms. Defaults to 5000.

SolarAC__WhitelistInvisibleServer

SolarAC__WhitelistInvisible(src, durationMs?)

Permits visibility toggles (e.g. admin spectate / cutscene staging) without flagging invisibility.

Parameter	Type	Description
src	number	Connected player id.
durationMs	number?	Trust window in ms. Defaults to 5000.

SolarAC__WhitelistStaminaServer

SolarAC__WhitelistStamina(src, durationMs?)

Raises sprint-stamina thresholds for the window — use for buff items / scripted sprint effects.

Parameter	Type	Description
src	number	Connected player id.
durationMs	number?	Trust window in ms. Defaults to 5000.

SolarAC__IsPlayerWhitelistedServer

SolarAC__IsPlayerWhitelisted(whitelistType, src)

Returns whether a player currently holds an active whitelist of a given type. Types: teleport, healthRefill, revive, invincible, invisible, stamina.

Parameter	Type	Description
whitelistType	string	One of the whitelist types listed above.
src	number	Connected player id.

Returns: boolean

lua

if exports['SolarAC']:SolarAC__IsPlayerWhitelisted('teleport', src) then
  -- a teleport grace is currently active for this player
end

SolarAC__FixPlayerServer

SolarAC__FixPlayer(src, fixType, data?)

Server-to-client correction helper. Asks the client to fix its own state and opens the matching short whitelist automatically. fixType is "health" or "position".

Parameter	Type	Description
src	number	Connected player id.
fixType	string	"health" or "position".
data	table?	Optional payload passed to the client fix handler.