Asset Generator

游戏资产生成技能

通过 AI 服务生成游戏资产，并自动导入 Godot 项目。

前置条件

1. 确保已配置相应服务的 API Key（见 external-api skill）
2. 确保项目目录结构已初始化

资产类型与服务映射

3D 模型生成

生成流程

用户提示 → AI 生成 → 下载 GLB → 导入 Godot → 更新清单

提示词模板

角色模型

{style} {character_type} character, game-ready model, T-pose, 
low-poly ({poly_count} triangles), clean topology, 
{texture_style} texture, full body

示例：

cartoon fantasy knight character, game-ready model, T-pose,
low-poly (5000 triangles), clean topology, 
hand-painted texture, full body

道具模型

{item_name}, game prop, {style} style, 
{poly_count} polygons, centered, {material_description}

示例：

medieval sword, game prop, stylized fantasy style,
2000 polygons, centered, metallic blade with leather-wrapped handle

环境模型

{environment_object}, game asset, modular, 
{style} style, optimized for games, {additional_details}

导入配置

{
  "import_options": {
    "generate_collisions": false,
    "generate_lightmap_uv": false,
    "create_shadow_mesh": true,
    "scale": 1.0,
    "offset": [0, 0, 0],
    "import_animations": true
  }
}

生成后处理

1. 碰撞体生成：复杂模型需手动或使用简化网格
2. 材质调整：检查材质是否正确导入
3. LOD 设置：为大型模型设置细节层次

贴图生成

贴图类型

无缝贴图（Tileable）

seamless tileable {material} texture, top-down view, 
high detail, 4k resolution, pbr ready, {additional_details}

示例：

seamless tileable stone floor texture, top-down view,
high detail, 4k resolution, pbr ready, medieval dungeon style

精灵/角色

{character} sprite, {view} view, {style} style, 
transparent background, game asset, {size} pixels

示例：

pixel art knight sprite, side view, 16-bit style,
transparent background, game asset, 64x64 pixels

UI 图标

game UI icon, {item_name}, flat design style, 
{color_scheme} colors, transparent background, {size}x{size}

Tileset

2D game tileset, {theme} theme, {tile_size}x{tile_size} tiles,
{count} variations, top-down view, seamless edges

尺寸规范

导入配置

{
  "import_options": {
    "compress_mode": "lossless",
    "mipmaps": true,
    "filter": true,
    "repeat": "enabled",
    "size_limit": 0
  }
}

音频生成

背景音乐

提示词模板

{genre} {mood} music, {tempo} bpm, {instruments},
game soundtrack, {duration} seconds, loop-ready

场景音乐示例：

音效

音效通常需要组合或后处理，建议：

1. 使用音效库（Freesound、Sonniss 等）
2. AI 生成基础音效后在 Audacity 中调整

常用音效类型：

• 脚步声（草地、石头、木板）
• 攻击/打击声
• 拾取物品
• UI 点击/悬停
• 环境音效（风、水、火）

语音生成

interface VoiceConfig {
  character_name: string;
  voice_id: string;        // ElevenLabs voice ID
  personality: string;     // "wise old man" | "young hero" | "villain"
  emotion: string;         // "neutral" | "angry" | "sad" | "happy"
}

// 批量生成对话
interface DialogueLine {
  id: string;
  text: string;
  emotion?: string;
}

音频导入配置

{
  "music_import": {
    "loop": true,
    "bpm": 120,
    "beat_count": 0
  },
  "sfx_import": {
    "loop": false
  }
}

资产清单管理

manifest.json 结构

{
  "version": "1.0.0",
  "last_updated": "2026-04-16T10:30:00Z",
  "assets": {
    "models": [],
    "textures": [],
    "audio": {
      "music": [],
      "sfx": [],
      "voice": []
    }
  }
}

资产条目格式

{
  "id": "model_player_knight",
  "name": "Player Knight",
  "type": "model_3d",
  "path": "res://assets/models/characters/player_knight.glb",
  "source": {
    "service": "meshy.ai",
    "prompt": "cartoon fantasy knight character...",
    "generation_date": "2026-04-16T10:30:00Z",
    "task_id": "task_abc123"
  },
  "metadata": {
    "poly_count": 5000,
    "has_animations": true,
    "animations": ["idle", "walk", "run", "attack"],
    "materials": ["body", "armor", "weapon"]
  },
  "tags": ["player", "character", "knight", "humanoid"]
}

更新清单

func add_asset_to_manifest(asset_info: Dictionary) -> bool:
    var manifest_path = "res://assets/manifest.json"
    var manifest = load_json(manifest_path)
    
    if manifest == null:
        manifest = {
            "version": "1.0.0",
            "last_updated": "",
            "assets": {
                "models": [],
                "textures": [],
                "audio": {"music": [], "sfx": [], "voice": []}
            }
        }
    
    # 根据类型添加到对应数组
    var asset_type = asset_info.get("type", "")
    match asset_type:
        "model_3d":
            manifest.assets.models.append(asset_info)
        "texture", "sprite":
            manifest.assets.textures.append(asset_info)
        "music":
            manifest.assets.audio.music.append(asset_info)
        "sfx":
            manifest.assets.audio.sfx.append(asset_info)
        "voice":
            manifest.assets.audio.voice.append(asset_info)
    
    manifest.last_updated = Time.get_datetime_string_from_system()
    
    return save_json(manifest_path, manifest)

批量生成

从配置批量生成

{
  "batch_generate": {
    "characters": [
      {
        "id": "player",
        "prompt_template": "cartoon {class} character",
        "variants": ["knight", "mage", "archer"]
      }
    ],
    "items": [
      {
        "category": "weapons",
        "items": ["sword", "staff", "bow"],
        "style": "fantasy medieval"
      }
    ]
  }
}

批量处理流程

async function batchGenerate(config: BatchConfig): Promise<BatchResult[]> {
  const results: BatchResult[] = [];
  
  for (const item of config.items) {
    // 控制并发，避免 API 限制
    await delay(1000);
    
    const result = await generateAsset(item);
    results.push(result);
    
    // 更新进度
    console.log(`Generated ${results.length}/${config.items.length}`);
  }
  
  return results;
}

最佳实践

1. 提示词迭代：先用低质量快速测试，确认效果后再生成高质量版本
2. 版本管理：在清单中记录生成参数，方便重新生成
3. 统一风格：在提示词中保持一致的风格描述词
4. 资源复用：相似资产使用变体而非重新生成
5. 本地缓存：避免重复生成相同资产

AI 生图编排流程（需要后端服务支持）

此流程依赖 godot-plugin-backend 后端服务和 4 个内部 MCP 工具。

触发条件

用户自然语言中包含以下意图之一：

• 「生成 / 创建 / 做一个 图片 / 图标 / 贴图 / 背景 / 立绘 / 素材」
• 「generate / create image / icon / texture / sprite / asset」
• 明确提到尺寸、风格（像素 / 写实 / 动漫）+ 素材相关

编排步骤

第 1 步：检查登录

调用 check_auth MCP 工具：

check_auth({ action: "check" })

• 返回 authenticated: true → 继续
• 返回 authenticated: false → 输出登录引导，告诉用户： 「需要登录才能使用 AI 生图服务。请在浏览器中访问 {loginUrl} 完成 GitHub 授权。 授权完成后，将页面显示的 Token 告诉我，我会帮你保存。」
• 用户提供 Token 后，调用 check_auth({ action: "save", token: "..." }) 保存

第 2 步：校验额度

调用 get_user_quota MCP 工具：

get_user_quota({})

• 返回 sufficient: true → 继续，告知用户当前剩余额度
• 返回 sufficient: false → 告诉用户「额度不足（剩余 0），请联系管理员申请更多额度」

第 3 步：优化提示词

Skill 自身能力，根据游戏类型和 Godot 需求自动优化提示词：

还会根据用户指定的尺寸自动适配，如果没指定则用合理默认值。

第 4 步：请求生图

调用 generate_image MCP 工具：

generate_image({
  prompt: "用户原始提示词",
  optimizedPrompt: "Skill 优化后的完整提示词",
  width: 128,
  height: 128,
  style: "pixel",
  outputDir: "${gameDir}/assets/generated"
})

• 返回 status: "SUCCESS" → 获得 localPath，继续
• 返回 error → 告诉用户「生成失败：{message}，已自动退还额度」

第 5 步：导入到 Godot 项目

调用 import_to_godot MCP 工具：

import_to_godot({
  sourcePath: "{generate_image 返回的 localPath}",
  targetDir: "${gameDir}/assets/icons",
  fileName: "coin.png"
})

• 将图片从临时目录复制到用户指定的项目目录
• 默认目录：${gameDir}/assets/generated/
• 用户可以指定：「导入到 assets/icons/」

第 6 步：返回结果

• 成功：「✓ 已生成 [描述] 并导入到 [resPath]，剩余额度：XX」
• 失败：「✗ 生成失败：[错误原因]，已自动退还额度」

完整调用示例

用户说：「给我生成一个 128×128 的像素金币图标，放到 assets/icons/」

1. check_auth({ action: "check" })
   → authenticated: true, userName: "alice"

2. get_user_quota({})
   → remainingQuota: 47, sufficient: true

3. [Skill 优化提示词]
   原始: "128×128像素金币图标"
   优化: "128x128 pixel art gold coin icon, game asset, transparent background, no watermark, suitable for Godot engine, top-down view, 16-bit color"

4. generate_image({
     prompt: "128×128像素金币图标",
     optimizedPrompt: "128x128 pixel art gold coin icon, ...",
     width: 128, height: 128, style: "pixel"
   })
   → status: SUCCESS, localPath: "/tmp/generated_xxx.png", remainingQuota: 46

5. import_to_godot({
     sourcePath: "/tmp/generated_xxx.png",
     targetDir: "${gameDir}/assets/icons",
     fileName: "coin.png"
   })
   → success: true, resPath: "res://assets/icons/coin.png"

6. 返回：「✓ 已生成像素金币图标并导入到 res://assets/icons/coin.png，剩余额度：46」