Add FPS game example, auto-connect plugin, and Python injection tools

- Updated RobloxMCPPlugin with HTTP polling (auto-enables HttpService)
- Added 20-weapon FPS game example (CoD-style)
- Added Python studio-inject.py for command bar injection via Win32 API
- Added auto-connect setup scripts (VBS + PowerShell)
- Updated MCP server with all FPS game tools

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Admin
2026-03-31 16:57:35 +04:00
Unverified
parent 9c44cb514f
commit a66533206f
16 changed files with 3448 additions and 595 deletions

17
AutoConnect/AutoSetup.vbs Normal file
View File

@@ -0,0 +1,17 @@
Set WshShell = CreateObject("WScript.Shell")
' Wait for Roblox Studio
WScript.Sleep 2000
' Bring Roblox Studio to front
WshShell.AppActivate "Roblox Studio"
WScript.Sleep 500
' Send Ctrl+V to paste
WshShell.SendKeys "^v"
WScript.Sleep 500
MsgBox "Script pasted! Now:" & vbCrLf & vbCrLf & _
"1. Press Play (green ▶ button)" & vbCrLf & _
"2. Look for [RobloxMCP] in Output window", _
0, "Roblox MCP Setup"

View File

@@ -0,0 +1,29 @@
@echo off
echo =====================================
echo ROBLOX MCP - ONE-CLICK SETUP
echo =====================================
echo.
echo STEP 1: Script copied to clipboard!
echo.
echo STEP 2: Do this in Roblox Studio:
echo - Go to Explorer
echo - Open ServerScriptService
echo - Right-click, Insert Object, Script
echo - Press Ctrl+V to paste
echo - Press Play (green arrow)
echo.
echo STEP 3: Enable HTTP if needed:
echo - File, Game Settings, Security
echo - Enable BOTH HTTP options
echo.
pause
echo Checking connection...
curl -s http://127.0.0.1:37423/health
echo.
pause
curl -s http://127.0.0.1:37423/health
echo.
echo If you see "studioConnected": true above, it works!
pause

26
AutoConnect/Setup-MCP.bat Normal file
View File

@@ -0,0 +1,26 @@
@echo off
echo === Roblox MCP Connection Helper ===
echo.
REM Check MCP server
curl -s http://127.0.0.1:37423/health
echo.
echo.
echo === INSTRUCTIONS ===
echo.
echo In Roblox Studio:
echo 1. File ^> Game Settings ^> Security
echo 2. Enable BOTH HTTP options
echo 3. ServerScriptService ^> Right-click ^> Insert Object ^> Script
echo 4. Paste the script from: roblox-plugin\RobloxMCPServer_HTTP.lua
echo 5. Press Play (green ^> button)
echo.
echo You should see: [RobloxMCP] Starting Roblox MCP Server
echo.
pause
curl -s http://127.0.0.1:37423/health
echo.
echo.
pause

86
AutoConnect/Setup-MCP.ps1 Normal file
View File

@@ -0,0 +1,86 @@
# Roblox MCP Connection Helper
# This script helps set up the Roblox MCP connection
Write-Host "=== Roblox MCP Connection Helper ===" -ForegroundColor Cyan
Write-Host ""
# Check if Roblox Studio is running
$robloxProcess = Get-Process | Where-Object {$_.Name -like "*RobloxStudio*"}
if ($robloxProcess) {
Write-Host "✓ Roblox Studio is running (PID: $($robloxProcess.Id))" -ForegroundColor Green
} else {
Write-Host "✗ Roblox Studio is NOT running" -ForegroundColor Red
Write-Host " Please start Roblox Studio first" -ForegroundColor Yellow
exit 1
}
Write-Host ""
Write-Host "=== Setup Instructions ===" -ForegroundColor Cyan
Write-Host ""
Write-Host "1. In Roblox Studio, go to:" -ForegroundColor White
Write-Host " File → Game Settings → Security" -ForegroundColor Yellow
Write-Host ""
Write-Host "2. Enable BOTH options:" -ForegroundColor White
Write-Host " ☑ Enable Studio Access to API Services" -ForegroundColor Yellow
Write-Host " ☑ Allow HTTP Requests" -ForegroundColor Yellow
Write-Host ""
Write-Host "3. Click Save" -ForegroundColor Yellow
Write-Host ""
Write-Host "4. In Explorer → ServerScriptService → Right-click → Insert Object → Script" -ForegroundColor White
Write-Host ""
Write-Host "5. Copy the script below and paste it into the Script:" -ForegroundColor White
Write-Host ""
# Read the script file
$scriptPath = "C:\Users\Admin\roblox-mcp-server\roblox-plugin\RobloxMCPServer_HTTP.lua"
if (Test-Path $scriptPath) {
$scriptContent = Get-Content $scriptPath -Raw
# Copy to clipboard
Set-Clipboard -Value $scriptContent
Write-Host " [SCRIPT COPIED TO CLIPBOARD]" -ForegroundColor Green
Write-Host " Just paste it in Roblox Studio (Ctrl+V)" -ForegroundColor Green
Write-Host ""
} else {
Write-Host " ✗ Script file not found: $scriptPath" -ForegroundColor Red
}
Write-Host "6. Press Play (green ▶ button) in Roblox Studio" -ForegroundColor White
Write-Host ""
Write-Host "7. You should see: [RobloxMCP] Starting Roblox MCP Server" -ForegroundColor Green
Write-Host ""
# Check MCP server status
Write-Host "=== Checking MCP Server ===" -ForegroundColor Cyan
try {
$response = Invoke-RestMethod -Uri "http://127.0.0.1:37423/health" -TimeoutSec 2
Write-Host "✓ MCP Server is running" -ForegroundColor Green
Write-Host " Status: $($response.status)" -ForegroundColor White
Write-Host " Connected: $($response.studioConnected)" -ForegroundColor White
} catch {
Write-Host "✗ MCP Server is NOT responding" -ForegroundColor Red
Write-Host " Make sure to run: npm start" -ForegroundColor Yellow
}
Write-Host ""
Write-Host "Press any key to check connection again..." -ForegroundColor Cyan
$null = $Host.UI.RawUI.ReadKey("NoEcho,IncludeKeyDown")
# Re-check
try {
$response = Invoke-RestMethod -Uri "http://127.0.0.1:37423/health" -TimeoutSec 2
if ($response.studioConnected -or $response.pendingCommands -gt 0) {
Write-Host ""
Write-Host "✓✓✓ ROBLOX STUDIO IS CONNECTED! ✓✓✓" -ForegroundColor Green
Write-Host ""
Write-Host "You can now ask Claude to create things in Roblox!" -ForegroundColor Cyan
} else {
Write-Host ""
Write-Host "Still waiting for connection..." -ForegroundColor Yellow
Write-Host "Make sure you pressed Play in Roblox Studio!" -ForegroundColor Yellow
}
} catch {
Write-Host "✗ Cannot reach MCP server" -ForegroundColor Red
}