CityEngine森林规则包：用CGA规则程序化生成森林景观

简介：面向城市建模软件CityEngine的用户与程序化设计爱好者，该压缩包提供了一套用于生成森林景观的规则文件与配套资产。规则文件重点定义植被类型、空间分布与密度，并加入随机化参数与地形适应性，使树木能根据高度、坡度和朝向自然落位。压缩包内共两千个文件，包含js规则脚本、obj模型、mtl材质、xml配置、png纹理以及txt说明等，整体大小约193.71MB。目前已有一百二十四人学习下载。使用者导入规则后，可通过参数调整树木的高度、冠幅、倾斜角度与生长方向，也能组合多条规则创建针叶林、阔叶林或混合林带，并结合光照阴影计算提升场景真实感。对于城市规划、环境可视化、游戏场景或数字孪生项目，这套资产能直接复用，既提供现成场景资产，也展示可扩展的规则编写思路，是探索植物程序化建模流程的实用参考。

1. 森林景观规则包：不是「一键种树」，而是一整套可复现的种树逻辑

做景观方案模拟的人大概都有过这种经历：一片 5 公顷的山地要种树，手工摆了三天的树，最后被甲方一句「种得太均匀，像阅兵」打回重做。CityEngine 里这类「Cityengine规则森林景观规则.zip」规则包，解决的就是这个场景。它不是一键种树的傻瓜按钮，而是一整套可复现的种树逻辑：包里装着 .cga 规则文件和配套树木模型，你把一个造林范围多边形交给它，它按密度、随机种子、树种比例和地形贴合度，在几分钟内长出一片看起来自然、又能精确复现的森林。

这个方向适合做景观规划、生态模拟、航拍视角虚拟场景的从业者，也适合要给大范围场地快速出植物方案的建筑表现团队。新手可以直接套参数出图，熟手则值得把规则拆开，改成自己的林相。后面所有内容都围绕「读懂规则包、跑通规则包、改好规则包」这条线展开。

2. 规则包拆开看：.cga 是怎么把一片森林「算」出来的

先说结论：规则包和手摆树木的底层差异，在于「给结果」还是「给逻辑」。手摆树摆的是每一棵的位置、大小、朝向；规则包里你只写「在什么范围、什么密度、哪种随机种子、树高多少、压不压地形」，引擎把这个逻辑翻译成成千上万个实例。正因为是逻辑而不是坐标，同一片森林可以改一个参数重算，也可以复制到另一个完全不同的地形上再长一遍。理解这一点，后面调参数时你才知道自己在调什么。

2.1 一个典型森林规则包里藏着哪几类东西

我拿到任何森林规则包的第一动作，是在命令行里先看清单，而不是直接拖进 CityEngine。一个完整的规则包通常包含这几类文件：

看完清单，重点确认两件事：一是 .cga 主入口文件在不在；二是 assets 目录是不是完整的目录结构。很多包导进去树全部消失，或者一片洋红占位，根源就在第二点——发布者打包时漏了资产，或者下载解压时丢了子目录。你手上这个 zip 未必完全按这张表排，但「规则文件 + 资产目录」这个基本盘逃不掉，先按这个思路去核对。

2.2 森林规则的底层逻辑：随机、密度、地形贴合

一片「看起来自然」的森林，在规则里靠三个东西撑起来。

第一是随机分布。机器默认是规则的，如果你给一片多边形铺点，不做任何随机处理，出来的就是阅兵方阵。CGA 里的随机不是「乱来」，而是带种子的伪随机：同一个 seed 值，计算出来的分布完全一致；换一个 seed，林相立刻不同。这条特性在方案评审里极其重要——你今天调的版本，明天开会能原样调出来，而不是重新碰运气。

第二是密度。密度决定单位面积里有多少个树实例，通常写作株/平方米，也有作者用株/公顷。这两个单位差一万倍，是后面多数「参数玄学」翻车的来源。先记住一个公式：实例总数约等于密度乘以多边形面积。后面调参和排错，第一步永远是拿这个公式估算，而不是用眼睛看屏幕。

第三是地形贴合。树不是种在平面上，是种在山坡上的。规则里必须有把实例坐标系贴合到地形表面的动作，否则引擎按默认平面算高度，树要么悬空要么陷地。这三个支柱缺一个，森林就不成立。拆任何森林规则包，先找这三个对应的代码位置。

2.3 一段最小森林规则的逐行拆解

为了让你知道拿到包之后眼睛该往哪看，我用一段最小骨架展示三个支柱在代码里长什么样。真实包会比这复杂得多，但主干逻辑基本一致：

// 最小森林规则骨架：演示随机、密度、地形贴合三个核心点 // 注意：文件头部的 version 声明来自原始包，不要删 attr density = 0.02 // 密度，单位：株/平方米 attr forestSeed = 7 // 随机种子，固定后可复现同一林相 attr mixRate = 0.7 // 主树种占比，取值 0~1 @StartRule Forest --> // 入口规则，对造林范围多边形生效 scatter(surface, density, forestSeed, 0) Tree. Tree --> // 每个散布点生成一棵树 alignScopeToTerrain(yUp, 0) // 关键：树底部贴合地形表面 r(0, rand(0, 360), 0) // 水平方向随机旋转，避免整齐划一 pickVariant. pickVariant --> // 从三档尺寸模型里按概率选一个 case rand(0, 1) < 0.33: i("assets/tree_small.obj") case rand(0, 1) < 0.66: i("assets/tree_mid.obj") else: i("assets/tree_big.obj")

几个地方需要说明。scatter 这行是分布引擎：第一个参数指在 surface 表面布点，第二个参数是密度，第三个参数是种子，第四个参数控制散布点朝向，0 表示默认模式。alignScopeToTerrain 这行是贴地开关，多数包作者会把它放在树规则的第一行；如果放在旋转之后，最终朝向会不同。pickVariant 这段用了三档尺寸模型而不是随机缩放，这是有讲究的：对一棵带树冠的树做三轴独立缩放，会把树冠拉变形、贴图拉伸，成熟包通常预置几档尺寸模型，用概率分支去选。

需要提醒的是，不同版本对 alignScopeToTerrain 和 scatter 的参数个数支持有差异。你拿到的包如果报语法错误，先看包内注释和原始 version 声明，不要照抄网上任何一份代码直接覆盖。拆包时先搜这三个关键词：scatter、alignScopeToTerrain、case rand，基本就能定位这片森林是怎么长出来的。

3. 从 ZIP 到成林：跑通规则的五个步骤与四个关键参数

如果说读懂规则是第一步，跑通规则才是第二步。很多人失败不是规则写得不好，而是第一步就没走对——坐标系对不上、地形没识别、规则挂错了图层。下面这条路径我重复过很多次，照做基本一把过。

3.1 动手前先检查包：命令行清单与坐标系准备

拿到 zip 别急着解开，先在命令行里看看包结构：

# 查看规则包清单，确认入口规则与资产目录是否齐全 unzip -l Cityengine规则森林景观规则.zip

看输出时关注三件事：有没有 .cga 文件；assets 或类似名字的目录是否存在；包里有没有 .cej 示例场景。如果存在示例场景，最稳妥的验证方式是先打开它生成一次，规则包本身坏没坏，一眼就能看出。如果包只有规则文件没有资产，那后面挂到场景里必然缺模型，趁早找作者补文件。

然后是坐标系。CityEngine 的场景坐标和你的地形数据必须一致，最怕地理坐标和投影坐标混用。比如你手上的 DEM 是带投影的，场景却默认成了经纬度，导进去山体会变形，树自然贴不到该贴的位置。我的习惯是新建场景时就明确坐标系来源，导入数据后先叠加一个已知位置的参考线验证，再谈种树。坐标系错了，后面所有调整都是白费。

3.2 最小跑通流程：四步从空场景到一片林子

整条流程压成四步，每一步都不需要额外插件。

第一步，新建场景，坐标系选与数据一致。纯粹测试规则包时用默认坐标也行，但后面换真数据时记得重建场景，不要复用测试场景，否则坐标系残留问题会让你排查到怀疑人生。

第二步，导入地形。DEM 栅格数据要导入成地形图层，而不是普通图形图层——这是树能否贴地的关键。手头没有 DEM 时，先画一个多边形当平地测试，规则照样能跑。测试阶段用平地，排错阶段会省很多事，因为你天然排除了地形变量。

第三步，画造林范围或导入边界。用多边形工具沿着设计范围画一个闭合面，或者导入现成的矢量边界。注意这个面必须在空间上和地形叠上。如果面和地形隔着十万八千里，树就会长在空气里，这个问题和规则本身无关。

第四步，挂规则并生成。选中范围图层，在属性面板里选择规则包，或从资源管理器把 zip 拖到图层上，然后执行生成。生成后别急着看三维视口，先打开图层面板看实例计数——数字对了，森林大概率没问题；数字不对，直接进参数排查。

# 如果习惯命令行管理工程，至少记住这一步： # 把规则包和资产放进工程目录，保持相对路径不被拆散 cp Cityengine规则森林景观规则.zip ./projects/forest_scene/rules/

最后这句是血泪教训：规则包一旦脱离 assets 目录，几乎所有相对路径引用都会断。后面 4.3 会讲得更细，这里先记住——包要整体进工程，不要只拖一个 .cga 文件进去。

3.3 四个值得先动的参数与它们的联动关系

规则跑通后，真正决定森林像不像样的，是参数面板里的几个旋钮，最常动的是这四个：

先看联动关系。实例总数等于 density 乘以面积：一块 100 米乘 100 米的测试区，density 设 0.02 株/㎡，理论上是 200 株。生成完一看只有 20 多棵，先怀疑单位，包作者很可能用的是株/公顷；如果一下冒出 2000 棵，视口已经开始卡，那 density 就往小数点后挪一位。

seed 和密度是两回事。seed 只改变树分布的位置，不改变树的总数；density 只改变总数，不改变随机感。很多新手调了 seed 发现树还是那个样，其实种子的作用范围是散布点位置和树高朝向的随机序列，换一个 seed 看的是树的排列关系变化，不是总量变化。

heightMin 和 heightMax 影响林相层次。区间大，森林显得野；区间小，树高整齐得像人工林。有的包用这两个值做随机缩放，有的包预置多档模型，具体看包作者的实现。mixRate 是树种构成的比例旋钮，做生态过渡带时最常用。改完任何参数记得重新生成，引擎按新参数重算整片林子，而不是增量添加——这一点和手工建模的直觉完全不同。

4. 森林规则避坑指南：四个高频翻车现场与排查路径

规则包这种东西，跑通容易，跑出自然感难。我在这类森林景观项目里被咬过太多次，下面四个坑按出现频率排，每一条都按「现象 → 原因 → 解决」给了排查路径。

4.1 树悬在半空或陷进地里：地形贴合的三种失效场景

现象：树整体浮在山体上方，像一层飘着的贴纸；或者树根插进山坡里一截，树冠露在外面。

原因通常有三种。第一种是地形没被识别成地形图层。DEM 导入时如果类型选错，引擎只把它当普通平面，规则里的贴合动作找不到真实表面，所有树按默认平面高度生成，于是悬空。第二种是规则里压根没有 alignScopeToTerrain 这个动作，这常见于从旧版本迁移过来的包。第三种是树木模型的原点不在根部——很多下载的植物模型原点在几何中心，贴合后中心贴地，根部自然埋进土里。

解决：先看地形图层的类型标识是否正确；再打开 .cga 搜索 alignScopeToTerrain 是否存在；如果模型原点有问题，用模型编辑工具把原点挪到树干基部，或者给贴合动作加一个向上偏移。还有一个容易被忽略的元凶是场景单位不一致，树模型按厘米建模而场景按米，导进去不是蚂蚁就是巨杉。排查树的位置问题，永远先确认「地形类型、贴地语句、模型原点、单位」四件事。

4.2 密度参数像玄学：调了没变化，或者直接爆树

现象：density 从 0.01 调到 0.1，视口纹丝不动；或者只调了一下，整个范围瞬间变成密不透风的板寸，拖动视角都卡。

原因有三个层级。第一层是单位差，0.02 株/㎡ 和 0.02 株/公顷差了整整一万倍，很多包参数注释不清，作者默认株/公顷，你按株/㎡ 理解。第二层是你调的不是真正生效的属性——包可能有多个规则入口，面板上显示的是外层属性，里面被隐藏的中间属性才是真正算密度的那个。第三层才是真出问题：属性名字对上了但没被引用，规则里根本没有用到这个值。

排查顺序：先画一个 100×100 米的测试面，把 density 设为 0.01，预期 100 株。数量差一个数量级就先查单位；然后打开 .cga 搜索 density，看它是否被 scatter 引用；最后以图层面板的实例数为准，不要用眼睛数树。密度这个参数从来不是玄学，是单位注释没做好的规则包太多，把锅甩给了参数。

4.3 贴图和模型全丢：路径与编码引发的资产失踪

现象：树全部变成占位色或者线框，控制台刷出一排 Could not load asset，换电脑、换工程目录之后尤其常见。

原因：第一，包里用的是相对路径，但你把 .cga 单独拖出来用过，assets 目录没跟着走，引用全部断掉。第二，某些包在打包前写死了绝对路径，比如某个盘的固定文件夹，换到别的机器必然失效。第三，中文文件名或中文目录在部分系统上编码解析失败，模型和贴图读不出来，表现就是「规则在跑，树没了」。

解决：始终把 zip 作为整体导入，不要在工程外解压后又手动搬文件；打开 .cga 检查所有资产引用是不是相对路径，是绝对路径就改成相对路径；把资产文件名统一改成纯英文数字；重新打包成 zip 再导入。换电脑时把整个工程目录连同规则包一起拷走，而不是只拷一个 .cga 文件。

4.4 一生成就卡死：几何体数量失控的排查顺序

现象：点下生成，视口开始转圈，内存占用爬到 90% 以上，最后直接崩溃；或者生成完了，缩放视角像放幻灯片。

原因基本是几何体数量失控。三个常见来源：密度乘以面积算出的实例数超出机器承受范围；单棵树模型面数过高，一棵树几万面，几千棵树就是几亿面；规则里还嵌套生成了树干、树冠多层结构，让每个散布点最终产出几十个网格对象。

排查顺序：先用公式算总量，density 乘面积，把实例数压到五万以内再谈效果；再用低模临时替换 assets 里的高模做预览，确认是模型面数问题还是分布数量问题；然后把大范围多边形切块生成，避免一次全算；最后在导出前给远处森林换 LOD 低模，近景才保留高模。顺序不能反，先砍数量再看模型，不然你永远不知道是哪个环节爆的。

注意：生成前确认选中的是范围图层而不是整个场景。把规则挂到全场景图层上再点生成，是「卡死」类问题里最常见的低级原因，排错第一步永远是看选中的图层对不对。

5. 把规则改成你的：灰度图做过渡带与交付前检查

跑通别人的规则包只是起点，真正值钱的，是把它改造成你项目需要的林相。森林规则最难的不是让树长出来，而是让树长对地方、长对样子。这里分享两个我常用的改造技巧，以及一个每次交付都会跑的收尾检查。

5.1 用一张灰度图驱动树种过渡带

森林不是棋盘格，海拔高一点针叶多，山谷里阔叶多。我一般会在规则里加一张灰度图，按树所在位置采样灰度值，再把这个值映射成树种选择，过渡比手画边界自然得多：

// 示意逻辑：按灰度图亮度在两套树种间切换 // sampleMask 为示意函数名，实际写法以你所用版本为准 Tree --> alignScopeToTerrain(yUp, 0) r(0, rand(0, 360), 0) speciesByMask. speciesByMask --> case sampleMask(position.x, position.z) > 0.5: i("assets/tree_conifer.obj") else: i("assets/tree_broadleaf.obj")

这套思路的关键不在函数名，而在「把一个连续变量映射到离散树种」——灰度、高程、坡度都可以当变量，比手动画分区边界省力得多，也经得起规划评审的追问。

5.2 交付前三十秒的检查

出图前我会固定做四件事：看图层面板的实例数和规划密度对不对得上；从四个方向俯视，找悬空、陷地、断崖处漏树；确认规则包和资产都在工程目录内，相对路径没被破坏；确认 seed 已经固定，不然下次放样又是一片陌生的林子。

我现在的习惯是把 seed 和 density 直接写进项目的备注表，不然半个月后回来看这个包，连自己都忘了当初那片林子是怎么长出来的。被模型失踪、生成爆卡、密度翻车这类问题咬过几次之后，这套检查就成了肌肉记忆。希望帮到你。

本文还有配套的精品资源，点击获取