Diagnostics & Troubleshooting Guide

# Common Issues & Solutions

# 1. "DataStore request failed: 502 / API access not enabled"

• Cause: Studio does not have permission to access cloud DataStores.
• Solution:
  1. Open Game Settings > Security.
  2. Turn ON Enable Studio Access to API Services.
  3. Alternatively, RAC automatically engages its zero-latency localMemoryBans fallback in Studio, so your game will continue running smoothly regardless.

---

# 2. "Legitimate dash or launch pad triggers Speed / Fly detector"

• Cause: The custom movement skill moves the player faster than MaxWalkSpeedTolerance.
• Solution: Grant a temporary exemption right before applying the impulse:

  local RAC = require(game.ServerScriptService.RAC.Core.Engine)
  RAC:AddExemption(player, "DashSkill", 1.5)
  

---

# 3. "Discord Webhook alerts are not sending"

• Cause 1: HttpService is disabled in Game Settings.
• Solution 1: Enable Allow HTTP Requests in Game Settings > Security.
• Cause 2: The webhook URL is invalid or Discord rate-limited the IP.
• Solution 2: Verify the webhook URL in Config.Discord.WebhookURL. RAC's queue throttles requests to 1 every 2 seconds to avoid rate limits.

---

# 4. "Admin Dashboard (F4) does not open in live game"

• Cause: The player's UserID is not listed in Config.Admin.Roles.
• Solution: Add your UserID to Config.Admin.Roles with the "Owner" or "Admin" role in ServerScriptService/RAC/config.luau.
• (Note: In Studio solo play, the local developer is automatically granted the Owner role).

---

# Enabling Debug Telemetry

To print verbose detector ticks and latency measurements to the Output window, toggle Debug mode in config.luau:

Config.General.Debug = true

---

# Next Steps

• Read the Frequently Asked Questions.
• Check the Release History.