SuperAPI AI 工具集

roblox-skills-setup

编程与开发

查看项目

更新于 11-05 16:19

技能介绍

用途

该技能负责为 Roblox 游戏创作技能包完成本机配置。技能包中的各项技能原本写在别人的电脑上,凡与具体机器相关的内容(游戏目录、Blender 路径、动画绑定的骨架、采集的 VFX 存放位置)都放在各技能目录下的 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 步的实时检查为准。随后询问用户要用哪些部分。

    代码类(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 为准)。脚手架也会把这些写入游戏自己的工具链文件。

    Roblox Studio MCP 使用随 Studio 发布的官方版本:在 Studio 的 Assistant / MCP 设置中启用,再按设置界面说明加入 Claude Code,用 claude mcp list 确认。所有涉及 Studio 的技能都依赖该服务器,同一时间只使用一个 Studio 连接。

    界面、地图、VFX、SFX 只需 Python 加 Studio。3D 模型与动画需要 Blender 4.x;3D 模型的网格步骤还需要 GPU(带 HF_TOKEN 的 Hugging Face Space)。使用模型前请阅读 roblox-3d-model/references/licences.md,部分模型许可排除某些地区或商业用途。

    可选的永久上传需要免费的 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,它会报告“set”而不显示具体值。

  3. 为每个技能写 LOCAL.md:对用户需要且已安装的每个技能,读取其 LOCAL.template.md,与用户逐项填写(先给探测到的默认值),并在同一文件夹写入 LOCAL.md,保留模板标题以便技能查找。若模板声明该技能无需机器设置,则跳过。可提供的默认值:游戏目录 ~/Projects/Roblox-Games(经同意可创建;脚本默认在此查找,或由 ROBLOX_GAMES_HOME 指定);Blender 用 check_setup.py 找到的路径;VFX 库 ~/Roblox-VFX-Library(始终位于技能文件夹之外);SFX 记录 ~/Roblox-SFX;R15 / R6 绑定的 .blend 需询问,无默认值,可用的免费公开绑定即可。如用户有偏好(美术风格、颜色、不想要的东西),可在每个 LOCAL.md 末尾加 ## My preferences 小节,技能会读取。

  4. VFX 库说明:roblox-vfx 本身不附带任何特效,它是采集器,需用有权使用的 VFX 包自建库。在 Creator Store 找到喜欢的免费 VFX 包并点击 Get 使其进入自己的库存(这一步必须手动,因为 Studio 拒绝加载账号不拥有的资产,免费资产也一样);打开测试场所,从 Toolbox 库存插入这些包;让 Claude 用 roblox-vfx 执行“harvest the VFX in this place”,它会把 Studio 中每个发射器的属性读取为库文件夹里的 JSON 配方并分类,便于按“ice ring”“fire burst”等搜索。在发布游戏中使用前,请查看各包自身的条款。

  5. 冒烟测试:实际运行用户配置的内容并如实报告通过/失败。代码:用 roblox-code 搭建一个临时项目并运行四道关卡(构建、测试、lint、格式化),全新脚手架应全部通过。地图:在 roblox-map 文件夹运行 python scripts/prove.py minimal,预期 RESULT: WARN(仅 P11 空空间,对两层测试地图属正常);再运行 python scripts/plan.py minimal --prove -o plan.png 并打开。界面:在 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。

适用场景与限制

适用于第一次配置该 Roblox 技能包、更换机器或补充配置被跳过的技能。需要能够运行 Python 脚本的 Claude Code 环境;涉及 Studio 的功能需已启用官方 Studio MCP;3D 模型与动画需 Blender 4.x,网格步骤另需 GPU。收费、价格与性能数据暂未提供。