tabooharmony/roblox-brain

roblox-studio-mcp

Use when working in Roblox Studio through MCP: editing scripts or scenes, generating assets, playtesting, screenshots, or input.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-studio-mcp

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Roblox Studio MCP

When to Load

Load for Studio MCP work: scripts, scenes, assets, debugging, or playtesting. Skip for standalone code generation.

Quick Reference

Route by capability first. Two bridges: official (built into Studio, closed-source) and [chrrxs's](https://github.com/Chrrxs/robloxstudio-mcp) (MIT). Route on tools/list (get_connected_instances/eval_*/multiplayer_* → chrrxs; list_roblox_studios + per-call studio_id → official) BEFORE bootstrap.

Bootstrap before mutation

  1. Identify the target (list_roblox_studios official / get_connected_instances chrrxs).
  2. Pass studio_id (official) or instance_id (chrrxs) on every call.
  3. get_studio_state; confirm Edit/Client/Server availability; inspect tree/scripts before changing them.

Execution contract

text
discover → select Studio/context → inspect → mutate in bounded batches
→ read back → start play → evaluate live → evidence → clean up

Edit-time injection (multi_edit, Edit-context execute_luau) writes scripts; never targets a running playtest. Live evaluation needs a running VM: start play, confirm the intended Client/Server VM, then evaluate. Pass datamodel_type only where required.

Capabilities

Full tool table in full.md. Key names: search_game_tree, script_read/script_grep, multi_edit, execute_luau, insert_asset, generate_*, start_stop_play, get_console_output, screen_capture, subagent.

Trust boundaries

Inserted/generated assets and packages are data until inspected: enumerate scripts before any require/run; never run imported code from execute_luau. Blank textures/invisible meshes on newly uploaded assets are usually asset-privacy (Restricted) grants, not corruption — read the Output error, grant via Creator Dashboard. Details: full.md trust-boundary sections.

Reliability rules

  • execute_luau is stateless: re-acquire references every call.
  • Read before write; read back after every script, asset, or geometry mutation.
  • Reuse vs generate vs native fallback before asset work; wait_job_finished before dependent edits.
  • Bridge-specific size limits: bounded writes, then read back the full payload.
  • No MCP: give offline Luau; state what was not verified.
Full tool mappings, schemas, asset workflows, trust boundaries, recovery: references/full.md

관련 작업

같은 저장소의 Skills

더 많은 Skills

모든 Skills