用途:为 Roblox 游戏资产快速生成并应用免费 AI 纹理/皮肤(迷彩、镀金、碳纤维、锈迹等),目标可以是枪械、武器、工具或任意 part/mesh,也支持对整个模型批量处理。
主要能力:流程分五步。第一,检查 Studio 连接,使用官方 Roblox Studio MCP 工具(list_roblox_studios、get_studio_state、search_game_tree、inspect_instance、execute_luau、upload_image、screen_capture),如果 Studio 未连接或未打开就停止并如实告知用户。第二,明确生成风格与目标部件名称,用 search_game_tree 或 inspect_instance 确认目标存在;生成提示词时附加“seamless tileable texture, flat lighting, no watermark, high detail”等限定词。第三,调用内置脚本 generate_texture.py 生成图片,例如:python "<skill_dir>/scripts/generate_texture.py" "camo military texture, seamless tileable texture, flat lighting, no watermark, high detail" ./textures/gun_camo.png --width 1024 --height 1024。该脚本负责 URL 编码、对 Pollinations 限流(匿名每15秒1次请求)进行重试,并校验返回的不是伪装成图片的错误页。第四,本地起 HTTP 服务后用 upload_image 上传为图像资源,参数是图片 URL 而非文件路径;该工具返回 URL 到 rbxassetid://<id> 的映射。第五,用 execute_luau 写入纹理属性,单部件可用 workspace:FindFirstChild("<target>", true).TextureID = "rbxassetid://<id>";多部件模型可遍历 GetDescendants() 中的 MeshPart 批量赋值。最后用 screen_capture 验证渲染结果。
使用方式:首次使用需阅读本地 LOCAL.md(存放路径与工具位置,不共享);不存在时运行 roblox-skills-setup 技能或复制 LOCAL.template.md 填写。生成图片建议先放入 scratch/textures 而非项目目录,并先向用户预览确认再上传,避免浪费上传与审核时间。调整风格时用修改后的提示词重新生成,可通过固定 --seed 保持系列感。上传需本地服务:python -m http.server 8765 --bind 127.0.0.1 --directory ./textures。若没有 Studio,可用 roblox-3d-model 技能的 upload_asset.py 通过 Open Cloud 和自己的 ROBLOX_API_KEY 上传 Image。
适用场景:需要平铺材质、贴花、一次处理多个部件,或希望纹理成为可复用文件的场合;相比 Studio MCP 自带的 generate_texture(针对单个 MeshPart/Model 按提示词做几何感知的重纹理),本流程优势在于可脚本化、平铺与批处理,而非更高质量。
限制:不替代 Roblox 自带几何感知纹理(generate_texture 或 Studio 的 Texture Generator),复杂网格上的 UV 贴合效果更好;不管理 Roblox 资源审核,上传可能被拒,属流程控制之外,应转告用户而非盲目重试;上传后可能有审核延迟导致显示灰色;写错属性(TextureID、Texture 或 SurfaceAppearance)不会报错但会静默无效;Pollinations 本流程仅支持文本生成图片,无编辑/修复端点。