mcpField
R
roblox-skills-setup

roblox-skills-setup

github.com/syphodev-yt开发13657 次安装6 天前更新
代码仓库

关于 roblox-skills-setup

为 Roblox 技能包配置本机环境的技能，通过与用户确认路径和工具，生成各技能使用的本地设置文件。它强调不擅自安装工具、不保存密钥，并允许跳过暂不使用的部分。

主要功能

  1. 01检查本机工具和配置
  2. 02协助填写技能本地设置
  3. 03指导环境变量配置
  4. 04验证 Roblox Studio 与工具链
  5. 05按需运行设置冒烟测试

适用场景

  1. 01在新机器上准备 Roblox 技能
  2. 02配置游戏、Blender 和素材路径
  3. 03为资产上传设置环境变量
  4. 04确认技能安装后的基本运行情况

MCP 相关

指导启用 Roblox Studio MCP，并通过 Claude Code 配置连接；设置完成后可用 get_studio_state 进行验证。

安装

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

$npx skills add https://github.com/syphodev-yt/roblox-ai-skills --skill roblox-skills-setup

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

附带文件scripts/check_setup.py

详细介绍

在此计算机上设置 Roblox 技能

此技能包中的技能是在其他人的计算机上编写的。每台计算机特有的内容（游戏所在位置、Blender 的位置、要制作动画的绑定、采集的 VFX 的存放位置）都记录在每个技能旁边的一个 LOCAL.md 文件中，与 SKILL.md 放在一起。每个技能都会先读取自己的 LOCAL.md。此技能会与用户一起写入这些文件，因此无需手动编辑。

LOCAL.md 属于用户。切勿将其复制到任何共享内容中。

规则

  • 询问，不要假设。 将检测到的设置作为默认选项提供，让用户确认或修改。
  • 切勿将密钥写入文件。 API 密钥应存放在环境变量中。LOCAL.md 只记录变量名称。向用户说明如何自行设置变量；不要让他们把密钥粘贴到聊天中。
  • 未经同意，不安装任何内容。 说明缺少的工具有什么用途，并提供链接或命令；由用户决定。可选工具仍然是可选的。
  • 只配置他们会用到的内容。 如果他们完全不需要 3D 模型，就跳过 Blender。切勿设置 Kaggle：其条款禁止使用这些技能。跳过的技能会保留其模板，以后可以再次运行此技能进行设置。

第 1 步：检查计算机

python ~/.claude/skills/roblox-skills-setup/scripts/check_setup.py

向用户展示该表格。如果 Studio MCP 一行显示它不在 Claude Code 的配置文件中，这本身并不代表错误：它通常会通过其他方式注册。第 5 步中的实时检查才是判断依据。然后询问他们想使用哪些部分。对于新手，建议按以下顺序：

  1. 代码（roblox-code）：Rojo、Wally、Lune、Selene、StyLua。免费。 最简单的方式是使用工具链管理器：安装 Rokit（或 Aftman），然后运行 rokit add rojo-rbx/rojo、rokit add UpliftGames/wally、 rokit add lune-org/lune、rokit add Kampfkarren/selene、 rokit add JohnnyMorganz/StyLua（仓库名称可能会变更；请查看各项目的 README）。脚手架工具也会将这些工具写入游戏自己的工具链文件。
  2. Roblox Studio MCP。 随 Roblox Studio 一同提供的官方 MCP。在 Studio 中，从 Assistant / MCP 设置中启用它，然后按照设置界面上的说明将其添加到 Claude Code。使用 claude mcp list 确认。所有会操作 Studio 的技能都会使用此服务；一次只使用一个 Studio 连接。
  3. UI、地图、VFX、SFX：只需 Python 和 Studio。
  4. 3D 模型和动画：Blender 4.x。3D 模型还需要 GPU 来完成网格步骤（使用带有 HF_TOKEN 的 Hugging Face Space）。不要使用 Kaggle：其条款禁止此类用途，而且曾导致 账户被封禁。使用模型前，请阅读 roblox-3d-model/references/licences.md：有些模型许可证限制某些地区或商业用途。
  5. 永久上传（可选）：免费的 Roblox Open Cloud API 密钥，需拥有资产上传权限，并设置在 ROBLOX_API_KEY 中；还需要设置 ROBLOX_USER_ID。 没有这些设置，资产仍可在 Studio 会话中使用。

第 2 步：环境变量（由用户设置）

告知用户如何根据其操作系统进行设置，并等待他们表示已完成：

  • Windows（PowerShell）：运行 setx ROBLOX_API_KEY "paste-here"，然后重启 终端和 Claude Code。
  • macOS / Linux：将 export ROBLOX_API_KEY="paste-here" 添加到 ~/.zshrc 或 ~/.bashrc，然后打开一个新终端。

重新运行 check_setup.py；它会报告“已设置”，但不会显示变量值。

第 3 步：编写每个 LOCAL.md

对于用户想使用的每个已安装技能，读取其 LOCAL.template.md，与用户确认每个值（先提供检测到的默认值），然后在同一文件夹中写入 LOCAL.md。保留模板中的标题，以便技能能够找到所需内容。如果模板说明该技能不需要机器设置，就跳过；该技能安装后即可使用。 可提供的实用默认值：

设置可提供的默认值
游戏文件夹~/Projects/Roblox-Games（如果用户同意则创建；脚本默认会在此处查找，或查找 ROBLOX_GAMES_HOME 指向的位置）
Blendercheck_setup.py 找到的路径
VFX 库~/Roblox-VFX-Library（始终位于技能文件夹之外）
SFX 备注 / 选取项~/Roblox-SFX
R15 / R6 骨骼 .blend询问；没有默认值。可使用免费的公开骨骼

如果用户有偏好（艺术风格、喜欢的颜色、不希望出现的内容），就在每个 LOCAL.md 的末尾添加一个简短的 ## My preferences 部分。技能会读取该部分。

第 4 步：VFX 库（说明这一点，因为很多人会感到意外）

roblox-vfx 不附带任何特效。它是一个采集工具：你需要使用自己有权使用的 VFX 包来构建自己的库。

  1. 在 Creator Store 中找到喜欢的免费 VFX 包，点击 Get，将其加入你的库存。此步骤必须手动完成：Studio 拒绝加载你的账户不拥有的资源，即使资源是免费的也一样。
  2. 打开一个测试场景，从 Toolbox 库存中插入这些包。
  3. 请 Claude 使用 roblox-vfx“采集此场景中的 VFX”。它会将 Studio 中每个发射器的属性读取到你的库文件夹中的 JSON 配方里，然后对它们进行分类，方便你搜索（如“冰环”“火焰爆发”）。
  4. 在已发布的游戏中使用特效前，请查看每个包各自的条款。

第 5 步：冒烟测试

运行用户设置的内容，并如实报告通过或失败：

  • 代码：使用 roblox-code 搭建一个临时项目并运行四项检查（构建、测试、lint、格式化）。全新搭建的项目应当四项全部通过。
  • 地图：在 roblox-map 文件夹中运行 python scripts/prove.py minimal。预期结果为 RESULT: WARN（只有 P11，即空白空间；对于双层测试地图来说这是正常的）。然后运行 python scripts/plan.py minimal --prove -o plan.png 并打开该文件。
  • UI：在 roblox-ui 文件夹中运行 python scripts/ui_build.py examples/coin_hud.json --out build 并打开 build/CoinHud.png。然后运行 python scripts/verify_ui.py examples/coin_hud.json，应报告 0 个失败项。
  • Studio：打开 Studio 后，通过 MCP 请求 get_studio_state。
  • Blender：从 LOCAL.md 中记录的路径运行 blender --version。

然后告诉用户如何开始：使用他们想制作的游戏类型运行 /create-roblox-game，或者按名称调用任何单个技能。

重新运行

可随时安全运行。未经用户确认将会有哪些更改并得到同意，绝不要覆盖现有的 LOCAL.md。

评论

支持 Markdown