Skip to main content

rcdebug

PyPI Python License CI

rcdebug is a cross-platform (Windows, macOS, and Linux) command-line debugger and security workbench for Roblox games (600,000 flaws) and websites / web applications (150,000 flaws). It audits exposed remotes, unanchored parts, replicated player stats, memory spikes, Luau server scripts, DOM XSS, IDOR, SQL/ORM queries, auth/session cookies, CORS/CSP headers, and WCAG accessibility.

It uses only the Python standard library and installs zero external dependencies.

Roblox Developer Console streaming rcdebug findings and 10s memory diffs macOS terminal running the rcdebug client listener on port 8765
In-game Developer Console: client-side scan & 10s memory diffs macOS Terminal: local HTTP/WS listener & Roblox log tailer

Install (Windows, macOS & Linux)

Install directly from PyPI (creates rcdebug.exe on Windows and rcdebug on macOS/Linux):

pip install rcdebug

Or install directly from GitHub via pip:

pip install git+https://github.com/roulettegun/rcdebug.git

To work from a local checkout:

git clone https://github.com/roulettegun/rcdebug.git
cd rcdebug
pip install -e .

On Windows PowerShell / CMD without pip install, you can also run bin\rcdebug.bat --ui or bin\rcdebug.bat --ui-web directly.

Usage

Live Client Audit (--client)

Run rcdebug with no arguments (or rcdebug --client):

rcdebug

rcdebug binds a local listener on 127.0.0.1:8765 (switching to 8766 automatically if 8765 is already in use by MacSploit or another process), copies the client-side Luau diagnostic script to your macOS clipboard via pbcopy, and tails ~/Library/Logs/Roblox/*_last.log.

Paste (Cmd+V) the copied script into your executor, Roblox Developer Console, or Studio Command Bar. Even when Roblox blocks HttpService:PostAsync on the client, rcdebug reads the structured [rcdebug-wire:*] frames directly from the local Roblox log file.

rcdebug terminal streaming live RemoteTraffic and RemoteSecurity findings with RCD catalog codes and Luau fixes
Live Terminal Stream: high-frequency remote replication alerts (27.6 calls/sec), matched RCD-* signatures, and inline server Luau remediation patterns.

Graphical Web Workbench (--ui)

Launch the browser-based graphical interface while keeping the live runtime bridge and log tailer active:

rcdebug --ui

rcdebug --ui starts the local workbench server (http://127.0.0.1:8765/ui, auto-falling back to 8766 if port 8765 is occupied), opens your browser automatically, copies the offline Studio QA Luau test script to your clipboard, and provides interactive views for live findings (Developer vs Exploit sub-tabs under Critical, Warning, and Info), a slide-over inspector with 4 domain-tailored overview sections, clickable Studio Ctrl+Shift+F search queries, per-finding server Luau fixes & assert() unit tests, 10-second memory telemetry, static .luau/.rbxlx scanning, the 600,000-flaw catalog, the 120 Luau probes, and FlawBrain history.

rcdebug --ui Live Audit workbench showing Critical, Warning, Info filters and Developer vs Exploit surface tabs
Live Audit Workbench (--ui): severity filters with Developer and Exploit surface sub-tabs, responsible script locators, and slide-over multi-overview inspector.

Website & Web App Security Workbench (--ui-web)

Launch the website and web-application edition of the workbench powered by 150,000 website flaw signatures (RCW-000001 to RCW-150000) and 120 web security & WCAG probes (WDP-001 to WDP-120):

rcdebug --ui-web

rcdebug --ui-web adapts every feature of the Roblox workbench for websites and web codebases (.html, .js, .jsx, .ts, .tsx, .css, .py), including Developer vs Exploit sub-tabs under Critical / Warning / Info, 4 domain-tailored overview cards (DOM XSS, Checkout & Pricing, IDOR & Access Control, Auth & Session Storage, SQL/ORM Injection, CORS & CSP Headers, Memory & WCAG 2.2), clickable VS Code Cmd+Shift+F search queries, a 4-section TypeScript/JS Guard Module + console.assert() unit test generator, and an offline Browser DevTools Console QA Test Runner.

Static Place & Studio MCP Audit (--server)

Audit a local directory of .luau/.lua scripts, an .rbxlx/.rbxmx place file, or an active Roblox Studio MCP server:

# Audit a local scripts folder or .rbxlx place file and write a Markdown report
rcdebug --server --place ./src --export audit.md

# Audit an open Roblox Studio session over StudioMCP
rcdebug --server

Knowledge Base & Learning

Flaw Signatures Luau Probes Mmap Lookup

# Search the 600,000-flaw catalog (RCD-000001 to RCD-600000)
rcdebug --catalog datastore --critical --limit 10

# Search the 120 static Luau probes (LDP-001 to LDP-120)
rcdebug --pack heartbeat

# Learn custom remote and attribute names from a place or recent Roblox logs
rcdebug --learn ./src

# Harvest public Luau scripts from GitHub into ~/.rcdebug/flaw_brain.json
rcdebug --learn --github "roblox remotes"

rcdebug --ui Brain and History view displaying learned game tokens and FlawBrain concept counts
Adaptive Learning (Brain & History): custom game tokens learned into ~/.rcdebug/learned_flaws.json alongside FlawBrain statistical concepts.

CLI Reference

Flag Description
--client Start the live client bridge, copy the Luau scanner, and tail ~/Library/Logs/Roblox/*_last.log (default mode).
--ui Launch the graphical Roblox Web Workbench interface (http://127.0.0.1:8765/ui) with 600,000 Roblox flaws.
--ui-web Launch the Website & Web Application Security Workbench (http://127.0.0.1:8765/ui) with 150,000 website flaws.
--server Run static checks against Roblox Studio MCP or a local --place <path>.
--catalog [QUERY] Query rcdebug/data/flaws_600000.txt.gz through the mmap offset index in ~/.rcdebug/index_cache_600k.bin.
--web-catalog [QUERY] Query rcdebug/data/web_flaws_150000.txt.gz (150,000 website flaws RCW-000001..RCW-150000).
--pack [QUERY] Query rcdebug/data/luau_debugger_pack_120.json.
--learn [PATH] Extract game-specific tokens from a local path, recent Roblox logs, or GitHub (--github).
--history Print logged CLI runs (~/.rcdebug/command_history.json) and learned token counts.
--watch Poll command_history.json and Roblox logs continuously in the background.
--critical, --warning, --info Filter terminal and Markdown output by severity (flags can be combined).
--export <FILE.md> Save a Markdown report with findings, remediation snippets, remote call rates, and memory diffs.

What Gets Audited

  1. Client-Visible Remotes (ReplicatedStorage & Workspace): Flags exposed RemoteEvent, RemoteFunction, and UnreliableRemoteEvent instances, ranks them against the 600,000-flaw index (Admin, Economy, DataStore, Combat, Inventory), and profiles live OnClientEvent traffic (calls/sec).
  2. Physics & Network Ownership: Identifies unanchored non-character BasePart instances in Workspace that nearby clients can move locally (part:SetNetworkOwner(nil) fix).
  3. Replicated Player State: Checks Player and Character hierarchies for client-visible ValueBase objects (IntValue, NumberValue, BoolValue, StringValue), attributes, and Tool configurations.
  4. 10-Second Memory & Instance Diffs: Samples Workspace instance count, LocalPlayer instance count, and Stats:GetTotalMemoryUsageMb() every 10 seconds to catch uncleaned instances (Debris:AddItem).
  5. Static Server Script Audit (--server): Scans for loadstring(), numeric require(assetId), hardcoded Discord webhooks, DataStore:SetAsync without UpdateAsync, ProcessReceipt handlers missing PurchaseId deduplication, unguarded ProximityPrompt.Triggered / BasePart.Touched connections, and OnServerEvent listeners missing typeof() or cooldown checks.

Repository Layout

rcdebug/
├── bin/rcdebug                          # CLI wrapper script
├── pyproject.toml                       # PEP 621 package metadata & console_scripts entrypoint
├── AI_ARCHITECTURE.md                   # Internal architecture & maintainer reference
├── rcdebug/
│   ├── cli.py                           # Argument parser & mode dispatcher
│   ├── ui.py                            # Graphical Web Workbench (--ui) & JSON REST API
│   ├── client_bridge.py                 # Local HTTP/WS listener, port fallback & RobloxLogTailer
│   ├── luau_payload.py                  # Client-sided Luau diagnostic & 10s telemetry generator
│   ├── mcp_inspector.py                 # StudioMCP client & parallel local place/script scanner
│   ├── flaw_catalog.py                  # mmap-indexed 600,000-flaw catalog & 12 static regex rules
│   ├── debugger_pack.py                 # 120 static Luau probes
│   ├── learner.py                       # AdaptiveLearner, CommandHistory & FlawBrain
│   ├── github_harvester.py              # GitHub REST Luau harvester (--learn --github)
│   ├── exporter.py                      # Markdown report writer (--export)
│   ├── ui_web.py                        # Website & Web App Security Workbench (--ui-web)
│   ├── web_catalog.py                   # mmap-indexed 150,000-flaw website catalog & 120 web probes
│   └── data/
│       ├── flaws_600000.txt.gz          # 600,000 ordered Roblox flaw records (RCD-000001..RCD-600000)
│       ├── web_flaws_150000.txt.gz      # 150,000 ordered Website flaw records (RCW-000001..RCW-150000)
│       └── luau_debugger_pack_120.json  # 120 static Luau probes (LDP-001..LDP-120)
├── scripts/
│   ├── build_600k_corpus.py             # Generator for flaws_600000.txt.gz
│   └── build_150k_web_corpus.py         # Generator for web_flaws_150000.txt.gz
└── tests/test_rcdebug.py                # Unit & integration test suite (20 tests)

Tests

python3 -m unittest discover -s tests -v

Metadata

Release files for rcdebug 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rcdebug 2.0.0
File Size Uploaded Provenance Actions
rcdebug-2.0.0.tar.gz 21.4 MB Without provenance Details for rcdebug-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rcdebug 2.0.0
File Interpreter ABI Platform Actions
rcdebug-2.0.0-py3-none-any.whl Python 3 none any Details for rcdebug-2.0.0-py3-none-any.whl

Total release size: 42.9 MB

Release files / rcdebug-2.0.0.tar.gz

Download URL rcdebug-2.0.0.tar.gz
Size 21.4 MB
Tags Source
SHA-256 checksum
How to use checksums
02188a0cc32baf094550bca7a41ccfcea66f118dedea15246a0c02b109cc1242
BLAKE2b-256 checksum
How to use checksums
eee059e759290960d275dd5575077c6fa760688b640f1d7af8c996c01be634e6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rcdebug-publisher/2.0.0

Release files / rcdebug-2.0.0-py3-none-any.whl

Download URL rcdebug-2.0.0-py3-none-any.whl
Size 21.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
398729841ceeabc5febe84d20ce9089b2814a3df45c8889edb4191612e08a5ff
BLAKE2b-256 checksum
How to use checksums
678fd087530f35af1c0d77958e4b524e1c3afb0c96b67422932daff9393c81cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via rcdebug-publisher/2.0.0

Security for rcdebug 2.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page