Agent Skills
返回列表
💻

Godot 程序化生成

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/thedivergentai-gd-agentic-skills-godot-procedural-generation。

技能介绍

要解决什么问题

在 Godot 里做程序化关卡、地形或刷怪时,最常见的失败模式并不是「算法选错」,而是在主线程上算整块地图、每帧采样噪声、或用全局 randi() 导致同种子也无法复现。一旦生成逻辑和 SceneTree 缠在一起,还会出现 worker 线程里 add_child()、大批量 TileMap.set_cell() 卡顿、以及生成完成后导航网格未重烘焙等问题。

技能如何工作

本技能把可复现生成收敛为一条 Golden Path:先用 proc_gen_seed_history.gd 隔离每块区域的 RandomNumberGenerator 与种子状态;再用 multi_threaded_chunk_gen.gd 通过 WorkerThreadPool 在后台算数据,用 call_deferred 在主线程落地节点与 TileMap;最后按场景需要重烘焙 NavigationRegion。正文明确要求不要粘贴长篇算法教程,而是按需求从决策表加载对应 MANDATORY 脚本,例如迷宫通道用 drunknard_walk_path.gd、矩形房间用 bsp_tree_rooms.gd、有机洞穴用 cellular_automata_dungeon.gd、高度图与生物群落用 fast_noise_noise2d_master.gd、无扎堆刷点用 poisson_disk_sampling_2d.gd、邻接约束地块用 wave_function_collapse_lite.gd 或完整规则版 wfc_level_generator.gd。

适用边界与注意点

简单通路不必上完整 WFC;大地图更新应优先 set_pattern() / set_cells_terrain_connect() 而非逐格写入。序列化应保存种子与玩家改动,而不是整块原始 chunk。Roguelike 流程编排、开放世界分块流式等应交给相关下游技能(如 godot-genre-roguelike),本技能聚焦生成算法与线程提交范式本身。

使用场景

  • Roguelike 项目要在 Godot 4 里用固定种子生成地牢房间图,并保证 Worker 线程只产出网格数据、主线程再写 TileMap
  • 开放世界原型需要按 chunk 异步生成 FastNoiseLite 高度图,避免在 `_process` 里每帧重算噪声
  • 瓦片关卡用邻接规则拼装城市街区,需要 WFC lite 脚本并设置 `max_iterations` 防止约束无解死循环
  • 洞穴关卡用元胞自动机出有机轮廓后,还要在几何落地后重烘焙 NavigationRegion 供敌人寻路

适合人员

  • 独立游戏开发者,正在把 BSP/醉汉漫步地牢生成从单线程原型迁到 WorkerThreadPool + `call_deferred` 落地
  • Godot 4 关卡设计师兼程序员,需要为分享录播或 Speedrun 保存并复用同一 `RandomNumberGenerator` 种子与状态
  • 技术美术负责无限地形 ArrayMesh,需要在后台线程算顶点数组再在主线程 `add_surface_from_arrays` 提交
  • 使用 TileMap 的程序化关卡工程师,要把 CA/WFC 输出从上万次 `set_cell` 改为 pattern 批量写入