BubbaBlox Setup Guide

A refined guide for setting up the BubbaBlox Source Code.

---

Notice: Please do not contact the maintainers for basic setup help. If you follow this guide properly, you won't need it.

1. Prerequisites

Ensure you have the following installed and configured before starting:

• Node.js (v18.16.1): Required for the renderer and build panels.
• PostgreSQL: The database engine.
• .NET 6.0 SDK: Required to run the web server.
• Go (v1.20+): For asset validation.
• Python 3.12: For image validation and RSA generation.
  • Important: Check "Add Python to PATH" during installation.
  • Run: pip install fastapi aiohttp pydub uvicorn python-magic python-magic-bin==0.4.14 python-multipart cryptography
• FFMPEG: Must be installed and added to your System PATH.

---

2. Server Requirements

• OS: Windows 10/11 or Windows Server (Use Wine/Proxmox for Linux). (i might add basic support for linux in the future)
• Domain: Must be exactly 10 characters (e.g., yoursite.com).
• Networking: Domain must support both HTTP and HTTPS.

---

3. Database Configuration

1. Open Command Prompt as Administrator.
2. Navigate to your PostgreSQL bin folder (e.g., C:\Program Files\PostgreSQL\13\bin).
3. Move api/sql/schema.sql into this folder.
4. Run: psql --username=postgres --dbname=postgres < schema.sql

---

4. Backend & Path Setup

1. AppSettings: In Roblox/Roblox.Website, rename appsettings.example.json to appsettings.json.
2. Postgres Connection: Update the "Postgres" string with your password and database name.
3. Global Path Fix: Press CTRL + H. Replace the placeholder path C:\\Users\\Admin\\... with your actual BubbaBlox folder path. Use double backslashes (\\).
4. Renderer Config: In the renderer folder, rename config.example.json to config.json. Ensure the Authorization keys match your appsettings.json.

---

5. Hex Editing (The 10-Char Patch)

Since the binaries are hardcoded for 10-character domains, you must manually patch them using HxD:

• Open RCCService.exe and your Client.exe in HxD.
• Search (CTRL+R) for the string bbblox.org.
• Replace it with your 10-character domain.
• Update the domain in AppSettings.xml for both the client and RCC.

---

6. RSA Key Generation

1. Navigate to Roblox/Roblox.Website/RSA.
2. Run python Generate.py to create your public/private keys.
3. For 2016/2018 RCC: Search for BGIAA in HxD and replace the key with the content of your PublicKey2016.pub.
4. For 2020 RCC: Search for MIIBI and replace every instance found with your 2020 public key.

Info

1. Could in future make a DLL that can auto patch all of this for you just to make it easier. ( would inject everytime RCC starts )

---

7. Registry Keys

Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ROBLOX Corporation\Roblox in RegEdit:

• Create String AccessKey: Set to your RccAuthorization value.
• Create String SettingsKey: Set to a custom string.
• Rename the JSON file in Roblox/Roblox.Libraries/Json to RCCService[YourSettingsKey].json.

---

8. Launch & Final Steps

1. Run runall.bat from the main directory.
2. Navigate to http://localhost and register.
3. Go to /admin and create the following system players:
   • ID 2500: Name it UGC.
   • ID 12: Name it BadDecisions.
4. Use the "Nullify Password" option for these accounts.

Setup Complete.