OpenRBX

A simple CLI tool to launch Roblox Studio with specific Place ID and Universe ID.

Installation

# Clone and install dependencies
git clone https://github.com/kanosy88/OpenRBX.git
cd openrbx
bun install

# Link globally for testing
bun link

Usage

Basic syntax

openrbx -p <place-id> -u <universe-id>

Examples

# Launch Roblox Studio with a specific place
openrbx -p 1234567891234567 -u 1234567890

# Use full option names
openrbx --place-id 1234567891234567 --universe-id 1234567890

# Specify a custom mode and task
openrbx -p 1234567891234567 -u 1234567890 --mode edit --task EditPlace

# Allow multiple Roblox Studio instances
openrbx -p 1234567891234567 -u 1234567890 --multiple-process

# Minimal logging output
openrbx -p 1234567891234567 -u 1234567890 --no-logs

Options

Option	Shortcut	Description	Default
--place-id	-p	Roblox Place ID (required)	-
--universe-id	-u	Roblox Universe ID (required)	-
--mode	-m	Launch mode	edit
--task	-t	Task to execute	EditPlace
--multiple-process	-	Allow multiple Roblox Studio instances	false
--no-logs	-	Show only essential logs	false
--help	-h	Show help	-
--version	-v	Show version	-

Process Management

By default, OpenRBX checks for existing Roblox Studio processes before launching a new instance. This helps prevent conflicts and ensures a smooth experience.

• Default behavior: If Roblox Studio is already running, the tool will abort and display a warning
• Multiple instances: Use the --multiple-process flag to bypass this check and allow multiple instances
• Cross-platform: Process checking works on Windows, macOS, and Linux

Process Detection

• Windows: Looks for RobloxStudioBeta.exe processes
• macOS: Searches for RobloxStudio processes
• Linux: Searches for roblox-studio processes

Development

Prerequisites

• Bun
• Roblox Studio installed on your system

Development commands

# Run in development mode
bun run dev -p 134510530844509 -u 8049025471

# Run with multiple process support
bun run dev -p 134510530844509 -u 8049025471 --multiple-process

# Run with minimal logging
bun run dev -p 134510530844509 -u 8049025471 --no-logs

# Build the package
bun run build

# Test the command globally
bun link
openrbx --help

How it works

OpenRBX generates a Roblox Studio protocol URL in the format:

roblox-studio:1+launchmode:edit+task:EditPlace+placeId:<place-id>+universeId:<universe-id>

The tool uses the appropriate system commands for each platform:

• Windows : start
• macOS : open
• Linux : xdg-open

Contributing

Contributions are welcome! Feel free to open an issue or pull request.

License

MIT License - see the LICENSE file for more details.