用途:为 Three.js 建造类游戏提供地形交互系统,处理坡度判定、地基锚定与地形修改,使建筑能贴合起伏地面。
主要能力:TerrainAnalyzer 可分析指定位置的坡度,返回角度、法线与是否可建造;FoundationPlacer 支持 valheim、rust、ark 三种地基放置模式,可设置 maxSlope 与 autoLevel;TerrainModifier 提供压平、抬高、降低地形操作;PillarGenerator 可为斜坡自动生成支撑柱。
使用方式:从 scripts 目录导入模块,先用 TerrainAnalyzer 分析地形,再调用 FoundationPlacer.place 放置地基,返回结果包含 valid、height、pillarsNeeded 等字段。可与 structural-physics 集成,将接地地基作为根节点以最大稳定性接入支撑图。
适用场景:Valheim 式需接触地面的地基、Rust 式网格吸附地基、ARK 式带自动支柱的灵活放置。
限制:资料未提供具体安装命令、依赖版本、性能数据与收费信息;高级算法细节见 references/terrain-integration-advanced.md。