企业官网建设流程全解析

从 AI 图到可编辑场景：Agent Sprite Forge 导出 Godot TileMap 全流程指南

【免费下载链接】agent-sprite-forgeAgent Skill for generating 2D sprite sheets and map, transparent PNG frames, and animated GIFs from prompts.项目地址: https://gitcode.com/gh_mirrors/ag/agent-sprite-forge

Agent Sprite Forge 是一款面向 2D 游戏的AI 资产生成技能，用一句自然语言提示，就能产出可直接进引擎的 2D 地图、精灵图与道具包。这篇指南聚焦它最实用的能力之一：把 AI 生成的 tileset 和道具接入 Godot 4，导出一个真正可编辑的 TileMap 场景——包含分层 tile 层、独立 props、碰撞体、遇怪草丛与出口触发区。你不需要手绘像素，也不用手动对齐格子。

为什么它比"一张 AI 地图图"更值得用

多数 AI 绘图工具给的是一整张烤死（baked）的图：好看，但角色无法穿墙、无法分层、无法单独挪动一棵树。而 Agent Sprite Forge 的$generate2dmap技能会走layered_tilemap+Godot_TileMap管线，把一张漂亮图拆成可编辑的游戏数据。

一句话概括这条管线（项目里叫 map-strategies.md）：

image_gen tileset + prop_pack_3x3 + layered_tilemap + separate_props + trigger_zones + Godot_TileMap

• 图由 AI 画：tileset 与道具都是内置图像生成产出，风格统一。
• 脚本只干活：去背、切格、对齐、拼预览、生成元数据，不碰创意。
• 结果是引擎原生文件：.tscn场景 + 分层TileMapLayer，打开就能改。

准备工作：安装 Agent Sprite Forge 技能

本地后处理脚本依赖Python、Pillow、numpy（视频类技能才需要 ffmpeg），清单见 requirements.txt。安装分两步：克隆仓库 → 把skills/拷进代理的技能目录，然后新开一个会话让技能重载。

# macOS / Linux mkdir -p ~/.codex/skills cp -R ./skills/* ~/.codex/skills/

装好后，在对话里用$generate2dmap即可调用地图技能；$generate2dsprite则负责精灵图。

导出 Godot TileMap 的完整流程

第一步：选对地图模式（tile_mode）

技能会先问你要哪种map_mode。要进 Godot 的可编辑地图，认准tile_mode——它默认就是layered_tilemap+interactive_scene_objects+tile_collision+trigger_zones。

新手提示：Pokémon 风格、俯视角 RPG、怪物养成路线、平台跳跃 tilemap，都可以直接说"做成 Godot 可编辑地图"，技能会自动路由到tile_mode。

第二步：用 AI 生成 tileset 和道具包

这一步是创意核心，由代理自己写图像提示词：

1. 先画 tileset 图集：草地、土路、水域、石桥、花丛、高草、树木、木门……一张网格图搞定。
2. 再批量生成道具包：把小、紧凑的装饰物（草丛、石头、木牌、栅栏、树桩、墓碑）塞进一张3x3 洋红底道具表，交给 extract_prop_pack.py 逐个切出透明 PNG。

下面是本例的 3x3 道具包（洋红 = 待去背的纯色底）：

规则提醒：只有"紧凑装饰物"才进方形道具包；平台、长桥、大门、高树这类要碰撞对齐的对象必须单独生成，别混在道具表里。详见 prop-pack-contract.md。

第三步：把资产接入 Godot TileMap 场景

这是"可编辑"的魔法所在。技能会把 tile 和道具写成一个真正的 Godot 4 场景，节点结构一目了然：

• TileLayers下分多个TileMapLayer：
  • Ground_TileMapLayer（地面）
  • Water_And_Bridge_Tile（水与桥）
  • Decor_TileMapLayer（装饰）
  • Encounter_Grass_TileM（遇怪草丛，配Area2D）
  • Obstacle_TileMapLayer（阻挡，配StaticBody2D碰撞）
• YSorted_SeparateProps下每个道具是独立Sprite2D（tree_north_1、rock_west_1、fallen_log_1…），按 Y 轴排序，角色能走到树后/树前。
• 再挂上出口Area2D、相机边界和一个debug 玩家 + 摄像机，直接能跑。

第四步：验证碰撞、触发区与预览

别急着交付。技能会生成两张"体检图"帮你确认：

• 碰撞 / 触发区调试叠加层：红框 = 阻挡体，绿框 = 遇怪草丛，紫线 = 相机与边界。
• 拼合预览：把基础图 + 最终运行时对象叠在一起，检查在相机尺寸下是否连贯（脚本见 compose_layered_preview.py）。

你会拿到哪些文件

一次tile_mode导出，典型产物包括：

想深入分层地图的层分离契约（基础层只能放"地形"，不能烤进可交互物体），读 layered-map-contract.md。

新手避坑指南 🎮

• 别接受"一张烤图 + 碰撞框"当成品——那只是带血条的背景，不是可玩地图。
• 基础层保持干净：树、门、箱子、陷阱必须独立，否则角色穿不过去。
• 方形道具包只装小装饰，碰撞对齐的对象单独生成。
• 生成后先看调试图，再进引擎，能省掉大量手动排查。
• 商用项目优先用原创角色 / 自有 IP，避免版权风险。

一句话总结：你说一句"给我一张 Godot 可编辑的 RPG 地图"，Agent Sprite Forge 负责画、切、拼、接好节点，你拿到的是一张能在编辑器里继续改的 TileMap 场景，而不是一张死图。

📌 技能定义与策略参考：skills/generate2dmap/SKILL.md · README

【免费下载链接】agent-sprite-forgeAgent Skill for generating 2D sprite sheets and map, transparent PNG frames, and animated GIFs from prompts.项目地址: https://gitcode.com/gh_mirrors/ag/agent-sprite-forge