roblox-asset-pipeline

Roblox 资源管线

目标

选择符合游戏幻想、能可靠加载且符合移动端性能预算的资源。

选择顺序

1. 使用 search_asset 搜索现有资源。
2. 插入 Creator Store 或第三方模型／资源包前，先计划执行 roblox-creator-store-security-audit 审计。
3. 使用 insert_asset 插入选定的资源。
4. 仅当现有资源不符合需求时，才使用 generate_mesh 生成自定义网格。
5. 使用 generate_material 为独特的表面效果生成自定义材质。
6. 适合使用可配置的基元模型时，使用 generate_procedural_model 生成程序化模型。
7. 对于需要转换为 Roblox 资源的本地或网络图片，使用 store_image 或 upload_image。

跨所有者注意事项

当资源库中的资源属于当前 place 的其他所有者时，插入前须征得用户明确同意。说明资源来源所有者和目标位置。

安全审计要求

Creator Store 和第三方模型／资源包可能包含脚本。插入任何第三方模型、资源包、UI、游戏玩法资源或类似插件的资源后，在信任它或让其脚本保持启用前，使用 roblox-creator-store-security-audit 进行审计。尽可能优先选择纯视觉资源。将混淆代码、可疑的 require 调用、动态资源加载、HTTP 使用、DataStore 修改、远程对象创建、隐藏脚本和欺骗性名称视为高风险。

美术方向

• 保持剪影语言、比例、调色板和材质风格一致。
• 让重要的可交互对象比背景道具更醒目。
• 设计图标和缩略图时，确保它们在小尺寸下也清晰易辨。
• 避免在首个区域使用昏暗、杂乱或细节过多的资源，以免遮挡游戏玩法。

性能预算

• 移动端优先使用低到中等面数的网格。
• 留意纹理尺寸、透明度、粒子、动态光照和物理复杂度。
• 除非需要模拟，否则将装饰性道具锚定。
• 尽可能将重复的装饰物转换为开销更低、可重复使用的模式。
• 大批量添加资源时，进行性能审查。

MCP 工作流

1. 搜索或生成资源。
2. 将第三方资源插入受控的隔离文件夹或工作区位置。
3. 使用 inspect_instance 检查。
4. 对第三方模型／资源包／游戏玩法／UI 资源执行导入安全审计。
5. 使用 screen_capture 检查视觉效果是否合适。
6. 如果资源会影响碰撞、导航、UI 或交互，则进行游戏测试。
7. 检查 get_console_output。

输出

返回：

• 资源来源或生成方式。
• 放置位置和所有权说明。
• 第三方导入资源的安全审计结果。
• 视觉适配说明。
• 性能风险。
• 已执行的验证。

后续步骤

在信任任何导入的第三方资源前，使用 roblox-creator-store-security-audit 对其进行审计，并使用 roblox-performance-optimization 检查其开销。