Roblox Studio MCP Server Updated

🚀 プロジェクト設定

このプロジェクトは、Roblox プロジェクトの開発と管理を支援するための設定ガイドと使用方法を提供します。

🚀 クイックスタート

Roblox プロジェクトの開発と管理を始めるには、以下の手順に従ってください。

✨ 主な機能

• 詳細なプロジェクト設定ガイドを提供。
• さまざまなスクリプトとツールを使用して、Roblox ゲームの開発を支援。
• エラートラブルシューティングのための情報を提供。

📦 インストール

1. 設定ファイルの作成

プロジェクトのルートディレクトリに config.json ファイルを作成し、以下の内容を記述します。

{
    "version": "1.0.0",
    "name": "my_roblox_project",
    "description": "基本的な Roblox プラットフォーマーゲームプロジェクト。",
    "configuration": {
        "api_key": "your_roblox_api_key_here",
        "server_url": "http://localhost:3000",
        "cache_enabled": true,
        "logging": {
            "level": "info",
            "output_file": "logs/app.log"
        },
        "performance_tuning": {
            "max_connections": 100,
            "request_timeout": 30
        }
    },
    "tools": [
        {
            "name": "mcp",
            "description": "Roblox Studio MCP サーバーインターフェイス呼び出しツール",
            "parameters": {
                "$schema": "http://json-schema.org/draft-04/schema",
                "type": "object",
                "properties": {
                    "server_url": {
                        "type": "string",
                        "description": "MCP サーバーの URL アドレス"
                    },
                    "tool_name": {
                        "type": "string",
                        "description": "呼び出す MCP ツールの名前"
                    },
                    "tool_parameters": {
                        "type": "object",
                        "description": "MCP ツールに渡す具体的なパラメーター"
                    }
                },
                "required": ["server_url", "tool_name"]
            }
        }
    ],
    "scripts": [
        {
            "name": "generate_roblox_code",
            "description": "Roblox ゲームコードを生成する",
            "parameters": {
                "$schema": "http://json-schema.org/draft-04/schema",
                "type": "object",
                "properties": {
                    "script_type": {
                        "type": "string",
                        "enum": ["ClientScript", "ServerScript"],
                        "description": "スクリプトのタイプ。ClientScript または ServerScript を選択できます。"
                    },
                    "functionality": {
                        "type": "string",
                        "description": "スクリプトの機能の説明"
                    },
                    "include_comments": {
                        "type": "boolean",
                        "description": "コメントを含めるかどうか。デフォルトは false です。"
                    }
                }
            }
        }
    ],
    "templates": [
        {
            "name": "roblox_platformer_template",
            "description": "基本的なプラットフォームジャンプゲームのテンプレート",
            "source": "template://roblox/game/platformer"
        }
    ]
}

2. サーバーの起動

以下のコマンドを実行して、Roblox プロジェクトサーバーを起動します。

rbxserver.exe --project="path/to/your/project" --server-port=8080

💻 使用例

基本的な使用法

Lua スクリプト

-- ゲーム初期化スクリプトの例
local Players = game:GetService("Players")
local player = Players.LocalPlayer or Players.PlayerAdded:WaitForPlayer()
player.CharacterAdded:Connect(function(char)
    -- プレイヤーのキャラクターが読み込まれたときのイベント処理ロジック
    print("Character added:", char.Name)
end)

-- ゲームを終了するキーをバインドする（デフォルトは ESC）
game:BindKey(Enum.KeyCode.Escape, function()
    print("Game exited by player")
    game.Players.LocalPlayer:Kick() -- ゲームを強制終了する
end)

Roblox クライアント起動スクリプト

#!/bin/bash
# Roblox クライアントを自動起動する例
echo "Starting Roblox client..."
roblox-player.exe --project="path/to/your/client"

高度な使用法

MCP ツールの呼び出し例

コード生成ツールの呼び出し

以下のコマンドを使用して、MCP ツールを介して Roblox ゲームコードを生成します。

mcp-cli call generate_roblox_code \
--parameters '{"script_type": "ServerScript", "functionality": "Player join event handler", "include_comments": true}'

テンプレートツールの呼び出し

以下のコマンドを使用して、MCP ツールを介してゲームテンプレートを適用します。

mcp-cli call apply_template \
--parameters '{"template_name": "roblox_platformer_template"}'

📚 ドキュメント

トラブルシューティング

一般的な問題と解決策

• Q1: サーバー接続がタイムアウトした場合はどうすればいいですか？
  • A1: config.json の request_timeout 設定を確認し、タイムアウト時間を増やすか、ネットワーク設定を最適化してください。
• Q2: ログファイルのパスに書き込めない場合はどうすればいいですか？
  • A2: プロジェクトディレクトリに書き込み権限があることを確認し、logging.output_file パスが正しいことを確認してください。

📄 ライセンス

原ドキュメントにライセンス情報が記載されていないため、このセクションは省略されています。