RobloxUI CLI

Создайте каркас проекта Roblox и подключите его к Roblox Studio за минуты. robloxui init создаёт проект Roblox-TS или Luau/Wally, предварительно настроенный с Rojo, фиксированным набором инструментов через mise, минимальным спавном игрока и сервером Roblox Studio MCP для инструментов ИИ. Компоненты маркетплейса (robloxui.pencicta.com) можно добавить позже с помощью robloxui add.

Быстрый старт

npx robloxui init

Ответьте на запросы (имя проекта, тип, тема), затем:

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

В Roblox Studio: откройте game.rbxl в папке проекта → плагин Rojo → Подключиться → нажмите Play.

Вот и всё — игровое место с спавном и пустым клиентским монтированием, готовое для UI.

robloxui init

Создайте каркас пустого проекта Roblox-TS или Luau/Wally с минимальным спавном игрока, предварительно настроенным для компонентов RobloxUI, набора инструментов и подключения к 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

Создаёт: конфигурацию Rojo, фиксации набора инструментов в mise.toml, стандартные сервисы DataModel (Lighting, ServerStorage, SoundService, StarterGui, StarterPack, StarterCharacterScripts), минимальный спавн игрока, пустое клиентское монтирование, папки src/shared и src/server, а также файл места game.rbxl. Тема RobloxUI подключается по желанию: передайте --theme (или ответьте на запрос), чтобы также подключить канонические токены robloxui/theme. Init устанавливает mise с помощью официального установщика при необходимости.

Существующие проекты проверяются без замены пользовательских сопоставлений Rojo. Неинтерактивный режим отклоняет неоднозначный ввод типа или цели.

Подключение к Roblox Studio

Одноразовая настройка

1. Запустите npx robloxui init — mise и фиксированные инструменты устанавливаются автоматически

2. Установите плагин Rojo Studio (Roblox Studio → Plugins → поиск "Rojo")

Рабочий процесс Roblox-TS

Запустите одну команду в вашем проекте:

npm run dev          # compiles and syncs into Studio

В Studio: откройте game.rbxl → плагин Rojo → Подключиться → нажмите Play.

Рабочий процесс Luau / Wally

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

Для ваших собственных пакетов Wally (не RobloxUI) добавьте их в wally.toml и выполните wally install — сама тема RobloxUI поставляется встроенной и не требует зависимостей.

Studio MCP (инструменты ИИ)

Init может подключить сервер Roblox Studio MCP к вашему инструменту ИИ (opencode.json, .mcp.json, .cursor/mcp.json или .vscode/mcp.json). Включите его один раз в Studio: Assistant → ⋯ → Manage MCP Servers → Enable Studio as MCP server — после этого ваш агент сможет читать дерево игры, редактировать скрипты, вставлять модели и запускать игровые тесты.

Предварительные требования

• Node.js ≥ 20.12 (требуется для тестовой/сборочной цепочки CLI)

• mise устанавливается с помощью официального установщика, если его нет в PATH

• Rojo CLI + плагин Rojo Studio

• Wally — только для проектов Luau

Если установка отключена, выполните mise install в проекте, чтобы установить фиксированные инструменты.

Всё остальное

Разделы ниже описывают рабочий процесс маркетплейса — установку компонентов, аутентификацию, просмотр каталога и устранение неполадок. Пропустите их, пока вам не понадобится больше, чем каркас.

Аутентификация

Запустите robloxui login один раз. Два варианта:

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

Браузерный вариант выводит короткий код — откройте URL, подтвердите, готово. Ваш токен сохраняется в ~/.config/robloxui/config.json (Linux/macOS) или %APPDATA%\robloxui\config.json (Windows).

CI / безголовые машины: сгенерируйте ключ на Dashboard → Developer, затем вставьте его.

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

Лимиты — Бесплатные пользователи получают 2 загрузки в день. Подписчики Pro получают всё без ограничений. См. https://robloxui.pencipta.com/pricing.

robloxui add <slug...>

Установите один или несколько компонентов.

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

CLI будет:

1. Проверять slug, аутентификацию, цель, тип, менеджер пакетов и инструменты перед сетевыми запросами или записью

2. Определять тип вашего проекта (rojo.json → Roblox-TS, wally.toml → Luau)

3. Запрашивать путь установки (по умолчанию: src/client/ui/components/) и необходимость установки темы

4. Загружать исходный код компонента + метаданные из API

5. Подготавливать и проверять все файлы; конфликты останавливают по умолчанию (--force явный)

6. Записывать исходный код и, при запросе, транзакционно устанавливать тему

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

Выводит: фреймворк, категорию, зависимости, токены темы, пример использования и точную команду robloxui add.

Определение проекта

Тема никогда не устанавливается автоматически: неинтерактивные запуски пропускают её, интерактивные спрашивают. Компоненты работают автономно, так как содержат собственные токены дизайна.

Устранение неполадок

Каждый сбой CLI выводит подсказку по восстановлению (повторить + ручная команда + сохранённые пути). Частые исправления:

Ссылки

• RobloxUI marketplace

• Pricing

• Docs

• npm package