Trace Lua API - Exceptions, Zones, and Integrations

The Trace Lua API is exposed as _G.Trace on the server after the Trace loader initializes. You can use it to authorize intentional player movement so the anticheat system does not flag it as cheating, register persistent movement zones, and add slash commands to Trace Chat. All calls must originate from trusted server scripts - client scripts have no access to this API.

Resolving the API

If your script runs after Trace has already initialized, access the API directly:

local Trace = _G.Trace
assert(Trace, "Trace must be initialized before using the API")

If your script may run concurrently with Trace initialization, wait for it to become available:

local Trace
repeat task.wait() until _G.Trace
Trace = _G.Trace

_G.Trace is only populated after Trace has fully initialized on the server. Scripts that run immediately at game start should use the wait-loop pattern above to avoid receiving nil.

Security model

All API functions must be called from trusted server scripts only. Client scripts cannot call this API - any attempt by a client to grant itself a movement exception is treated as a violation by the anticheat system, not as a legitimate request.

API surface

The following functions are available on _G.Trace. Click the linked pages for full parameter documentation.

Name	Description
`Notify`	Send a normal Trace notification to a specific player
`NotifyImportant`	Send an important-level Trace notification
`CriticalAlert`	Send a critical-level Trace alert
`Punish`	Apply a Trace warning or ban to a player through the moderation pipeline
`BeginMovementException`	Start a named movement exception for a player and receive a token
`EndMovementException`	End an active movement exception using the token from `BeginMovementException`
`ClearMovementExceptions`	Clear all active movement exceptions for a player at once
`IsMovementExempt`	Check whether a player currently holds any (or a specific) movement exception
`WithMovementException`	Run a callback inside a scoped movement exception that is always cleaned up
`AllowTeleport`	Shorthand to open a brief teleport window before using `PivotTo` or similar
`AllowMovement`	Alias of `BeginMovementException`
`RevokeMovementException`	Alias of `EndMovementException`
`RegisterMovementZone`	Register a Workspace part or model as a persistent movement zone
`UnregisterMovementZone`	Permanently remove a zone registration
`SetMovementZoneEnabled`	Enable or disable a zone without removing it
`GetMovementZones`	Return a list of all currently registered zone summaries
`RegisterChatIntegration`	Add a slash command to Trace Chat
`UnregisterChatIntegration`	Remove a previously registered slash command

Each method page contains full parameter documentation, return value descriptions, and copy-ready code examples. Use the sidebar or the links in the table above to navigate to the page you need.

Overview

Notifications & Moderation

Movement

Trace Lua API - Exceptions, Zones, and Integrations

Resolving the API

Security model

API surface

​Resolving the API

​Security model

​API surface

Resolving the API

Security model

API surface