rcdebug
rcdebug (Revan Cool Debugger) is a macOS command-line debugger and security auditor for Roblox games. It finds exposed remotes, unanchored parts that leak network ownership, replicated player stats, memory spikes, and server script vulnerabilities.
It runs on Python's standard library with zero external packages.
Install
Option 1: Install via pip directly from GitHub
pip install git+https://github.com/roulettegun/rcdebug.git
Or install the pre-built release wheel from GitHub Releases:
pip install https://github.com/roulettegun/rcdebug/releases/download/v1.0.0/rcdebug-1.0.0-py3-none-any.whl
Option 2: Clone & Link Locally
git clone https://github.com/roulettegun/rcdebug.git
cd rcdebug
pip install -e .
Quick Start
1. Live Game / Client Audit (--client)
Run rcdebug in your terminal:
rcdebug
What happens:
- Starts a local listener on
127.0.0.1:8765(if port8765is used by MacSploit or another process, it automatically switches to8766). - Copies the 100% client-sided Luau scanner to your macOS clipboard (
pbcopy). - Tails
~/Library/Logs/Roblox/*_last.login real time so findings still stream to your terminal even when Roblox blocksHttpService:PostAsyncon the client.
Paste (Cmd+V) the copied script into your executor, Roblox Developer Console, or Studio Command Bar.
2. Static Place & Studio MCP Audit (--server)
Scan local .luau / .lua scripts, .rbxlx / .rbxmx place files, or an open Roblox Studio session over MCP:
# Scan a local folder or .rbxlx place file
rcdebug --server --place ./src --export audit.md
# Connect to Roblox Studio MCP
rcdebug --server
Commands & Flags
| Command | What it does |
|---|---|
rcdebug or rcdebug --client |
Start the live client bridge, copy the Luau scanner, and tail Roblox logs. |
rcdebug --server |
Audit an active Roblox Studio MCP session or a local --place <path>. |
rcdebug --catalog [query] |
Search the 120,000-flaw database (RCD-000001 to RCD-120000). |
rcdebug --pack [query] |
Search the 120 Luau debugger probes (LDP-001 to LDP-120). |
rcdebug --learn [path] |
Learn custom remote, attribute, and folder names from a place or recent logs. |
rcdebug --learn --github [query] |
Pull public Luau scripts from GitHub and train ~/.rcdebug/flaw_brain.json. |
rcdebug --history |
View terminal command history and learned brain stats. |
rcdebug --watch |
Watch command_history.json and Roblox logs in the background. |
Filtering & Exporting
# Show only CRITICAL findings
rcdebug --client --critical
# Show CRITICAL and WARNING findings
rcdebug --client --critical --warning
# Search the 120,000-flaw catalog for DataStore flaws
rcdebug --catalog datastore --critical --limit 10
# Save a Markdown audit report when you stop the session
rcdebug --client --export report.md
What It Checks
- Remotes (
ReplicatedStorage&Workspace): Lists every client-visibleRemoteEvent,RemoteFunction, andUnreliableRemoteEvent, ranked by risk (Admin,Economy,DataStore,Combat,Inventory), plus liveOnClientEventcall rates (calls/sec). - Network Ownership: Finds unanchored non-character
BasePartinstances inWorkspacethat nearby clients can move locally. - Player & Character State: Flags
ValueBaseobjects (IntValue,NumberValue,BoolValue,StringValue), player attributes, andToolconfigs replicated to the client. - 10s Memory & Instance Diffs: Logs
Workspaceinstance count,LocalPlayerinstance count, andStats:GetTotalMemoryUsageMb()every 10 seconds to spot leaks. - Static Server Checks (
--server): Flagsloadstring(), numericrequire(assetId), hardcoded Discord webhooks,DataStore:SetAsyncwithoutUpdateAsync,ProcessReceiptmissingPurchaseIdchecks, unguardedProximityPrompt.Triggered/BasePart.Touchedhandlers, andOnServerEventlisteners missingtypeof()or cooldown guards.
Project Structure
rcdebug/
├── bin/rcdebug # CLI executable
├── assets/ # Screenshots
├── rcdebug/
│ ├── cli.py # CLI parser and command router
│ ├── client_bridge.py # Local HTTP/WS listener + macOS Roblox log tailer
│ ├── luau_payload.py # Client-sided Luau scanner & 10s telemetry script
│ ├── mcp_inspector.py # Roblox Studio MCP client & static .rbxlx/.luau scanner
│ ├── flaw_catalog.py # mmap-indexed 120,000-flaw lookup engine
│ ├── debugger_pack.py # 120 static Luau probes
│ ├── learner.py # Adaptive pattern learner & command history tracker
│ ├── github_harvester.py # GitHub Luau pattern harvester (--learn --github)
│ ├── exporter.py # Markdown report writer (--export)
│ └── data/
│ ├── flaws_120000.txt # 120,000 flaw signatures (RCD-000001..RCD-120000)
│ └── luau_debugger_pack_120.json # 120 Luau probes (LDP-001..LDP-120)
├── scripts/build_120k_corpus.py # Generator for flaws_120000.txt
└── tests/test_rcdebug.py # Unit test suite
Running Tests
python3 -m unittest discover -s tests -v
Metadata
Release files for rcdebug 1.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-1.0.0.tar.gz | 3.8 MB | Without provenance | Details for rcdebug-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| rcdebug-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for rcdebug-1.0.0-py3-none-any.whl |
Total release size: 7.6 MB
Release files / rcdebug-1.0.0.tar.gz
| Download URL | rcdebug-1.0.0.tar.gz |
|---|---|
| Size | 3.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c177ce87a98cc619d5f63c8347000ee7d8ed55e5950ad732004aaa08461e64b
|
|
BLAKE2b-256 checksum How to use checksums |
c994f39287dab304142c3d9cc0e62d5f296ff72da36fa3f183040e480456abf7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
rcdebug-uploader/1.0.0
|
Release files / rcdebug-1.0.0-py3-none-any.whl
| Download URL | rcdebug-1.0.0-py3-none-any.whl |
|---|---|
| Size | 3.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8fd67508cceecad54833445f658ffe55d6fa5cfa362d08720c2a5349ea95b4a3
|
|
BLAKE2b-256 checksum How to use checksums |
7cc63460d21614937baa9c294e0c863e5acd86a2a97de8b321e2802ee65d43d4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
rcdebug-uploader/1.0.0
|
Security for rcdebug 1.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.