Skip to main content
Glama
erickow

Roblox Studio MCP Server

by erickow

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の準備が整いました。

Related MCP server: roblox-studio-mcp

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

Option

Description

-y, --yes

非対話型(--name + --flavorが必要)

--name <dir>

プロジェクトフォルダ名、またはカレントディレクトリの場合は .

--flavor <f>

roblox-ts or luau-wally

--skip-install

依存関係のインストール/テーマ設定をスキップ

--no-bootstrap

不足しているmiseを自動的にインストールしない

--theme

スキャフォールドにRobloxUIテーマを含める

--no-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

File

Role

rojo.json

out/client を StarterPlayerScripts に、npmパッケージを ReplicatedStorage にマッピング

src/client/

あなたのTypeScriptソース

out/client/

コンパイルされたLuau(npm run watch で作成)

Studioで: game.rbxl を開く → Rojoプラグイン → 接続 → Play を押します。

Luau / Wallyワークフロー

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

File

Role

default.project.json

Wallyレイアウト用のRojoプロジェクトファイル

wally.toml

Wally用のプロジェクトメタデータ(テーマはバンドルされて出荷され、依存関係はありません)

Packages/RuiTheme/

ベンダリングされたテーマ(init / robloxui add で作成)

src/client/init.client.luau

クライアントブートストラップ

独自の(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

Option

Description

-y, --yes

すべてのデフォルトを受け入れる

--force

既存のファイルを上書き

--path <dir>

インストールディレクトリを上書き

--theme

RobloxUIテーマパッケージもインストール

--no-theme

テーマパッケージをスキップ

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

Option

Description

--framework <f>

tsx, luau, or both

--category <name>

カテゴリでフィルタ

--limit <n>

最大結果数(デフォルト30、最大100)

robloxui info <slug>

robloxui info primary-button

出力: フレームワーク、カテゴリ、依存関係、テーマトークン、使用例、および正確な robloxui add コマンド。

プロジェクト検出

Detected

Theme install method (only with --theme or prompt)

rojo.json

npm install robloxui(robloxui/theme サブパスを同梱)

wally.toml

バンドルされた RuiTheme を Packages/ にベンダリング

Neither

手動プロジェクトタイプ選択

テーマは自動的にインストールされることはありません。非対話型実行ではスキップされ、対話型実行では確認されます。コンポーネントは独自のデザイントークンを埋め込んでいるため、スタンドアロンで動作します。

トラブルシューティング

すべてのCLI障害は回復ヒント(再試行 + 手動コマンド + 保存されたパス)を表示します。一般的な修正:

Problem

Fix

login fails with "invalid_token"

トークンの有効期限が切れているか、取り消されています。robloxui login を再度実行してください

add says "daily limit reached"

無料枠: 1日2回。Proにアップグレード: https://robloxui.pencipta.com/pricing

add says "Pro component"

Proサブスクリプションが必要です。robloxui info <slug> を実行して確認してください

Pro component returns no source

最初にサインイン(robloxui login)— Proアクセスはアカウントに紐づいています

Rojo won't connect

プロジェクトルートで npm run dev が実行されていることを確認してください

Nothing in Play mode (Roblox-TS)

npm run dev を実行し続けて、out/client/ がコンパイルおよび同期されるようにしてください

RuiTheme not found (Luau)

テーマを選択しましたが、見つかりません: npx robloxui add <slug> --theme を再実行(Roblox-TSの場合は npm install robloxui)

Want the canonical theme later

npm install robloxui(Roblox-TS)または --theme を指定してaddを再実行(Luauは Packages/RuiTheme/ をベンダリング)

UI doesn't appear

Play を押してください。Editではありません — スクリプトは StarterPlayerScripts の下で実行されます

リンク

Related MCP Connectors

Related MCP Servers