yoblox

Scaffold a complete, AI-ready Roblox game development environment with Rojo.

What is yoblox?

yoblox is a CLI tool that creates a modern Roblox game project using industry-standard tools and best practices. It sets up everything you need to start building professional Roblox games with:

• Rojo for syncing code to Roblox Studio
• Luau LSP for intelligent code completion
• Clean, scalable folder structure
• AI-native documentation templates
• VS Code configuration included

Quick Start

npx yoblox my-game
cd my-game
code .

Then:

1. Install recommended VS Code extensions (you'll be prompted)
2. Install Rojo: cargo install rojo
3. Run rojo serve
4. Open Roblox Studio and connect to localhost:34872

What Gets Created

my-game/
├── default.project.json      # Rojo configuration
├── README.md                  # Project documentation
├── GAME_DESIGN.md            # Game design document template
├── ARCHITECTURE.md           # Technical architecture guide
├── .vscode/                  # VS Code settings and extensions
├── ai/                       # AI-assisted development prompts
└── src/                      # Luau source code
    ├── ServerScriptService/
    ├── StarterPlayer/
    └── ReplicatedStorage/

Prerequisites

You need to install these tools separately:

• Roblox Studio
• VS Code
• Rust (for installing Rojo)
• Rojo

Features

• Modern Roblox project structure
• Minimal working example code
• Clean Rojo mapping configuration
• VS Code settings pre-configured
• AI-friendly documentation scaffolding
• Zero bloat, just what you need

Usage

npx yoblox <project-name>

Project name must contain only letters, numbers, hyphens, and underscores (no spaces).

Development

To test locally:

git clone <your-repo>
cd yoblox
node cli.js test-game
cd test-game
code .

License

MIT