rcdebug
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.
|
|
|
| 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.
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.
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
# 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"
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
- Client-Visible Remotes (
ReplicatedStorage&Workspace): Flags exposedRemoteEvent,RemoteFunction, andUnreliableRemoteEventinstances, ranks them against the 600,000-flaw index (Admin,Economy,DataStore,Combat,Inventory), and profiles liveOnClientEventtraffic (calls/sec). - Physics & Network Ownership: Identifies unanchored non-character
BasePartinstances inWorkspacethat nearby clients can move locally (part:SetNetworkOwner(nil)fix). - Replicated Player State: Checks
PlayerandCharacterhierarchies for client-visibleValueBaseobjects (IntValue,NumberValue,BoolValue,StringValue), attributes, andToolconfigurations. - 10-Second Memory & Instance Diffs: Samples
Workspaceinstance count,LocalPlayerinstance count, andStats:GetTotalMemoryUsageMb()every 10 seconds to catch uncleaned instances (Debris:AddItem). - Static Server Script Audit (
--server): Scans forloadstring(), numericrequire(assetId), hardcoded Discord webhooks,DataStore:SetAsyncwithoutUpdateAsync,ProcessReceipthandlers missingPurchaseIddeduplication, unguardedProximityPrompt.Triggered/BasePart.Touchedconnections, andOnServerEventlisteners missingtypeof()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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.