CLI de RobloxUI

Crea la estructura de un proyecto de Roblox y conéctalo a Roblox Studio en minutos. robloxui init crea un proyecto Roblox-TS o Luau/Wally preconfigurado con Rojo, un conjunto de herramientas fijado con mise, un punto de aparición mínimo para el jugador y el servidor MCP de Roblox Studio para herramientas de IA. Los componentes del marketplace (robloxui.pencicta.com) se pueden añadir después con robloxui add.

Inicio rápido

npx robloxui init

Responde a las indicaciones (nombre del proyecto, tipo, tema) y luego:

cd my-game
npm run dev          # compiles and syncs into Studio

En Roblox Studio: abre game.rbxl en la carpeta del proyecto → plugin Rojo → Conectar → pulsa Reproducir.

Eso es todo: un lugar jugable con un punto de aparición y un montaje de cliente vacío, listo para la interfaz.

robloxui init

Crea la estructura de un proyecto Roblox-TS o Luau/Wally vacío con un punto de aparición mínimo, preconfigurado para componentes RobloxUI, conjunto de herramientas y conexión con Studio.

robloxui init --name my-game --flavor roblox-ts --yes
robloxui init --name . --flavor luau-wally --yes   # scaffold in cwd
robloxui init --name my-game --flavor roblox-ts --yes --theme  # include the theme

Crea: configuración de Rojo, fijaciones de herramientas en mise.toml, los servicios estándar de DataModel (Lighting, ServerStorage, SoundService, StarterGui, StarterPack, StarterCharacterScripts), un punto de aparición mínimo, montaje de cliente vacío, carpetas src/shared y src/server, y un archivo de lugar game.rbxl. El tema de RobloxUI es opcional: pasa --theme (o responde a la indicación) para también conectar los tokens canónicos robloxui/theme. Init instala mise con el instalador oficial cuando es necesario. Los proyectos existentes se inspeccionan sin reemplazar las asignaciones personalizadas de Rojo. El modo no interactivo rechaza entradas ambiguas de tipo o destino.

Conectar a Roblox Studio

Configuración única

1. Ejecuta npx robloxui init — mise y las herramientas fijadas se instalan automáticamente

2. Instala el plugin Rojo Studio (Roblox Studio → Plugins → buscar "Rojo")

Flujo de trabajo Roblox-TS

Ejecuta un comando en tu proyecto:

npm run dev          # compiles and syncs into Studio

En Studio: abre game.rbxl → plugin Rojo → Conectar → pulsa Reproducir.

Flujo de trabajo Luau / Wally

npm run dev                                # installs/syncs the Wally project into Studio

Para tus propios paquetes de Wally (que no sean de RobloxUI), agrégalos a wally.toml y ejecuta wally install — el tema de RobloxUI se incluye empaquetado y no necesita dependencia.

Studio MCP (herramientas de IA)

Init puede conectar el servidor MCP de Roblox Studio a tu herramienta de IA (opencode.json, .mcp.json, .cursor/mcp.json o .vscode/mcp.json). Actívalo una vez en Studio: Asistente → ⋯ → Gestionar servidores MCP → Habilitar Studio como servidor MCP — entonces tu agente podrá leer el árbol del juego, editar scripts, insertar modelos y ejecutar pruebas de juego.

Requisitos previos

• Node.js ≥ 20.12 (requerido por el conjunto de herramientas de prueba/compilación de la CLI)

• mise se instala con el instalador oficial cuando no está en PATH

• Rojo CLI + plugin Rojo Studio

• Wally — solo proyectos Luau

Cuando la instalación automática está desactivada, ejecuta mise install en el proyecto para instalar las herramientas fijadas.

Todo lo demás

Las siguientes secciones cubren el flujo de trabajo del marketplace: instalación de componentes, autenticación, navegación del catálogo y solución de problemas. Sáltatelas hasta que necesites más que la estructura básica.

Autenticación

Ejecuta robloxui login una vez. Dos flujos:

robloxui login                     # browser device flow (recommended)
robloxui login --token <key>       # manual API key (CI / headless)

El flujo del navegador imprime un código corto: abre la URL, aprueba, listo. Tu token se guarda en ~/.config/robloxui/config.json (Linux/macOS) o %APPDATA%\robloxui\config.json (Windows).

Máquinas CI / sin interfaz gráfica: genera una clave en Dashboard → Developer y luego pégala.

robloxui whoami      # check who you're logged in as
robloxui logout      # remove saved token

Límites — Los usuarios gratuitos obtienen 2 descargas/día. Los suscriptores Pro obtienen todo ilimitado. Ver https://robloxui.pencipta.com/pricing.

robloxui add <slug...>

Instala uno o más componentes.

robloxui add primary-button
robloxui add button card dialog --yes   # non-interactive (CI)
robloxui add button --theme             # also install the theme package

La CLI hará lo siguiente:

1. Preflight del slug, autenticación, destino, tipo, gestor de paquetes y herramientas antes de la red o escrituras

2. Detectar el tipo de proyecto (rojo.json → Roblox-TS, wally.toml → Luau)

3. Solicitar la ruta de instalación (por defecto: src/client/ui/components/) y si se debe instalar el tema

4. Obtener el código fuente del componente y los metadatos de la API

5. Preparar y validar todos los archivos; los conflictos detienen por defecto (--force es explícito)

6. Escribir el código fuente y, cuando se solicite, instalar el tema de forma transaccional

robloxui list / robloxui search

robloxui list                        # browse all components
robloxui search dialog               # search by name/description
robloxui list --framework tsx        # filter by framework
robloxui list --category buttons --limit 20

robloxui info <slug>

robloxui info primary-button

Imprime: framework, categoría, dependencias, tokens del tema, ejemplo de uso y el comando exacto robloxui add.

Detección de proyecto

El tema nunca se instala automáticamente: las ejecuciones no interactivas lo omiten, las interactivas preguntan. Los componentes funcionan de forma independiente porque incorporan sus propios tokens de diseño.

Solución de problemas

Cada fallo de la CLI imprime una pista de recuperación (reintentar + comando manual + rutas conservadas). Soluciones comunes:

Enlaces

• RobloxUI marketplace

• Pricing

• Docs

• npm package