mcpField
R
roblox-game-development

roblox-game-development

github.com/senjuwoo开发641 次安装今天更新
代码仓库

关于 roblox-game-development

roblox-game-development 是通过 Roblox Studio MCP 开发 Roblox 游戏的技能，并提供 RobloxForge 指引，涵盖规划、实现与验证。它面向游戏开发者和编码 Agent，强调通过测试证明小型可玩切片，而非把已有脚本视为游戏正常运行的证据。

主要功能

  1. 01探测 Studio 连接与能力
  2. 02编辑前检查游戏树
  3. 03构建并验证垂直切片
  4. 04由服务器管理权威游戏状态
  5. 05进行游戏测试并查看控制台与截图
  6. 06从官方文档查询当前 API

适用场景

  1. 01以一个经过测试的玩法循环启动 Roblox 游戏
  2. 02检查货币或物品栏的服务器验证
  3. 03根据控制台输出排查游戏测试错误
  4. 04通过截图验证游戏视觉效果

MCP 相关

该技能使用官方 Roblox Studio MCP 检查和控制实时 Studio 会话、运行游戏测试并截取屏幕。它要求先检查可用的 MCP 能力，再依赖特定验证工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/senjuwoo/ultimate-ai-starter-bundle --skill roblox-game-development

安装后在 Claude Code 中输入/roblox-game-development确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api-docs-lookup.md
architecture.md
assets.md
assistant-skills.md
development-loop.md
game-design.md
performance.md
persistence.md
security-networking.md
sharp-edges.md
studio-mcp.md
testing-debugging.md
tooling.md
ui-mobile.md

详细介绍

Roblox 游戏开发（RobloxForge）

你正在通过官方 Roblox Studio MCP （实时引擎）和 RobloxForge（知识 + 验证）开发 Roblox 游戏。首先遵守不可妥协的规则；详细信息见参考资料。

开发循环（绝不跳过步骤）

rb_doctor / rb_capabilities   -> is Studio actually connected? (probe, don't assume)
inspect current place          -> search_game_tree / inspect_instance BEFORE writing anything
plan smallest vertical slice   -> one playable loop, not the whole game
implement                      -> server owns truth; client owns input/presentation
playtest via official MCP      -> start_stop_play, character_navigation, get_console_output
read console output            -> errors are data, fix them
screen_capture + INSPECT       -> only claim visual success if you actually looked
fix, re-run, THEN expand       -> vertical slice proven before adding systems

硬性规则

  1. 只开发垂直切片。 在完成试玩测试之前，绝不要先构建地图 + 经济系统 + UI + 库存 + 商店。先验证一个循环，再扩展。
  2. 服务器掌握事实。 货币、伤害、进度、库存权限都由 ServerScriptService 管理。客户端请求只是服务器验证的建议。RemoteEvent != authorization。
  3. 先探查，不要假设。 工具接口和 Studio 状态应通过 list_roblox_studios / get_studio_state 获取，绝不能凭记忆判断。
  4. “脚本存在”不等于“游戏可用”。 完成任务必须有试玩测试证据：控制台无错误、已测试场景、已截图且查看过截图。
  5. 试玩测试前先检查 rb_capabilities。 如果 autonomous_playtest 未经验证，应说明哪些内容无法验证，而不是声称已验证。

参考资料（只加载任务所需内容）

  • references/studio-mcp.md - 工具概览、参数注意事项、子 Agent 的使用
  • references/development-loop.md - 各类型游戏的垂直切片方法
  • references/architecture.md - 服务、脚本类型、所有权边界
  • references/security-networking.md - 远程对象、验证、漏洞模式
  • references/persistence.md - DataStores、预算、UpdateAsync、Studio 安全
  • references/ui-mobile.md - ScreenGui、安全区域、触摸输入
  • references/testing-debugging.md - 试玩测试场景、控制台排查
  • references/sharp-edges.md - AI 构建游戏时容易踩的坑
  • references/game-design.md - 循环设计：ACTION → FEEDBACK → REWARD → REPEAT
  • references/performance.md - 优先使用 MicroProfiler 进行优化、已知陷阱
  • references/assets.md - 优先使用基础零件、Creator Store 检查规则
  • references/tooling.md - Rojo/Rokit 源码控制工作流（可选）
  • references/assistant-skills.md - 路由到 Roblox 内置的 rbx-* 技能

不确定某个 API 时

不要相信模型的记忆。使用 rb_docs_search "TweenService:Create" 搜索官方 creator-docs 缓存，然后对搜索结果使用 rb_docs_read。官方最新文档始终比训练数据更可靠。

评论

支持 Markdown