Commercial Release Integration (Buyer Guide)

# Overview

If you purchased or received the official commercial release package (R-AntiCheat-v1.0.0-COMMERCIAL.zip), this guide provides instructions for unzipping and integrating RAC into your Roblox game.

This edition is exclusively authored and licensed by Badhon Vitality.

---

# Package Directory Structure

After extracting R-AntiCheat-v1.0.0-COMMERCIAL.zip, you will see:

R-AntiCheat-v1.0.0-COMMERCIAL/
├── LICENSE.txt                        <-- Commercial License Agreement
├── BUYER_INTEGRATION_GUIDE.md         <-- Markdown integration instructions
├── default.project.json               <-- Rojo project configuration
└── src/
    ├── ReplicatedStorage/
    │   └── RAC/
    │       ├── ClientAPI.luau         <-- SDK for building your own Admin GUI
    │       └── Shared/
    │           ├── Constants.luau     <-- Remote IDs and network topics
    │           └── Types.luau         <-- Typed Luau schemas
    ├── ServerScriptService/
    │   └── RAC/
    │       ├── config.luau            <-- YOUR CONFIGURATION (Add your UserID here)
    │       ├── Main.server.luau       <-- Server bootstrapper & engine loader
    │       ├── Core/                  <-- Engine, Risk, Evidence, & Punishment managers
    │       ├── Detectors/             <-- 15 modular detection engines
    │       ├── Security/              <-- RBAC Permission & Token-bucket rate limiters
    │       ├── Services/              <-- AI Heuristic Engine, Storage, & Discord services
    │       └── Admin/                 <-- Server RPC handlers & telemetry routers
    └── StarterPlayer/
        └── StarterPlayerScripts/
            └── RAC/
                └── Client.client.luau <-- Lightweight client adapter (telemetry & warnings)

---

# Step 1: Unzipping & Placing Files in Roblox Studio

Open your game in Roblox Studio.

# Option A: Manual Explorer Placement

1. In the Explorer window, create a folder named RAC inside game.ReplicatedStorage. Copy the files from src/ReplicatedStorage/RAC into it.
2. In game.ServerScriptService, create a folder named RAC. Copy the contents of src/ServerScriptService/RAC into it. Ensure Main.server.luau is a Script (Server context).
3. In game.StarterPlayer.StarterPlayerScripts, create a folder named RAC. Copy Client.client.luau into it as a LocalScript.

# Option B: Rojo Synchronization

If your studio workflow uses Rojo, place the extracted package into your project root and start the server:

rojo serve

Click Connect in the Roblox Studio Rojo plugin to sync the file hierarchy automatically.

---

# Step 2: Configuring Your Owner UserID

Open ServerScriptService/RAC/config.luau. Locate the Config.Admin table and replace 12345678 with your Roblox UserID:

Config.Admin = {
    Roles = {
        [12345678] = "Owner", -- Replace with your actual Roblox UserID
    },
    DefaultRole = "Viewer",
}

---

# Step 3: Enabling Studio API Permissions

For persistent bans and Discord alerts:

1. In Studio, click Home > Game Settings.
2. Select Security in the left sidebar.
3. Turn ON Enable Studio Access to API Services.
4. Turn ON Allow HTTP Requests (for Discord alerts).
5. Click Save.

---

# Step 4: Testing & Verification

1. Press F5 in Roblox Studio to start Play mode.
2. Open the Developer Console (F9).
3. Verify that the RAC startup banner appears:

[RAC] Initializing Framework v1.0.0...
[RAC StorageService] Operating in Studio session with low-latency memory store.
[RAC] Framework loaded successfully in Studio Test mode.
[RAC] Anti-Cheat Framework successfully mounted and armed.
[RAC] Client Adapter active. Use ReplicatedStorage.RAC.ClientAPI to power custom Admin Panels.

---

# Step 5: Designing Your Custom Admin GUI

The commercial distribution intentionally leaves the presentation layer open so you can design your own custom Admin Panel in your game's unique art style.

Require ReplicatedStorage.RAC.ClientAPI from any LocalScript:

local RACClient = require(game.ReplicatedStorage.RAC.ClientAPI)

-- Query live players
local ok, players = RACClient.GetLivePlayers()

-- Kick a rule-breaker
RACClient.PunishPlayer("Kick", targetUserId, targetUsername, "Violated Rules")

For complete step-by-step UI tutorials, refer to:

• Building Custom Admin GUIs
• Client API & Remotes Reference

---

# 🔒 Commercial License & Support

This product is commercially licensed and exclusively authored by Badhon Vitality.

• Official Profile: https://github.com/badhonvitality
• Unauthorized redistribution, re-selling, or stripping copyright headers is strictly prohibited and subject to legal prosecution.