地形变体

模组可以为现有地形添加外观。每种变体保留基础地形的移动、建造、掩护和破坏规则。仅启用模组不会改变普通地图：地图通过 "terrainVariants": { "city": "my-mod-city" }，或编辑器中的地形外观选择器，选用自己的样式。地图导出和存档会保留这些选择。变体缺失或被禁用时，显示普通基础地形。

材质

在 sprites 中声明材质图片，键名例如 ter.my-mod-concrete。图片必须为单帧正方形，fw 和 fh 为相等的整数，范围为 4 至 512，推荐 128。地形材质保留完整图像：teams、stripBg、rotated、fitFootprint 和 freezeStatic 默认为 false，不可开启。不支持锚点、炮塔挂点、旋转枢轴和动画设置。平面材质应不透明、无缝拼接，不绘入建筑、文字或投影；city.signTexture 则可包含招牌图案。材质只能引用本模组的图片。

平面地形使用 texture。城市则通过 city 为屋顶、墙面和庭院设置颜色与材质，也可设置窗灯、路灯与建筑装饰灯颜色。城市至少需要一个外观字段；省略 architecture 时保留普通城市的建筑几何形状。纯地形模组可以使用 "defs": []。

城市建筑

可选的 city.architecture 组合重新设计可见建筑，同时保留基础城市格的移动、掩护和破坏规则。可混合选择互不重复的板楼、庭院街区、露台楼与阶梯塔楼，并设置可见楼层范围、地块覆盖比例、植被、屋顶设备与立面结构。signTexture 可包含用于建筑招牌的图案；它不要求像平面材质那样无文字。损坏状态仍会使建筑倒塌、招牌熄灭。楼层下限不能超过上限，省略字段时也要考虑其默认值。

招牌

signTexture 是 4×4 网格中的 16 个正方形招牌，从左到右、从上到下排列；每栋建筑的确定性种子选择其中一格。fw 与 fh 应相等且能被四整除，推荐 128。使用暗色不发光底板与明亮文字或符号；RGB 最亮通道超过 120 的像素会在夜间发出自身颜色。这是一帧图集，不是横向动画帧条。缺失图片时使用程序绘制的符号。

参考

地形变体（terrains[]）

城市（terrains[].city）

城市建筑（terrains[].city.architecture）