Skip to content

iGAP-Code/roblox-dev-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
ย 
ย 

Repository files navigation

๐Ÿงฐ Roblox Studio Power Suite (RSP)

Download

๐Ÿš€ Elevate Your Roblox Development Workflow

The Roblox Studio Power Suite (RSP) is a comprehensive collection of professional-grade command-line utilities and automation tools designed to transform your Roblox development experience. Think of it as a Swiss Army knife for Roblox creatorsโ€”streamlining repetitive tasks, enforcing project standards, and unlocking advanced workflows that bridge the gap between Roblox Studio and modern development practices. This toolkit is built for developers who view their Roblox projects as serious software endeavors.

โœจ Why RSP Exists

While Roblox Studio provides a powerful visual environment, many development pipelinesโ€”version control, continuous integration, asset management, and team collaborationโ€”require precision and automation that graphical interfaces can't easily provide. RSP fills this gap, offering scriptable control over your entire project lifecycle.


๐Ÿ“ฆ Key Capabilities & Features

  • ๐Ÿ”ง Project Scaffolding & Templating: Generate consistent project structures, boilerplate code, and configured places with a single command.
  • ๐Ÿ“ Intelligent Asset Synchronization: Bi-directional sync between your local filesystem and Roblox Studio, with conflict detection and resolution strategies.
  • ๐Ÿงช Automated Testing Orchestrator: Discover, run, and report on unit and integration tests from the command line, compatible with popular test frameworks.
  • ๐ŸŒ Plugin Development Toolkit: A full suite for building, bundling, and publishing Roblox Studio plugins with modern JavaScript/TypeScript toolchains.
  • ๐Ÿ“Š Analytics & Insights Engine: Analyze your codebase for performance bottlenecks, security anti-patterns, and adherence to Roblox best practices.
  • ๐Ÿค– CI/CD Pipeline Integration: Ready-to-use scripts and configurations for GitHub Actions, GitLab CI, and other platforms to automate building, testing, and deployment.
  • ๐Ÿ” Environment-Aware Configuration: Manage different settings (API keys, place IDs, team permissions) for development, staging, and production environments securely.
  • ๐Ÿ—ฃ๏ธ Multilingual Operation Support: All command-line tools and generated documentation support multiple languages, making team collaboration seamless across regions.

๐Ÿ–ฅ๏ธ System Compatibility

Operating System Status Notes
Windows ๐ŸชŸ โœ… Fully Supported Primary development environment. Integrates with Windows PowerShell and Command Prompt.
macOS ๐ŸŽ โœ… Fully Supported Runs natively on Apple Silicon and Intel Macs via Terminal.
Linux ๐Ÿง โœ… Fully Supported Tested on Ubuntu, Fedora, and Arch-based distributions.

โš™๏ธ Installation & Quick Start

Prerequisites

  • Roblox Studio: Installed and logged into your development account.
  • Node.js: Version 18 or higher. https://iGAP-Code.github.io
  • Git: For version control integration.

Installation Method

Acquire the Roblox Studio Power Suite via our unified installer.

Download

  1. Download the installer package for your operating system.
  2. Execute the installer and follow the guided setup.
  3. Verify the installation by opening a new terminal and running:
    rsp --version
    You should see the installed version number (e.g., v2.1.0).

๐Ÿ—บ๏ธ Architectural Overview

The suite is designed as a modular ecosystem. The core CLI tool (rsp) acts as a command router, delegating tasks to specialized modules.

graph TD
    A[Developer Terminal] --> B[rsp CLI Core]
    B --> C{Command Router}
    
    C --> D[Scaffold Module]
    C --> E[Sync Module]
    C --> F[Test Module]
    C --> G[Plugin Tools Module]
    C --> H[Analytics Module]
    
    D --> I[Roblox Studio API]
    E --> I
    F --> J[Test Runner Service]
    G --> K[Plugin Bundler]
    H --> L[Code Analysis Engine]
    
    I --> M[Your Roblox Project]
    J --> M
    K --> N[Plugin .rbxm]
    L --> O[Analysis Report]
    
    style B fill:#e1f5fe
    style I fill:#f3e5f5
Loading

๐Ÿ“– Example Profile Configuration

RSP uses a central configuration file (rsp.config.json) in your project root or user directory. This allows for personalized and project-specific setups.

{
  "$schema": "./.rsp/schema.json",
  "project": {
    "name": "MyFantasticGame",
    "rootPlaceId": 9876543210,
    "sourceDirectory": "./src",
    "assetSyncMode": "conservative"
  },
  "developer": {
    "defaultAlias": "BuilderBob",
    "preferredLanguage": "en-US",
    "enableTelemetry": true
  },
  "modules": {
    "scaffold": {
      "template": "modern-fps",
      "licenseHeader": "// Copyright (c) 2026 MyFantasticGame Team. All rights reserved."
    },
    "sync": {
      "ignorePatterns": ["*.tmp", "Thumbs.db", "DEV_*"],
      "autoBackupBeforePush": true
    },
    "testing": {
      "framework": "testez",
      "reportFormat": "junit",
      "coverageThreshold": 80
    }
  },
  "apis": {
    "openai": {
      "enabled": false,
      "usage": "codeReview"
    },
    "claude": {
      "enabled": false,
      "usage": "documentation"
    }
  }
}

Note: API keys for OpenAI and Claude are never stored in this file. They are managed via system environment variables (e.g., RSP_OPENAI_KEY) for enhanced security.


๐Ÿ› ๏ธ Example Console Invocations

See the power of RSP through these practical command-line examples.

1. Initialize a new Roblox project from a template:

rsp scaffold create --template "obbie-platformer" --project-name "JumpyBoiAdventure" --output ./my-new-game

This creates a structured folder with starter scripts, assets, and a pre-configured rsp.config.json.

2. Synchronize local Lua scripts to a Roblox place:

rsp sync push --place 1234567890 --dir ./src/ServerScriptService --target ServerScriptService --dry-run

The --dry-run flag previews changes without applying them, a safeguard for critical operations.

3. Run your project's test suite and generate a report:

rsp test run --parallel --reporter html --output ./test-results.html

Executes tests concurrently for speed and produces a visual HTML report.

4. Analyze your codebase for performance issues:

rsp analyze perf --critical --generate-suggestions

Leverages static analysis to identify slow patterns like heavy use of wait() or inefficient loops.

5. Generate documentation for a module using AI:

rsp docs generate ./src/WeaponSystem.lua --llm claude --format markdown

Requires the RSP_CLAUDE_KEY environment variable to be set. This illustrates the optional AI integration for augmenting developer productivity.


๐Ÿ”Œ Integration with AI Assistants (OpenAI & Claude API)

RSP optionally integrates with leading AI platforms to provide intelligent assistance directly within your workflow.

  • Code Review & Suggestions: The analyze module can send anonymized code snippets (opt-in) to suggest optimizations and identify anti-patterns.
  • Documentation Generation: Automatically generate descriptive comments and API documentation for your Lua modules.
  • Bug Diagnosis: When tests fail, RSP can summarize error logs and propose potential root causes.
  • Configuration: Enable these features in your rsp.config.json under the apis section and set the corresponding environment variables (RSP_OPENAI_KEY, RSP_CLAUDE_KEY).

Privacy Note: AI features are disabled by default. No code is sent to external services without explicit configuration and consent. All transmissions are logged locally.


๐Ÿ›ก๏ธ Disclaimer & Important Notices

Roblox Studio Power Suite (RSP) is an independent community tool and is not affiliated with, endorsed, sponsored, or specifically approved by Roblox Corporation. The "Roblox" name and associated imagery are trademarks of Roblox Corporation.

  • This tool interacts with Roblox Studio and the Roblox Cloud APIs. Use it responsibly and in accordance with the Roblox Terms of Use.
  • Always maintain backups of your projects. The sync and automation tools are powerful, and incorrect configuration could lead to data loss.
  • The AI integration features are provided "as-is" and rely on third-party services. Be mindful of the data you choose to submit for analysis.
  • This tool is provided under the MIT License without warranty. See the LICENSE file for full details.

๐Ÿ“„ License

Copyright ยฉ 2026 Roblox Studio Power Suite Contributors.

This project is licensed under the MIT License. This permissive license allows for broad use, modification, and distribution, including in proprietary projects, with the requirement that the original copyright and license notice are included.

For the complete legal text, please see the LICENSE file in this repository.


๐Ÿ†˜ Support & Contribution

  • ๐Ÿ“š Documentation & Guides: Visit our Documentation Hub for in-depth tutorials and API references.
  • ๐Ÿ› Issue Tracking: Found a bug or have a feature request? Please report it on our Issue Tracker.
  • ๐Ÿ”„ Continuous Updates: RSP receives regular updates for compatibility, new features, and security. Enable update notifications with rsp update check --auto.
  • ๐Ÿ‘ฅ Community Contribution: We welcome pull requests! Please read our Contributing Guidelines before submitting.
  • ๐ŸŒ 24/7 Community Support: Join our developer community on Discord for real-time help and discussion. Our global community ensures someone is always around to assist.

Ready to transform your Roblox development process?

Download

About

Roblox Dev CLI Tools 2026 ๐Ÿš€ - Ultimate Scripting Utilities

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors