mcpField
R
roblox-studio-hub

roblox-studio-hub

github.com/white-dragon-tools開発057 回インストール37 週間前に更新
リポジトリ

roblox-studio-hub について

Roblox Studio Hub を通じて Roblox Studio のインスタンスを管理し、Lua コードを実行するスキルです。複数の Studio への接続、複数の実行モード、コマンドラインまたは HTTP API による管理に対応します。

主な機能

  1. 01複数の Studio インスタンスを管理
  2. 02eval、run、play モードで Lua を実行
  3. 03Studio の一覧とログを確認
  4. 04Hub のシステムサービスを管理
  5. 05HTTP API から操作

活用シーン

  1. 01接続済み Studio で Lua スクリプトを実行
  2. 02サーバーロジックや完全な Play モードをテスト
  3. 03Studio の状態とログを確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/white-dragon-tools/roblox-studio-hub --skill roblox-studio-hub

インストール後、Claude Code で/roblox-studio-hubを入力して読み込まれたか確認します。

同梱ファイルreferences/api-reference.mdreferences/lua-patterns.md

詳細

Roblox Studio Hub

CLI と HTTP API を使用して、複数の Roblox Studio インスタンスを管理し、Lua コードをリモートで実行するツールです。

概要

Roblox Studio Hub では、以下のことができます。

  • 複数の Studio の管理 - 複数の Roblox Studio インスタンスに同時に接続して管理します
  • リモートコード実行 - 3 つのモード（eval、run、play）で Studio 内の Lua コードを実行します
  • CLI インターフェイス - すべての操作に対応した多機能なコマンドラインインターフェイスです
  • システムサービス - バックグラウンドサービスとして実行し、起動時に自動で開始します

アーキテクチャ

┌─────────────────┐     HTTP Long Polling     ┌─────────────────┐
│  Roblox Studio  │ ◄──────────────────────► │   Studio Hub    │
│    (Plugin)     │                           │    (Server)     │
└─────────────────┘                           └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │    CLI / API    │
                                              │  localhost:35888│
                                              └─────────────────┘

クイックスタート

1. Hub サーバーをインストールする

当前は 管理员 権限で実行されている必要があります。そうでない場合は、ユーザーに通知して、このセッションを中断してください。

# Configure GitHub npm registry
npm config set @white-dragon-tools:registry https://npm.pkg.github.com

# Install globally
npm install -g @white-dragon-tools/roblox-studio-hub
2. システムサービスとして登録する（推奨）
# Register as system service (auto-start on boot)
# Windows: Run as Administrator
# Mac/Linux: Use sudo
roblox-studio-hub install

# Check service status
roblox-studio-hub status
3. Studio プラグインをインストールする
roblox-studio-hub install-plugin
4. セットアップを確認する
roblox-studio-hub status

CLI コマンドリファレンス

すべてのコマンドで、詳細なヘルプを表示するために -h または --help を使用できます。

サービス管理
コマンド説明
roblox-studio-hub serveサーバーをフォアグラウンドで実行します（デバッグ用）
roblox-studio-hub installシステムサービスとして登録します（自動起動）
roblox-studio-hub uninstallシステムサービスをアンインストールします
roblox-studio-hub startシステムサービスを起動します
roblox-studio-hub stopシステムサービスを停止します
roblox-studio-hub statusHub サービスの状態を確認します
roblox-studio-hub update最新バージョンに更新します（サービスの再起動を自動で処理します）
Studio の管理
コマンド説明
roblox-studio-hub list接続されているすべての Studio を一覧表示します
roblox-studio-hub info <studioId>Studio の詳細を表示します
roblox-studio-hub logs <studioId> [-n limit]Studio のログを表示します
コード実行
# Basic usage
roblox-studio-hub exec <studioId> <file> [-m mode]

# Examples
roblox-studio-hub exec place:123456 script.lua           # Execute with eval mode
roblox-studio-hub exec local:MyGame test.lua -m run      # Server-side test
roblox-studio-hub exec path:D:/Projects/MyGame test.lua --mode play  # Full play mode
プラグイン管理
roblox-studio-hub install-plugin    # Install Studio plugin
Hub の更新
roblox-studio-hub update

更新コマンドは、以下を自動的に実行します。

  1. 実行中のサービスを停止します
  2. npm update を実行します
  3. サービスを再起動します

実行モード

モード説明使用例
evalloadstring による直接実行（デフォルト）簡単なスクリプト、単純なテスト
runStudioTestService によるサーバー側テストサーバーロジックのテスト
play完全なプレイモード（サーバー＋クライアント）ゲーム全体のテスト

Studio ID の形式

  • クラウドのプレイス：place:{placeId}（例：place:123456）
  • ローカルファイル：local:{placeName}（例：local:MyGame）
  • カスタムパス：path:{localPath}（例：path:D:/Projects/MyGame）

よくあるワークフロー

接続済みの Studio を確認する
# List all connected Studios
roblox-studio-hub list

# Get details of a specific Studio
roblox-studio-hub info place:123456
Lua スクリプトを実行する
# Create a test script
echo "print('Hello from Hub!'); return 42" > test.lua

# Execute on a connected Studio
roblox-studio-hub exec place:123456 test.lua
Studio のログを表示する
# View last 100 logs (default)
roblox-studio-hub logs place:123456

# View last 50 logs
roblox-studio-hub logs local:MyGame -n 50
Hub を最新バージョンに更新する
# Update with automatic service handling
roblox-studio-hub update

# Update plugin if needed
roblox-studio-hub install-plugin

API リファレンス（プログラムからのアクセス用）

Hub の状態を確認する
GET /api/status
接続済みの Studio を一覧表示する
GET /api/studios
Studio の詳細を取得する
GET /api/studios/:id
Studio のログを取得する
GET /api/studios/:id/logs?limit=100
コードを実行する
POST /api/execute
Content-Type: application/json

{
  "studioId": "place:123456",
  "code": "print('Hello'); return 42",
  "mode": "eval",
  "timeout": 30
}

設定

環境変数
変数デフォルト説明
STUDIO_HUB_PORT35888サーバーのポート

トラブルシューティング

問題解決策
Studio が接続されないStudio の「設定」→「セキュリティ」で HTTP リクエストを有効にします
接続がタイムアウトするファイアウォールを確認し、ポート 35888 が開いていることを確認します
コードの実行に失敗するLua の構文を確認し、レスポンスのエラーを確認します
Studio が切断されるハートビートが 35 秒間ないと、Hub は非アクティブな Studio を削除します
サービスが起動しない管理者／sudo 権限で roblox-studio-hub install を実行します
更新に失敗する管理者／sudo 権限で実行します

その他のリソース

リファレンスファイル

API の詳細なドキュメントとパターンについては、以下を参照してください。

  • references/api-reference.md - API の完全な仕様
  • references/lua-patterns.md - テスト用の一般的な Lua コードパターン

コメント

Markdown 対応