> ## Documentation Index
> Fetch the complete documentation index at: https://pure.saauf.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Trace: Download the .rbxm and Configure Your Place

> Download the Trace .rbxm from Pure Studio, import it into your Roblox place, unpack each component to the correct service, and configure webhooks.

Trace is distributed as a single `.rbxm` file that contains every server, client, and configuration module you need. To install Trace in your place, download the file from Pure Studio's official channel, import it into Roblox Studio, move each component into the service Trace expects, and configure your Discord webhook. Total setup time is under five minutes.

<Steps>
  <Step title="Download Trace.rbxm from our channel">
    Download the latest `Trace.rbxm` file from the official Pure Studio distribution channel (Discord). Always use the official source to make sure you are installing the current, unmodified release.
  </Step>

  <Step title="Import the .rbxm into your place">
    Open your place in Roblox Studio. Right-click **Workspace** in the Explorer, choose **Insert from File**, and select the `Trace.rbxm` you just downloaded. A `Trace` model appears under Workspace containing every component of the suite.

    <Tip>
      You can also drag `Trace.rbxm` directly onto the Explorer window. Either method produces the same `Trace` model.
    </Tip>
  </Step>

  <Step title="Unpack the model into the correct services">
    Trace ships as a single container so it imports cleanly, but its parts need to live in specific services to run:

    | Component                                                          | Destination service                    |
    | ------------------------------------------------------------------ | -------------------------------------- |
    | `MainModule` (server engine) and `TraceConfig`                     | `ServerScriptService`                  |
    | `Trace` RemoteEvent folder (contains `Signal` and `AdminFunction`) | `ReplicatedStorage`                    |
    | `TraceClient` and `TraceAdminPanel` (`LocalScript`s)               | `StarterPlayer → StarterPlayerScripts` |

    Once everything is in place, delete the now-empty `Trace` folder from Workspace.

    <Note>
      The Trace loader looks for its RemoteEvent folder in `ReplicatedStorage` and its module in `ServerScriptService`. If either is in the wrong service, the panel will not open and the anticheat will not start.
    </Note>
  </Step>

  <Step title="Configure your Discord webhook">
    Open **`ServerScriptService → TraceConfig`** and set the `Webhook` field to your Discord webhook URL:

    ```lua TraceConfig.lua theme={null}
    return {
        Webhook = "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL_HERE",
    }
    ```

    Replace `YOUR_WEBHOOK_URL_HERE` with the full webhook URL from your Discord channel's **Integrations** settings. Trace delivers ban notices, detection alerts, staff actions, and moderator calls to this endpoint.

    See [Discord webhooks](/configuration/discord-webhooks) for the full event catalog and how to route specific event types to different channels.
  </Step>

  <Step title="Enable the Roblox Ban API">
    If you plan to use Trace's ban system, open **Game Settings → Security** in Roblox Studio and enable `Players.BanningEnabled`. Without it, ban actions are logged but not enforced by Roblox.
  </Step>

  <Step title="Save and publish">
    Save your place and publish it. Anticheat, admin panel, and Discord integrations are live on the next server start. The Experience Owner must open the panel once and accept the Pure Studio License Agreement before Trace activates for other players.
  </Step>
</Steps>

## Updating Trace

To update to a newer release, download the latest `Trace.rbxm` from Pure Studio, import it, and replace each existing component with the corresponding one from the new import. Your `TraceConfig` values are preserved as long as you overwrite `MainModule`, `TraceClient`, and `TraceAdminPanel` without touching your configuration module.

## Server API for scripts

Trace exposes a Lua API on `_G.Trace` after the server module initializes. Trusted server scripts can send notifications, apply moderation actions, authorize movement, and register slash commands. See:

* [**API Overview**](/api/overview) - how to resolve `_G.Trace` and the full function list.
* [**Notifications**](/api/notify) - `Notify`, `NotifyImportant`, and `CriticalAlert`.
* [**Moderation**](/api/punish) - programmatically apply a warning or ban with `Punish`.
* [**Movement Exceptions**](/api/begin-movement-exception) - authorize custom teleports, vehicles, and scripted flight.
* [**Movement Zones**](/api/movement-zones) - register Workspace parts as persistent movement-exempt areas.
* [**Chat Integrations**](/integrations/chat-integrations) - add slash commands to Trace Chat.

## Next steps

* [**Admin Panel**](/features/admin-panel) - manage players and moderation in real time.
* [**Anticheat & Detections**](/features/anticheat) - review what Trace monitors and how thresholds work.
* [**Roles & Permissions**](/features/roles-permissions) - define who can access which parts of the panel.
* [**Discord Webhooks**](/configuration/discord-webhooks) - route specific event types to dedicated channels.