К основному содержанию
скилл CX Codex

roblox-studio-mcp · el4cteo — скилл для Claude Code: что делает и как установить

Скилл Claude Code подключает ИИ-агент к встроенному серверу Roblox Studio через протокол MCP для проверки и правки игровых миров.

MIT 1 200 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code
Открыть на GitHub

Что делает roblox-studio-mcp

Скилл соединяет ИИ-агент со встроенным MCP-сервером Roblox Studio через интерфейс stdio. Агент исследует проектное дерево DataModel, читает и правит скрипты, запускает Luau-код в контекстах редактирования, сервера или клиента, а также проводит плейтест и проверяет вывод консоли. Для работы требуется запущенный редактор Roblox Studio с включенной настройкой MCP-сервера в меню Assistant.

Инструментарий позволяет делать скриншоты вьюпорта, симулировать ввод игрока, искать ассеты и делегировать задачи встроенным субагентам. Набор команд включает поиск по дереву, точечное чтение скриптов и пакетное редактирование. В проектах с поддержкой Rojo файлы на диске выступают источником правды, поэтому правка через MCP может привести к перезаписи изменений.

Перед началом работы следует включить сервер в настройках Studio и скопировать путь к исполняемому файлу StudioMCP для клиента. Запросы к дереву объектов нужно ограничивать по глубине, чтобы избежать перегрузки контекста.

Какие задачи решает

  • исследовать дерево объектов DataModel в Roblox Studio
  • читать и редактировать скрипты из ИИ-агента
  • выполнять Luau-код в контексте сервера или клиента
  • запускать плейтест и собирать вывод консоли
  • искать и вставлять ассеты из Creator Store

Примеры запросов агенту

  • Подключи Roblox Studio по MCP и найди скрипты игрока в проекте
  • Запусти плейтест и проверь вывод консоли на ошибки скриптов
  • Выполни Luau-скрипт на сервере для проверки баланса монет

Как установить roblox-studio-mcp

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code

2Вручную: положить файлы

~/.claude/skills/roblox-studio-mcp/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-studio-mcp/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о roblox-studio-mcp

Как установить roblox-studio-mcp в Claude Code?

Выполните команду npx skills add EL4CTEO/roblox-skills --skill roblox-studio-mcp -a claude-code, а затем обратитесь к файлу ~/.claude/skills/roblox-studio-mcp/SKILL.md.

Что делает roblox-studio-mcp?

Скилл связывает ИИ-агент с Roblox Studio через встроенный MCP-сервер, позволяя исследовать проекты, редактировать скрипты, выполнять Luau-код и проводить тестирование в реальном времени.

Что нужно для работы roblox-studio-mcp?

Требуется запущенный редактор Roblox Studio с активированным встроенным сервером в настройках Assistant.

Исходный текст

SKILL.md · MIT
---
name: roblox-studio-mcp
description: Drive Roblox Studio from an AI agent via the built-in Studio MCP server - connecting Claude Code, Codex, Cursor, OpenCode, Gemini CLI; tools to explore the DataModel, read/edit scripts, run Luau in edit/server/client, playtest, read output, capture screenshots, simulate input, insert assets. Use when an agent should inspect, modify, or playtest an open Studio place, or to set up the connection.
---

# Working in Roblox Studio through MCP

Roblox Studio ships a **built-in MCP server** (stdio). With it, an agent can explore the open place,
edit scripts, run Luau in edit/server/client contexts, playtest, read the Output, capture the viewport,
and simulate player input. It is the fastest way to **verify** Roblox changes instead of guessing.

## Setup

1. Latest Studio → open **Assistant** → **…** → **Manage MCP Servers** → enable **Enable Studio as MCP server**.
2. Use **Quick connect** (Claude Code, Claude Desktop, Codex CLI, Cursor, Gemini CLI, VS Code, Antigravity)
   or configure the client manually:

| OS | Command |
| --- | --- |
| macOS | `/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP` |
| Windows | `cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat` |

```bash
# Claude Code
claude mcp add Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
claude mcp add Roblox_Studio -- cmd.exe /c "%LOCALAPPDATA%\Roblox\mcp.bat"   # Windows
```

```json
{ "mcpServers": { "Roblox_Studio": { "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP" } } }
```

Client-specific config (Codex `config.toml`, OpenCode `opencode.json`, Cursor/VS Code `mcp.json`):
[references/client-setup.md](references/client-setup.md). A green indicator in **Manage MCP Servers**
confirms the connection. Only connect clients you trust: they can read and modify your places.

## Tools

| Group | Tools |
| --- | --- |
| Session | `list_roblox_studios` (every call takes a `studio_id`), `get_studio_state` (play state, available DataModels) |
| Explore | `search_game_tree` (filter by path/class/keyword, depth), `inspect_instance` (properties, attributes, children), `script_search` (fuzzy by name), `script_grep` (text across scripts, ≤ 50 hits), `script_read` (dot path like `game.ServerScriptService.Main`, line ranges) |
| Edit | `multi_edit` (several edits to one script, creates it if missing; `datamodel_type = Edit`) |
| Run | `execute_luau` (`datamodel_type` = `Edit`, `Server`, or `Client`; returns the result or error) |
| Playtest | `start_stop_play`, `get_console_output`, `screen_capture` (optional camera position/look-at), `character_navigation`, `user_keyboard_input`, `user_mouse_input` |
| Assets | `search_asset` (Creator Store / inventory), `insert_asset`, `upload_image`, `store_image`, `generate_mesh`, `generate_material`, `generate_procedural_model` + `wait_job_finished` |
| Delegation | `subagent` (`explore` or `playtest` types for multi-step investigations) |
| Knowledge | `http_get` (Roblox docs, API reference, Cloud docs), `skill` (Roblox-authored skills: debugging, device simulation, docs search, profiling, scene analysis, unit tests) |

## The working loop

1. **Orient**: `list_roblox_studios` → pick `studio_id`; `get_studio_state`. Map the project with
   `search_game_tree` (depth-limited: services first), then `script_grep`/`script_search` for the feature.
2. **Read before writing**: `script_read` every script you'll touch and its requirers. Check for a
   Rojo/Script Sync setup (see below) before editing in Studio.
3. **Edit** with `multi_edit` (exact, minimal edits; keep existing style). Create instances/attributes/
   tags with `execute_luau` in `Edit` context — changes made this way are **real edits to the place**.
4. **Verify statically**: re-read the script; for pure modules, `execute_luau` a quick check
   (`require` the module in `Edit` and call functions).
5. **Playtest**: `start_stop_play` (start) → wait → `get_console_output` for errors → drive the scenario
   with `character_navigation` / input tools → `execute_luau` in `Server`/`Client` to assert state →
   `screen_capture` for visual checks → `start_stop_play` (stop). Always stop play when done.
6. **Report** what changed and what was verified (and what wasn't).

```luau
-- Example execute_luau (Server context during play): assert game state instead of eyeballing.
local Players = game:GetService("Players")
local results = {}
for _, player in Players:GetPlayers() do
	local leaderstats = player:FindFirstChild("leaderstats")
	local coins = leaderstats and leaderstats:FindFirstChild("Coins")
	table.insert(results, `{player.Name}: {if coins and coins:IsA("IntValue") then coins.Value else "missing"}`)
end
return table.concat(results, "\n")
```

## Rules of thumb

- `execute_luau` in `Edit` mutates the place: prefer read-only queries while exploring, and batch
  intentional changes into one clear script. Use `ChangeHistoryService` recording (`TryBeginRecording`/
  `FinishRecording`) so the user can undo your edit as one step.
- Changes made during play (Server/Client contexts) are discarded when play stops — edit in `Edit`.
- **Rojo projects**: the file system is the source of truth — edit files on disk, let Rojo sync, and use
  MCP to playtest/inspect. Editing synced scripts via `multi_edit` gets overwritten. **Script Sync**
  projects sync both ways, so either side works, but don't edit the same script in both at once.
- Keep `search_game_tree` queries narrow (path + depth); large places produce huge outputs.
- Multiple Studio windows: always pass the right `studio_id`; tell the user which place you touched.
- Inserted assets from the Creator Store can contain scripts: inspect them (`search_game_tree` +
  `script_read`) before keeping them; remove unexpected scripts (backdoors are common in free models).
- Don't claim success without evidence: cite console output, assertion results, or screenshots.

## Roblox-authored skills and conversions

Studio exposes Roblox-authored skills through the `skill` tool (e.g. `rbx-debug`, `rbx-perf-profiling`,
`rbx-scene-analysis`, `rbx-unit-test`, `rbx-docs-search`, `rbx-device-simulator-lua`). Roblox also
publishes an official **streaming conversion** skill (`/rbx-convert-to-streaming`, downloadable from the
"Techniques and conversion" streaming docs) that runs through this MCP server; back up the place first.

## Related skills

`roblox-testing` (test runners), `roblox-performance` (profiling), `roblox-tooling` (Rojo/Script Sync),
`roblox-architecture` (where things belong), `roblox-code-review`.

© EL4CTEO · MIT · EL4CTEO/roblox-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — roblox-studio-mcp от других авторов.

roblox-studio-mcp TabooHarmony Скилл для управления Roblox Studio через MCP. Помогает редактировать скрипты Luau, менять сцены, запускать плейтесты и читать логи прямо из ИИ-агента. CX Codex +1 3 900установок roblox-studio-workflow gamedev-skills Скилл roblox-studio-workflow для Claude Code и Codex выстраивает безопасный процесс правок в проектах Roblox и Rojo. Запускается при редактировании плейсов .rbxl, работе через Studio MCP и проверке изменений. CX Codex +1 9 300установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-building TabooHarmony Скилл roblox-building для сборки геометрии, карт и пропов в Roblox Studio через MCP или Luau. Помогает не угадывать координаты и доводить модель до проверяемого результата. CX Codex +1 4 200установок roblox-lighting TabooHarmony Скилл roblox-lighting для Claude Code и Codex. Настраивает освещение, атмосферу, цикл дня и ночи и пост-обработку в Roblox, решает проблемы с плоскими или пересвеченными сценами. CX Codex +1 3 900установок roblox-animation nonlooped Скилл roblox-animation для Claude Code и других агентов: треки, IK-позы, маркерные события и твины интерфейса для анимаций персонажей Roblox. Собирает локомоцию и эмоции без потери приоритетов. CX Codex +1 992установок roblox nonlooped Направляет задачи по Luau к специализированным инструкциям набора roblox-suite и задаёт архитектурные правила для систем Roblox. CX Codex +1 567установок

Из того же набора22

Весь набор →
roblox-npc-ai Скилл roblox-npc-ai для Claude Code помогает создавать ИИ врагов, питомцев и других NPC в Roblox. Используется для настройки поиска пути, преследования, атак и поведения персонажей, а также для исправления застревающих NPC. CX Codex +1 1 200установок roblox-teleport-matchmaking Скилл roblox-teleport-matchmaking для Claude Code управляет телепортацией игроков и созданием матчей в Roblox через TeleportService. CX Codex +1 1 200установок roblox-input Скилл roblox-input для Claude Code настраивает ввод игрока и камеры в Roblox. Он подключается к задачам с клавишами, способностями, транспортом, сенсорными кнопками или собственной камерой. CX Codex +1 1 200установок roblox-analytics-liveops Скилл roblox-analytics-liveops для Claude Code настраивает игровую аналитику, воронки, экономику и live-ops на Lua. Включается при добавлении событий, A/B-тестов или начислении наград. CX Codex +1 1 200установок roblox-audio Скилл roblox-audio для Claude Code помогает настраивать звук в Roblox: музыку, эффекты и пространственное аудио. Включается при добавлении звука или поиске причины, по которой он не воспроизводится. CX Codex +1 1 200установок roblox-networking Скилл roblox-networking для Claude Code управляет сетевым взаимодействием клиента и сервера на Roblox, помогая настраивать RemoteEvent, RemoteFunction и оптимизировать трафик. CX Codex +1 1 200установок roblox-data-stores Скилл roblox-data-stores для Claude Code помогает проектировать сохранение данных игроков и облачные сервисы Roblox. Включается при настройке таблиц лидеров, очередей или устранении потери и дублирования данных. CX Codex +1 1 200установок roblox-architecture Скилл roblox-architecture для Claude Code объясняет устройство проекта Roblox и разделение кода между клиентом и сервером. Включается при настройке структуры проекта и разборе проблем с репликацией или стримингом. CX Codex +1 1 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой