mcpField
R
roblox-building

roblox-building

github.com/tabooharmony创意与媒体1382.5k 次安装2 周前更新
代码仓库

关于 roblox-building

roblox-building 是用于 Roblox 几何体、道具、地图构建和空间入门的技能，指导 Agent 通过 MCP 或 Luau 分阶段搭建，并检查尺寸、资产和场景结果。

主要功能

  1. 01分阶段构建并回读验证
  2. 02优先检查项目与工具箱资产
  3. 03选择程序化模型、网格或材质
  4. 04按玩家尺度规划空间
  5. 05检查碰撞、边界与材质
  6. 06验证地图动线和构建证据

适用场景

  1. 01在 Roblox Studio 中搭建道具和地图
  2. 02为场景选择并检查现有资产
  3. 03验证几何体尺寸、碰撞与锚定
  4. 04通过回读和试玩检查地图

MCP 相关

该技能指导通过 MCP 使用 Roblox 构建能力，包括生成程序化模型、网格和材质；也可通过 Luau 进行构建。

安装

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

$npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-building

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

附带文件references/full.md

详细介绍

Roblox Building

适用时机

通过 MCP 或 Luau 构建几何结构、道具、地图和空间引导时加载。

快速参考

MCP 构建模式

1-2. 检查 Studio/Workspace/资源；命名根节点，明确原点、尺寸和资源。 3-4. 分阶段构建并回读；验证树结构、视图和通行路线。

资源选择
  • 先搜索项目资源和 Toolbox；检查类型、创建者、价格、脚本和适用性。
  • 插入付费资源或其他所有者的资源：先说明创建者、ID、价格和权利。检查脚本和依赖项；移除不需要的代码。参见 roblox-security。
  • MCP：generate_procedural_model、generate_mesh、generate_material。
  • 检查网格边界、碰撞、PBR 和质量等级。
  • 使用允许的图像；等待任务完成。
  • EditableImage/EditableMesh：需获得权限并注意内存限制。
  • 不适合复用或生成时，使用原生 Parts/CSG。
  • **资源隐私：**新账号/群组创建的 Images/Decals/Meshes 默认受限——纹理空白/网格不可见通常表示缺少授权，而非资源损坏。查看 Output 中的错误；在 Creator Dashboard 中向体验授予权限。参见 roblox-studio-mcp。
玩家尺寸

玩家约 5 studs | 门宽 4×高 7 | 天花板 10-14 | 柜台 3.5-4 | 座椅 1.5 | 路径 6+

空间规则
  • 标明尺寸；子部件相对于锚点 CFrame 偏移，切勿猜测世界坐标。
  • 按 0.125/0.25/0.5 studs 对齐。复杂 CSG 在原点附近构建，然后用 PivotTo 移至目标位置。
  • 显式设置锚定、碰撞、阴影、颜色和材质。
验收标准

**道具：**命名模型、枢轴、比例、边界、材质、碰撞、锚定、无松散部件、来源信息。 **地图：**根节点/原点、区域、地标、出生点/返回路径、通行路线；边界计算时排除 Baseplate/Terrain/SpawnLocation。 **证据：**回读、支持时提供视图、游戏测试结果。

反模式

猜测坐标 | 未锚定/重复部件 | 硬编码世界位置 | CSG 静默失败 | 批次过大 | 未回读就声称完成

详情：references/full.md（地图、验证、资源）。

评论

支持 Markdown