tabooharmony/roblox-brain

roblox-building

Use when building or editing geometry, maps, props, or generated assets with MCP or standalone Luau.

使用方法

复制安装命令，在自己的智能体环境安装前先检查源码包。
从原始文档核对所需工具、凭据和支持的宿主。
说明输入材料与期望交付物，并对照来源检查输出。

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

开始前需了解

安装不包含模型订阅、API 额度或访问文件的权限。
仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。

仓库原始内容

按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Roblox Building

When to Load

Load for geometry, props, maps, and spatial onboarding via MCP or Luau.

Quick Reference

MCP Build Mode

1-2. Inspect Studio/Workspace/assets; name root, origin, dimensions, assets. 3-4. Build in phases with readback; verify tree, view, traversal.

Asset Choice

Search project assets and Toolbox first; check type, creator, price, scripts, fit.
Paid/cross-owner insertion: disclose creator, ID, price, rights first. Inspect scripts/dependencies; remove unneeded code. See roblox-security.
MCP: generate_procedural_model, generate_mesh, generate_material.
Check mesh bounds, collision, PBR, and quality levels.
Use permitted images; wait for jobs to finish.
EditableImage/EditableMesh: permission + memory limits.
Native Parts/CSG when reuse/generation is unsuitable.
Asset privacy: new accounts/groups create Images/Decals/Meshes Restricted — blank texture/invisible mesh usually means a missing grant, not corruption. Read the Output error; grant the experience in Creator Dashboard. See roblox-studio-mcp.

Player Scale

Spatial Rules

Name dimensions; offset sub-parts from anchor CFrames, never guessed world coordinates.
Snap to 0.125/0.25/0.5 studs. Build complex CSG near origin, then PivotTo the destination.
Set anchoring, collision, shadows, color, material explicitly.

Acceptance

Prop: named model, pivot, scale, bounds, materials, collision, anchoring, no loose parts, provenance. Map: root/origin, zones, landmarks, spawns/return paths, traversal, bounds excluding Baseplate/Terrain/SpawnLocation. Evidence: readback, view when supported, playtest results.