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プラグイン → 接続 → 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 → プラグイン → "Rojo"を検索）

Roblox-TSワークフロー

プロジェクトで次のコマンドを1つ実行します：

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

独自の（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で一度有効にします：アシスタント → ⋯ → MCPサーバーを管理 → StudioをMCPサーバーとして有効化 — その後、エージェントはゲームツリーの読み取り、スクリプトの編集、モデルの挿入、プレイテストの実行ができます。

前提条件

• Node.js ≥ 20.12（CLIテスト/ビルドツールチェーンに必要）

• mise は、PATHにない場合に公式インストーラーでブートストラップされます

• Rojo CLI + Rojo Studioプラグイン

• Wally — Luauプロジェクトのみ

ブートストラップが無効な場合は、プロジェクトで mise install を実行して固定されたツールをインストールします。

その他

以下のセクションでは、マーケットプレイスのワークフロー（コンポーネントのインストール、認証、カタログの閲覧、トラブルシューティング）について説明します。スキャフォールド以上のものが必要になるまではスキップしてください。

認証

robloxui login を一度実行します。2つのフロー：

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 / ヘッドレスマシン: ダッシュボード → デベロッパー でキーを生成し、貼り付けます。

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

制限 — 無料ユーザーは1日2ダウンロードまで。Proサブスクライバーはすべて無制限です。詳細は https://robloxui.pencipta.com/pricing をご覧ください。

robloxui add <slug...>

1つ以上のコンポーネントをインストールします。

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

CLIは以下の処理を行います：

1. 事前チェック スラッグ、認証、ターゲット、フレーバー、パッケージマネージャー、ツールをネットワークや書き込みの前に確認

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

• 価格

• ドキュメント

• npmパッケージ