RobloxUI CLI

몇 분 만에 Roblox 프로젝트를 생성하고 Roblox Studio에 연결하세요. robloxui init는 Rojo, mise로 고정된 툴체인, 최소한의 플레이어 스폰, 그리고 AI 도구용 Roblox Studio MCP 서버가 사전 설정된 Roblox-TS 또는 Luau/Wally 프로젝트를 생성합니다. 마켓플레이스 구성 요소(robloxui.pencicta.com)는 나중에 robloxui add로 추가할 수 있습니다.

빠른 시작

npx robloxui init

프롬프트에 응답하고(프로젝트 이름, 종류, 테마), 다음을 수행합니다:

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

Roblox Studio에서: 프로젝트 폴더의 game.rbxl 열기 → Rojo 플러그인 → 연결 → 실행 버튼을 누릅니다.

끝입니다 — 스폰과 빈 클라이언트 마운트가 있는 플레이 가능한 장소로, 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 → 플러그인 → "Rojo" 검색)

Roblox-TS 워크플로우

프로젝트에서 다음 명령어 하나를 실행합니다:

npm run dev          # compiles and syncs into Studio

Studio에서: game.rbxl 열기 → Rojo 플러그인 → 연결 → 실행 버튼을 누릅니다.

Luau / Wally 워크플로우

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

자체(비-RobloxUI) Wally 패키지의 경우 wally.toml에 추가하고 wally install을 실행하세요 — RobloxUI 테마 자체는 번들로 제공되며 종속성이 필요하지 않습니다.

Studio MCP (AI 도구)

Init은 Roblox Studio MCP 서버를 AI 도구(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 마켓플레이스

• 가격

• 문서

• npm 패키지