gamedev-skills/awesome-gamedev-agent-skills

roblox-studio-workflow

Safely edits an existing Roblox place or Rojo project: finds the source of truth and proves changes with the right test mode or Studio MCP (executeluau).

소스 보기

사용 방법

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

시작 전 확인

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

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

Roblox Studio workflow

Work as a collaborator inside an existing place, not as if it were a blank text repository. This skill owns how changes are made and proven; the domain skills own what the code does.

Workflow

  1. Establish the source of truth. Decide whether Studio, Rojo files, Script Sync, a package,

or a generated build owns each subtree (*.project.json mappings, PackageLink objects). Edit only the owner; a Studio edit to a Rojo-mapped script is overwritten by the next sync.

  1. Inventory before proposing structure. Search scripts, modules, remotes, tags and

Attributes for the feature's current owner (rg over the Rojo tree, or script_grep and search_game_tree over Studio MCP). Run once and record existing warnings, so new ones are yours.

  1. Plan the smallest compatible edit. Name the Instances and execution locations you will

change. Reuse existing remotes, components, cleanup utilities, tags, folders, and config patterns. State any ownership question you could not resolve.

  1. Create real, meaningful objects. Authored UI, folders, attachments, constraints, remotes and

configuration stay inspectable in Explorer. Scripts add behavior and genuinely dynamic repetition; they do not hide the whole feature in runtime construction.

  1. Respect execution and replication. Authoritative logic in server containers, persistent

client logic in StarterPlayerScripts, per-character logic in StarterCharacterScripts, UI templates in StarterGui, shared modules and remotes in ReplicatedStorage, secrets and server assets in server-only containers. Check each Script's RunContext.

  1. Test the actual risk with the smallest rung of the verification ladder that covers it.
  2. Clean the experiment. Remove temporary parts, test remotes, Command Bar fixtures, debug UI,

prints, disabled duplicate scripts, placeholder assets, and diagnostic tags or Attributes. Stop the session and confirm the edit-mode hierarchy is clean (search_game_tree or Explorer).

  1. Report evidence precisely. Changed Instances and files; modes and client counts; cases run;

observed Output; failures and fixes; and what was not run. Label each claim executed, statically checked, prepared but not run, or unverified. "Looks right" and static inspection are never "tested in Studio".

When Studio MCP is connected

If tools such as list_roblox_studios and execute_luau are available, drive the same ladder through them instead of asking the user to click: pick the place with list_roblox_studios, inventory, edit with multi_edit, run with start_stop_play and execute_luau, and collect evidence with get_console_output and screen_capture from both server and client. For live debugging, unit tests, device capture and profiling, call Studio's built-in skills (rbx-debug, rbx-unit-test, rbx-device-simulator-lua, rbx-perf-profiling) through the skill tool. Read references/studio-mcp.md for the tool map, limits, and safety rules.

When the tools are absent, the manual Studio and Rojo path is the full default; nothing here requires MCP. If the user wants it connected, Roblox's official roblox-get-started skill handles installation and connection.

Execution-location map

LocationTypical roleKey constraint
ServerScriptServiceauthoritative Scripts and modulesnot replicated to clients
ServerStorageserver-only assets and dataclients cannot access it
ReplicatedStorageshared modules, assets, remotesvisible to clients; no secrets
StarterPlayerScriptsclient systems across respawnscloned into PlayerScripts
StarterCharacterScriptsper-character client behaviorrecreated each character
StarterGuiauthored UI templatescloned into PlayerGui; lifecycle follows ResetOnSpawn
Workspacereplicated world and live charactersstreaming and ownership change what clients see

Reuse before adding

Before creating a RemoteEvent, search by purpose and read both endpoints. Before adding a "manager" module, find the current feature owner. Before adding folders or tags, read the existing naming and lookup patterns. Duplicate systems that both run double-bind input, save twice, create two UI clones, or apply gameplay twice.

Attributes hold small typed designer-editable values on an Instance; CollectionService tags find sets of Instances across the hierarchy; folders express ownership and navigation. Validate Attributes at the system boundary:

lua
local CollectionService = game:GetService("CollectionService")

local function setupDoor(instance: Instance)
    if not instance:IsA("Model") then return end
    local accessLevel = instance:GetAttribute("AccessLevel")
    if type(accessLevel) ~= "number" then
        warn(`Door {instance:GetFullName()} needs numeric AccessLevel`)
        return
    end
    attachDoorBehavior(instance, accessLevel)
end

for _, door in CollectionService:GetTagged("Door") do setupDoor(door) end
CollectionService:GetInstanceAddedSignal("Door"):Connect(setupDoor)

The owning system also tears behavior down when a tagged Instance is removed.

Verification ladder

  1. Static: project JSON and models build (rojo build default.project.json -o check.rbxlx),

links resolve, selene and luau-lsp pass where the project uses them.

  1. Single session: right execution context and hierarchy, no new Output errors or warnings,

happy path and cleanup.

  1. Lifecycle: respawn, reset, rejoin, streaming, or character replacement as relevant.
  2. Server & Clients: at least two clients for remotes, replication, ownership, player

interaction, joins and leaves, and targeted state.

  1. Device and input: representative device profiles, orientation, touch, controller.
  2. Stress and failure: malformed input, spam, empty and full content, rapid transitions,

simultaneous actions, disconnects.

Use the smallest rungs that cover the change, and never report a lower rung as a higher one. Rungs 4-5 usually need the user: ask them to run the named mode and paste the server and client Output, or script it with StudioTestService from a plugin.

Gotchas

SymptomLikely causeRemedy
Studio edit disappears after syncgenerated or Rojo-mapped subtree editedchange the source files and resync
feature runs twiceduplicate Script, remote or controllerinspect first; consolidate under the existing owner
client cannot reach a module or objectwrong storage locationmove shared content deliberately; keep secrets server-only
authored screen unreadable in Explorereverything created by one LocalScriptnamed Instance shell plus small behavior modules
test passes only in solo Testreplication or lifecycle untestedServer & Clients and the relevant simulators
"clean" Output hides client errorsonly server Output readread each client and the server
shipped place has DebugFolder or printscleanup skippedkeep a cleanup list; inspect the hierarchy after the session
list_roblox_studios is emptyStudio closed, no place open, or MCP setting offask the user to open a place and enable the server
MCP edit landed in the wrong placeseveral Studio windows openpass the studio_id from list_roblox_studios
Attribute or tag behavior silently failsschema or class not validatedvalidate at setup; warn with the full Instance path

Resources

  • Read references/studio-verification.md before reporting Studio validation, or when choosing

test modes, building a temporary harness, or documenting an automation gap.

  • Read references/studio-mcp.md when Studio MCP tools are available or you plan to use them.

Related skills

  • roblox-luau: services, Instances, events, and the execution model.
  • roblox-ui, roblox-networking, roblox-characters, roblox-physics, roblox-datastores:

feature work that uses this inspection and verification discipline.

Version notes

Last verified: 2026-11-11.

  • Studio MCP tool names and the built-in rbx- skills change with Studio releases; the dated list

is in references/studio-mcp.md.

  • Server & Clients and StudioTestService:ExecuteMultiplayerTestAsync() both allow up to eight

clients.

  • The toolbar Device Simulator and the Network Simulator were a Studio beta (File → Beta Features

→ New Device Simulator).

  • Rojo 7.7.1 is the current release.
  • Roblox docs for agents: append .md to any Creator Hub URL; the index is

https://create.roblox.com/docs/llms.txt.

Sources: https://create.roblox.com/docs/studio/testing-modes, https://create.roblox.com/docs/studio/mcp, https://create.roblox.com/docs/assistant/skills, https://create.roblox.com/docs/reference/engine/classes/StudioTestService, https://github.com/Roblox/roblox-studio-agent-plugin.

같은 저장소의 Skills

더 많은 Skills

모든 Skills
gamedev-skills
커뮤니티

game-ui-ux

Engine-neutral design rules for game HUDs and menus: anchors and containers, scaling, safe areas, gamepad focus, HUDs driven by events instead of polling, and accessibility minimums. Use for menus, health bars or inventory screens that break on ultrawide or phones. Pair with godot-ui-control or roblox-ui. Not for button juice (game-feel) or rebinding (input-systems).

24시간 설치 수
433
GitHub Stars
1만
업데이트
11월 12일
gamedev-skills
커뮤니티

game-feel

Adds engine-neutral juice to a working mechanic: trauma-based screen shake, hit-stop, eased tweens, squash and stretch, and knockback. Use when the game feels flat, weightless or not punchy, or hits and jumps should feel satisfying. Not for coyote time (platformer), input buffering (input-systems), camera follow (camera-systems) or HUD layout (game-ui-ux).

24시간 설치 수
431
GitHub Stars
1만
업데이트
11월 12일
gamedev-skills
커뮤니티

create-game-assets

Plans, generates or sources, and validates consistent game art: style guides, sprites, pixel art, tilesets, icons and textures, with QA and licence records. Use when making or AI-generating game art, fixing fake transparency, or checking Steam AI disclosure. Not for engine import (godot-tilemap, godot-animation, unity-tilemap-2d), UI layout (game-ui-ux) or sound (audio-design).

24시간 설치 수
365
GitHub Stars
1만
업데이트
11월 12일
gamedev-skills
커뮤니티

performance-optimization

Finds and fixes game frame-rate problems by measurement in Godot, Unity, Unreal or Roblox: CPU- vs GPU-bound, then the biggest fix (draw calls, pooling, GC spikes). Use for low FPS, stutter, a first-use hitch, or requests to optimize or profile. Not for build size (unity-build-size), physics jitter (physics-tuning) or network lag (roblox-networking, godot-multiplayer).

24시간 설치 수
360
GitHub Stars
1만
업데이트
11월 12일