Unreal Fest Chicago 2026 的場(chǎng)次里“Introducing Mesh Terrain”這個(gè)議題在關(guān)卡美術(shù)和程序化生成圈子里被反復(fù)提起。這篇是對(duì)該分享主題的搬運(yùn)整理和二次解讀需要先說明一點(diǎn)本文不是親臨現(xiàn)場(chǎng)的實(shí)錄也不是對(duì)官方未公開細(xì)節(jié)的轉(zhuǎn)述而是基于該分享的主題定位、引擎現(xiàn)有地形體系的實(shí)際表現(xiàn)以及網(wǎng)格化地形在業(yè)內(nèi)的既有實(shí)踐做一次系統(tǒng)性的拆解。所以凡是涉及具體版本號(hào)、具體 API 簽名的地方我都會(huì)標(biāo)注“以實(shí)際引擎版本為準(zhǔn)”不會(huì)硬編一個(gè)數(shù)字上去。先說判斷Mesh Terrain 真正值得關(guān)注的并不是“又多了個(gè)地形工具”。如果只把它理解成 Landscape 的替代品很容易錯(cuò)過重點(diǎn)。它真正在改的是地形這件事的“數(shù)據(jù)歸屬”——地形從一類被引擎特殊照顧的 Actor變成了一種普通的網(wǎng)格資產(chǎn)。這個(gè)身份變化會(huì)連帶把美術(shù)流程、程序化管線、碰撞和渲染的優(yōu)化權(quán)從引擎手里往開發(fā)者手里挪一大截。如果你正在做開放世界、大尺度地形、程序化生成關(guān)卡或者被 Landscape 的組件分辨率、RVT 接縫、碰撞精度折騰過這篇文章值得往下看。下面會(huì)按概念對(duì)齊、工作流變化、環(huán)境準(zhǔn)備、核心流程、完整代碼、結(jié)果驗(yàn)證、排錯(cuò)、工程建議的順序展開代碼部分給的是能直接復(fù)制跑的最小示例包括一個(gè)把高度圖轉(zhuǎn)成 OBJ 網(wǎng)格的腳本用來講清“網(wǎng)格地形到底是怎么被造出來的”。1. 為什么地形系統(tǒng)又成了繞不開的話題虛幻引擎的地形方案在很長(zhǎng)時(shí)間里只有一條主路Landscape。它的思路非常直接一張高度圖定義起伏引擎按組件Component把這張圖切成網(wǎng)格狀的小塊每塊有自己的 LOD材質(zhì)通過地形圖層權(quán)重混合。這套方案在中小規(guī)模場(chǎng)景里非常好用編輯器內(nèi)的雕刻工具也足夠順手所以很多團(tuán)隊(duì)從項(xiàng)目第一天就一直用它直到撞墻。撞墻的地方通常集中在幾個(gè)位置。第一個(gè)是分辨率。Landscape 的組件尺寸和每組件段數(shù)在創(chuàng)建地形時(shí)就定死了后面想大幅提高精度要么重建要么靠 Runtime Virtual Texture 或者額外的細(xì)分網(wǎng)格去補(bǔ)細(xì)節(jié)補(bǔ)的過程很容易在不同 LOD 之間、不同組件之間出現(xiàn)接縫和紋理拉伸。第二個(gè)是形狀自由度高度圖本質(zhì)是一張二維灰度圖它沒法表達(dá)懸崖下方的凹陷、洞穴、懸垂結(jié)構(gòu)遇到這類地形要么繞開要么疊一堆靜態(tài)網(wǎng)格體上去疊完之后碰撞和遮擋關(guān)系又變成新的麻煩。第三個(gè)更偏工程側(cè)Landscape 是一個(gè)“特殊 Actor”它的數(shù)據(jù)格式、編輯方式、導(dǎo)入導(dǎo)出路徑都跟普通靜態(tài)網(wǎng)格體不一樣。這意味著你的程序化生成管線、資產(chǎn)檢查腳本、自動(dòng)化打包流程都要為它單獨(dú)寫一套分支邏輯。當(dāng)一個(gè)項(xiàng)目的地形主要由 Houdini 或者自研工具生成的時(shí)候這種特殊性帶來的維護(hù)成本會(huì)持續(xù)累加。Mesh Terrain 這個(gè)議題出現(xiàn)的背景就在這里。它要回答的問題不是“怎么把地形雕得更好看”而是“地形能不能像其他所有資產(chǎn)一樣被對(duì)待”。這個(gè)問題的答案一旦變成“能”很多原本被引擎鎖死的優(yōu)化手段就重新回到開發(fā)者手上。這也是我覺得它比單純的工具更新更值得關(guān)注的原因。2. 概念對(duì)齊Landscape 與 Mesh Terrain 的本質(zhì)差異在往下講流程之前必須先把幾個(gè)容易混淆的概念掰開。很多討論一上來就說“網(wǎng)格地形性能更好”或者“網(wǎng)格地形更靈活”這類結(jié)論如果不落到具體機(jī)制上基本沒有指導(dǎo)意義。2.1 Landscape 的本質(zhì)是一張被拉伸的高度圖Landscape 的底層數(shù)據(jù)就是一張高度圖每個(gè)像素對(duì)應(yīng)一個(gè)高度值。引擎在創(chuàng)建時(shí)按Component Size和Sections Per Component把它切成網(wǎng)格每個(gè)組件在運(yùn)行時(shí)按距離切換 LOD。材質(zhì)的混合依賴圖層權(quán)重圖Weightmap每一層對(duì)應(yīng)一組紋理和一套參數(shù)。這套設(shè)計(jì)的優(yōu)勢(shì)是內(nèi)存友好、編輯直觀、LOD 切換有引擎內(nèi)建支持。代價(jià)是拓?fù)浣Y(jié)構(gòu)被固定成了規(guī)則網(wǎng)格細(xì)節(jié)層次完全由分辨率決定。想要一個(gè)銳利的巖石邊緣只能靠法線貼圖和位移幾何本身仍然是那個(gè)規(guī)則網(wǎng)格。這里真正容易踩坑的地方是很多人以為提高組件分段數(shù)就能解決精度問題實(shí)際上分段數(shù)提高之后單個(gè)組件覆蓋的范圍變小組件數(shù)量暴漲繪制調(diào)用和 LOD 過渡的接縫問題反而更明顯。這是一個(gè)典型的“調(diào)參數(shù)調(diào)不出好結(jié)果”的場(chǎng)景。2.2 網(wǎng)格地形的核心是“地形即資產(chǎn)”Mesh Terrain 的思路是把地形產(chǎn)出為真正的網(wǎng)格數(shù)據(jù)也就是帶頂點(diǎn)、索引、UV、法線的網(wǎng)格資產(chǎn)。它可以來自建模軟件、Houdini、程序化腳本也可以是引擎內(nèi)從高度圖轉(zhuǎn)換生成的。關(guān)鍵在于一旦它是網(wǎng)格它就自動(dòng)繼承了網(wǎng)格生態(tài)里所有已經(jīng)成熟的機(jī)制。比如 Nanite。Nanite 處理的是靜態(tài)網(wǎng)格體的虛擬幾何體它按簇Cluster做 LOD 和剔除能承受極高的三角形數(shù)量。規(guī)則網(wǎng)格地形其實(shí)不太適合 Nanite因?yàn)樗娜切畏植际蔷鶆虻拿芗瘏^(qū)域和空白區(qū)域一樣密。而一張由算法生成、在巖石密集處加密、在平緩草原處稀疏的網(wǎng)格才是 Nanite 真正擅長(zhǎng)的輸入。再比如碰撞。Landscape 的碰撞是從高度圖推導(dǎo)出來的精度受限于高度圖分辨率。網(wǎng)格地形的碰撞可以直接來自渲染網(wǎng)格或者簡(jiǎn)化網(wǎng)格你能明確控制哪一部分參與碰撞、用幾級(jí)簡(jiǎn)化這在做載具、射擊、攀爬的時(shí)候差別很大。2.3 兩種方案的對(duì)比維度Landscape高度圖地形Mesh Terrain網(wǎng)格地形數(shù)據(jù)形態(tài)高度圖 圖層權(quán)重圖頂點(diǎn)、索引、UV、法線組成的網(wǎng)格資產(chǎn)拓?fù)渥杂啥裙潭ㄒ?guī)則網(wǎng)格任意拓?fù)淇砂葱杓用芑蛳∈钁掖?、洞穴不支持需要額外網(wǎng)格補(bǔ)貼原生支持LOD 機(jī)制引擎按組件與分段切換依賴 Nanite 或自定義 LOD 鏈碰撞來源由高度圖推導(dǎo)可指定渲染網(wǎng)格或簡(jiǎn)化網(wǎng)格編輯方式編輯器內(nèi)雕刻筆刷建模工具、DCC 軟件、程序化腳本管線兼容性需要為地形單獨(dú)寫分支與靜態(tài)網(wǎng)格體管線一致大世界支持依賴 World Partition 切分依賴 World Partition 或流式加載這張表要表達(dá)的核心不是“哪個(gè)更好”而是“責(zé)任邊界在哪”。Landscape 把很多決策替你做了省心但也被限制網(wǎng)格地形把決策權(quán)交回來靈活但你要自己承擔(dān)后果。3. 網(wǎng)格地形改變了哪幾層工作流理解一個(gè)技術(shù)最有效的方式往往不是看它的特性列表而是看它把哪些人的工作方式改掉了。網(wǎng)格地形的影響至少分布在三個(gè)層面。3.1 美術(shù)層從“雕刻”轉(zhuǎn)向“生成 修整”傳統(tǒng)地形美術(shù)的工作流是打開地形工具用筆刷一層層雕雕完之后鋪材質(zhì)圖層再手動(dòng)擺放植被和石頭。這個(gè)過程高度依賴個(gè)人手感一個(gè)幾平方公里的場(chǎng)景雕下來周期很長(zhǎng)而且很難復(fù)用。網(wǎng)格地形更常見的工作流是先用 World Machine、Gaea、Houdini 這類工具生成基礎(chǔ)地形網(wǎng)格導(dǎo)入引擎之后再在局部做修整。修整的方式也變了不再是刷高度而是用建模模式或者 Geometry Script 對(duì)網(wǎng)格做局部變形、布爾、重拓?fù)?。這種變化對(duì)美術(shù)的要求其實(shí)更高了因?yàn)槟阋斫饩W(wǎng)格結(jié)構(gòu)和面數(shù)分布但同時(shí)產(chǎn)出效率的上限也高得多。3.2 程序?qū)庸芫€終于可以統(tǒng)一這一層的變化我認(rèn)為是最有價(jià)值的。當(dāng)?shù)匦问蔷W(wǎng)格資產(chǎn)之后你的資產(chǎn)命名規(guī)范、批量處理腳本、打包檢查、LOD 生成策略全都可以和靜態(tài)網(wǎng)格體共用一套。不需要再寫if isinstance(actor, unreal.Landscape)這種分支。舉個(gè)具體例子。項(xiàng)目里通常有一個(gè)自動(dòng)檢查腳本用來確認(rèn)所有進(jìn)入關(guān)卡的資產(chǎn)都開啟了合適的 LOD、碰撞復(fù)雜度設(shè)置正確、材質(zhì)槽沒有空引用。以前這個(gè)腳本要跳過地形 Actor因?yàn)榈匦蔚膶傩越Y(jié)構(gòu)完全不一樣?，F(xiàn)在地形也是網(wǎng)格檢查邏輯可以直接復(fù)用管線的復(fù)雜度是實(shí)打?qū)嵪陆档摹?.3 運(yùn)行時(shí)層優(yōu)化手段變多但也變重Landscape 在運(yùn)行時(shí)的開銷相對(duì)可預(yù)測(cè)繪制調(diào)用數(shù)量由組件數(shù)決定LOD 切換由引擎管理。網(wǎng)格地形則把選擇權(quán)交給你可以用 Nanite 讓它幾乎不產(chǎn)生傳統(tǒng)意義上的繪制調(diào)用也可以用傳統(tǒng) LOD 鏈加剔除距離控制。前者對(duì) GPU 友好后者對(duì)低端設(shè)備更可控。代價(jià)是你需要自己對(duì)三角形預(yù)算負(fù)責(zé)。一張不加控制地生成的 500 萬面地形網(wǎng)格在 Nanite 下也許能跑但在內(nèi)存、流式加載、磁盤體積上都會(huì)留下賬單。這一點(diǎn)在項(xiàng)目早期很容易被忽略等到打包體積失控的時(shí)候才發(fā)現(xiàn)問題。4. 環(huán)境準(zhǔn)備與前置條件這一節(jié)給的是一套通用的準(zhǔn)備清單。具體版本號(hào)請(qǐng)以你項(xiàng)目的實(shí)際引擎版本為準(zhǔn)本文重點(diǎn)演示通用思路不會(huì)寫死一個(gè)版本。4.1 引擎與插件需要確認(rèn)的插件主要有三個(gè)。第一個(gè)是 Geometry Script它提供了在引擎內(nèi)對(duì)網(wǎng)格做程序化操作的節(jié)點(diǎn)和接口是做網(wǎng)格地形的核心依賴。第二個(gè)是 Editor Scripting Utilities它讓 Python 腳本能操作編輯器里的資產(chǎn)和 Actor。第三個(gè)是 Water 或者 Landscape 相關(guān)插件中的一部分如果你需要保留原有的地形生態(tài)比如地形材質(zhì)函數(shù)這些插件仍然要開著。開啟方式在編輯器的 Plugins 面板里搜索名稱勾選即可勾選后需要重啟編輯器。這里有個(gè)常見的小坑Geometry Script 的部分節(jié)點(diǎn)依賴運(yùn)行時(shí)模塊如果只在編輯器里啟用而打包配置里沒同步打包時(shí)會(huì)報(bào)找不到模塊。建議在項(xiàng)目初期就把插件寫進(jìn).uproject文件而不是只手點(diǎn)。4.2 項(xiàng)目設(shè)置網(wǎng)格地形要跑得順有幾項(xiàng)渲染設(shè)置需要提前打開。Nanite 支持、虛擬紋理支持、距離場(chǎng)生成這三項(xiàng)是基礎(chǔ)。距離場(chǎng)尤其容易被忽略很多動(dòng)態(tài)光照和材質(zhì)效果依賴它而網(wǎng)格地形的距離場(chǎng)生成開銷比規(guī)則地形更高需要提前評(píng)估。; 文件路徑Config/DefaultEngine.ini [/Script/Engine.RendererSettings] ; 開啟項(xiàng)目級(jí) Nanite 支持網(wǎng)格地形的主要性能來源 r.Nanite.ProjectEnabledTrue ; 開啟虛擬紋理地形材質(zhì)混合通常依賴它 r.VirtualTexturesTrue ; 生成網(wǎng)格距離場(chǎng)動(dòng)態(tài)光照與部分材質(zhì)效果需要 r.GenerateMeshDistanceFieldsTrue ; 網(wǎng)格地形一般走全動(dòng)態(tài)光照路線關(guān)閉靜態(tài)光照以減少構(gòu)建時(shí)間 r.AllowStaticLightingFalse這段配置寫完之后建議在編輯器里通過 Project Settings 面板核對(duì)一遍確認(rèn)值確實(shí)生效。直接改 ini 有時(shí)會(huì)被編輯器緩存覆蓋尤其是團(tuán)隊(duì)協(xié)作時(shí)別人的本地設(shè)置可能和倉庫里的不一致。4.3 工具鏈準(zhǔn)備外部工具方面你需要一個(gè)能輸出網(wǎng)格格式的地形生成工具常見的選擇是 Houdini、Gaea、World Machine輸出格式一般是 FBX 或者 OBJ。如果你打算走“高度圖轉(zhuǎn)網(wǎng)格”的路線那還需要一個(gè)能讀取 RAW 或者 R16 高度圖的腳本環(huán)境Python 加 numpy 就夠了。引擎?zhèn)冉ㄗh準(zhǔn)備一個(gè)專門放地形資產(chǎn)的目錄比如Content/Terrain/Generated并且把生成產(chǎn)物和手工修整產(chǎn)物分開放。這個(gè)習(xí)慣在后期做增量更新時(shí)價(jià)值極大因?yàn)樯僧a(chǎn)物是可以隨時(shí)刪除重建的手工修整的部分則必須保留。5. 核心流程拆解從高度圖到可運(yùn)行的網(wǎng)格地形這一節(jié)把整個(gè)流程拆成五個(gè)步驟。每一步我都會(huì)說明做什么、為什么這么做、以及做錯(cuò)會(huì)出現(xiàn)什么問題。5.1 第一步確定地形數(shù)據(jù)源先想清楚地形數(shù)據(jù)從哪來。如果項(xiàng)目已經(jīng)有 Landscape 地形那最省事的路徑是把高度圖導(dǎo)出再轉(zhuǎn)成網(wǎng)格如果是全新項(xiàng)目直接用外部工具生成網(wǎng)格更合適。導(dǎo)出高度圖的方式在編輯器里有現(xiàn)成功能Landscape 模式下有導(dǎo)出選項(xiàng)輸出一般是 16 位 RAW 或者 PNG。這里要注意兩點(diǎn)一是導(dǎo)出時(shí)要記下地形的大小和縮放參數(shù)否則轉(zhuǎn)成網(wǎng)格后尺寸對(duì)不上二是 16 位精度必須保留轉(zhuǎn)成 8 位會(huì)導(dǎo)致臺(tái)階狀的高度斷層這個(gè)錯(cuò)誤在視覺上非常明顯但在數(shù)據(jù)層面很難排查。5.2 第二步生成網(wǎng)格數(shù)據(jù)這一步是整條鏈路的核心。規(guī)則網(wǎng)格的生成邏輯其實(shí)不復(fù)雜把高度圖的每個(gè)像素當(dāng)成一個(gè)頂點(diǎn)X、Z 坐標(biāo)由像素索引換算Y 坐標(biāo)取像素值歸一化后乘以高度縮放然后把相鄰頂點(diǎn)連成三角形。真正需要?jiǎng)幽X的是密度分配。如果完全按像素一一對(duì)應(yīng)一張 4096×4096 的高度圖會(huì)產(chǎn)生約 3300 萬個(gè)三角形這個(gè)量級(jí)在大多數(shù)項(xiàng)目里都不合理。合理的做法是分級(jí)處理遠(yuǎn)景區(qū)用低密度采樣近景區(qū)用高密度或者干脆按高度變化率做自適應(yīng)細(xì)分——平坦區(qū)域減少三角形陡峭區(qū)域保留密度。5.3 第三步導(dǎo)入與資產(chǎn)化網(wǎng)格生成出來之后導(dǎo)入引擎成為靜態(tài)網(wǎng)格體資產(chǎn)。導(dǎo)入時(shí)要注意幾個(gè)設(shè)置法線導(dǎo)入方式選“導(dǎo)入法線”而不是“計(jì)算法線”因?yàn)橥獠抗ぞ咚愠鰜淼姆ň€通常更符合預(yù)期碰撞復(fù)雜度根據(jù)用途選擇地形一般用“將復(fù)雜碰撞用作簡(jiǎn)單碰撞”配合簡(jiǎn)化生成光照 UV 這一項(xiàng)如果項(xiàng)目用全動(dòng)態(tài)光照可以關(guān)掉能省不少導(dǎo)入時(shí)間。導(dǎo)入完成之后建議立刻給資產(chǎn)打上標(biāo)簽或者在命名里體現(xiàn) LOD 層級(jí)和區(qū)塊編號(hào)。網(wǎng)格地形在大世界場(chǎng)景里通常會(huì)被切成多個(gè)區(qū)塊流式加載命名混亂會(huì)讓后面的調(diào)試非常痛苦。5.4 第四步材質(zhì)與著色網(wǎng)格地形的材質(zhì)邏輯和 Landscape 有本質(zhì)區(qū)別。Landscape 靠圖層權(quán)重混合網(wǎng)格地形靠頂點(diǎn)屬性或者世界坐標(biāo)投影。最常見的做法是頂點(diǎn)色存儲(chǔ)材質(zhì)權(quán)重材質(zhì)里讀取頂點(diǎn)色做混合另一種做法是三平面投影Triplanar Mapping按世界坐標(biāo)在三個(gè)方向上采樣紋理再按法線權(quán)重混合。三平面投影的好處是不需要 UV對(duì)任意拓?fù)涠加行奶幨遣蓸哟螖?shù)翻三倍性能開銷明顯。實(shí)踐中通常會(huì)混合使用主要表面用 UV 采樣陡峭的巖石面用三平面補(bǔ)充。這個(gè)取舍需要根據(jù)目標(biāo)平臺(tái)來定。5.5 第五步碰撞、LOD 與流式加載最后一步是把地形接入運(yùn)行時(shí)。碰撞方面如果地形只做視覺背景用簡(jiǎn)化碰撞甚至不生成碰撞都可以如果玩家要在上面跑動(dòng)、射擊、駕駛就需要認(rèn)真處理碰撞精度。Nanite 網(wǎng)格本身不直接提供物理碰撞碰撞來自單獨(dú)的碰撞網(wǎng)格這一點(diǎn)必須明確。LOD 方面走 Nanite 路線的話基本不需要手工 LOD但要注意 Nanite 對(duì)材質(zhì)和頂點(diǎn)屬性的限制走傳統(tǒng) LOD 路線則需要用引擎的 LOD 生成工具或者外部工具預(yù)生成幾級(jí)簡(jiǎn)化網(wǎng)格。流式加載方面大世界地形通常要配合 World Partition把地形切成 Cell注意 Cell 邊界處的頂點(diǎn)要保證連續(xù)否則會(huì)出現(xiàn)可見的裂縫。6. 完整示例與代碼實(shí)現(xiàn)下面給四個(gè)可以直接用的示例。第一個(gè)是純 Python 的高度圖轉(zhuǎn) OBJ 腳本它把“網(wǎng)格地形怎么被造出來”這件事講透第二個(gè)是引擎內(nèi)的 Python 腳本用來批量檢查關(guān)卡里的地形資產(chǎn)第三個(gè)是材質(zhì)里的三平面采樣 HLSL 片段第四個(gè)是驗(yàn)證用的控制臺(tái)命令。6.1 高度圖轉(zhuǎn) OBJ 網(wǎng)格的完整腳本這個(gè)腳本不依賴引擎只要有 Python 和 numpy 就能跑。輸入是一張 16 位 RAW 高度圖輸出是 OBJ 格式的網(wǎng)格文件。# 文件路徑tools/heightmap_to_obj.py # 用途將 16 位 RAW 高度圖轉(zhuǎn)換為 OBJ 網(wǎng)格用于導(dǎo)入虛幻引擎作為網(wǎng)格地形 import sys import numpy as np def read_raw_heightmap(path: str, size: int) - np.ndarray: 讀取 16 位無符號(hào) RAW 高度圖返回 shape 為 (size, size) 的浮點(diǎn)數(shù)組。 data np.fromfile(path, dtypeu2) expected size * size if data.size ! expected: raise ValueError( f高度圖數(shù)據(jù)量不匹配期望 {expected} 個(gè)像素實(shí)際 {data.size} 個(gè)。 f請(qǐng)檢查 --size 參數(shù)是否與導(dǎo)出時(shí)的地形分辨率一致。 ) # 歸一化到 0.0 - 1.0 區(qū)間 return data.reshape(size, size).astype(np.float64) / 65535.0 def decimate_grid(size: int, step: int) - np.ndarray: 按步長(zhǎng)降采樣控制三角形總量。step1 表示不做降采樣。 if step 1: raise ValueError(step 必須大于等于 1) idx np.arange(0, size, step) # 保證最后一行一列一定被采樣到避免地形邊緣被裁掉 if idx[-1] ! size - 1: idx np.append(idx, size - 1) return idx def build_obj(heights: np.ndarray, indices: np.ndarray, horizontal_scale: float, vertical_scale: float, obj_path: str) - int: 把高度數(shù)組寫成 OBJ 文件返回生成的三角形數(shù)量。 n len(indices) vertices [] for row in indices: for col in indices: x col * horizontal_scale y heights[row, col] * vertical_scale z row * horizontal_scale vertices.append((x, y, z)) triangles 0 with open(obj_path, w, encodingutf-8) as f: f.write(# generated by heightmap_to_obj.py\n) for v in vertices: f.write(fv {v[0]:.6f} {v[1]:.6f} {v[2]:.6f}\n) for r in range(n - 1): for c in range(n - 1): a r * n c 1 # OBJ 頂點(diǎn)索引從 1 開始 b r * n (c 1) 1 d (r 1) * n c 1 e (r 1) * n (c 1) 1 # 逆時(shí)針繞序保證法線朝上 f.write(ff {a} 5glq3a94y \n) f.write(ff  5glq3a94y {e}\n) triangles 2 return triangles def main() - None: if len(sys.argv) 5: print(用法: python heightmap_to_obj.py raw文件 分辨率 水平縮放 垂直縮放 [降采樣步長(zhǎng)]) sys.exit(1) raw_path sys.argv[1] size int(sys.argv[2]) h_scale float(sys.argv[3]) v_scale float(sys.argv[4]) step int(sys.argv[5]) if len(sys.argv) 5 else 1 heights read_raw_heightmap(raw_path, size) indices decimate_grid(size, step) obj_path raw_path.rsplit(., 1)[0] .obj tris build_obj(heights, indices, h_scale, v_scale, obj_path) print(f高度圖分辨率: {size} x {size}) print(f采樣頂點(diǎn)數(shù): {len(indices)} x {len(indices)}) print(f生成三角形: {tris}) print(f輸出文件: {obj_path}) if __name__ __main__: main()這段代碼的關(guān)鍵邏輯有三塊。第一塊是精度處理用u2明確指定小端 16 位無符號(hào)整數(shù)這是虛幻引擎導(dǎo)出 RAW 時(shí)的默認(rèn)格式如果讀成 8 位高度會(huì)直接斷裂成臺(tái)階。第二塊是降采樣decimate_grid保證最后一行一列一定被采樣這是個(gè)不起眼但很容易漏的細(xì)節(jié)漏掉的后果是地形邊緣缺一條導(dǎo)入之后會(huì)和相鄰區(qū)塊拼不上。第三塊是繞序f a d b和f b d e是逆時(shí)針如果寫反了導(dǎo)入引擎后地形會(huì)整體黑掉或者法線朝下。運(yùn)行方式python tools/heightmap_to_obj.py ./Heightmap.raw 4096 100.0 4000.0 4參數(shù)含義依次是 RAW 文件路徑、高度圖分辨率、水平縮放每個(gè)像素代表的厘米數(shù)、垂直縮放高度最大值對(duì)應(yīng)的厘米數(shù)、降采樣步長(zhǎng)。步長(zhǎng) 4 意味著 4096 的圖會(huì)變成約 1024 的網(wǎng)格三角形數(shù)量從約 3300 萬降到約 200 萬。6.2 在引擎內(nèi)批量審查地形資產(chǎn)生成完網(wǎng)格導(dǎo)入引擎之后通常需要檢查一批資產(chǎn)的狀態(tài)。這個(gè)腳本遍歷當(dāng)前關(guān)卡的所有 Actor篩選出地形相關(guān)對(duì)象并輸出關(guān)鍵信息。# 文件路徑Content/Python/terrain_audit.py # 用途在虛幻編輯器內(nèi)運(yùn)行審查關(guān)卡中的地形相關(guān) Actor import unreal def audit_level_terrain(): actor_subsystem unreal.get_editor_subsystem(unreal.EditorActorSubsystem) all_actors actor_subsystem.get_all_level_actors() landscape_count 0 mesh_count 0 total_triangles 0 for actor in all_actors: label actor.get_actor_label() # 統(tǒng)計(jì)傳統(tǒng) Landscape if isinstance(actor, unreal.Landscape): landscape_count 1 unreal.log(f[Landscape] {label}) # 統(tǒng)計(jì)靜態(tài)網(wǎng)格體按標(biāo)簽粗略篩出地形網(wǎng)格 elif isinstance(actor, unreal.StaticMeshActor): if Terrain not in label and Terrain not in actor.get_name(): continue mesh_count 1 comp actor.static_mesh_component mesh comp.static_mesh if comp else None if mesh is None: unreal.log_warning(f[Mesh] {label} 的網(wǎng)格資產(chǎn)為空請(qǐng)檢查引用) continue # 三角形數(shù)量用于估算幾何預(yù)算 tris 0 try: tris mesh.get_num_triangles(0) except Exception as err: unreal.log_warning(f[Mesh] {label} 讀取三角形數(shù)失敗: {err}) total_triangles tris # Nanite 設(shè)置隨引擎版本可能變化做屬性存在性保護(hù) nanite_on 未知 try: settings mesh.get_editor_property(nanite_settings) nanite_on settings.get_editor_property(enabled) except Exception: nanite_on 當(dāng)前版本無此屬性 unreal.log(f[Mesh] {label} 三角形{tris} Nanite{nanite_on}) unreal.log( * 50) unreal.log(fLandscape 數(shù)量: {landscape_count}) unreal.log(f地形網(wǎng)格數(shù)量: {mesh_count}) unreal.log(f地形網(wǎng)格三角形合計(jì): {total_triangles}) if __name__ __main__: audit_level_terrain()腳本里做了兩處防御性處理值得說明。get_num_triangles在某些網(wǎng)格資產(chǎn)上會(huì)拋異常比如資產(chǎn)被重新導(dǎo)入但引用還沒刷新的時(shí)候所以包在 try 里。nanite_settings這個(gè)屬性名在不同引擎版本之間有變化用 try 包住并在失敗時(shí)給出提示比直接崩掉要好。這種寫法在寫編輯器工具時(shí)是必須的因?yàn)楣ぞ叩氖褂谜呖赡芊植荚诓煌娣种稀Ｔ诰庉嬈骼锎蜷_ Output Log 窗口切到 Python 模式或者通過 File 菜單的 Execute Python Script 執(zhí)行都能運(yùn)行。建議先在一張小地圖上驗(yàn)證邏輯再拿到大世界上跑。6.3 三平面采樣的材質(zhì)片段網(wǎng)格地形沒有天然 UV 適配材質(zhì)里通常需要一段三平面采樣邏輯。下面是在材質(zhì) Custom 節(jié)點(diǎn)里可以用的 HLSL 片段。// 文件路徑Shaders/TriplanarSample.hlsl // 說明在虛幻材質(zhì)編輯器的 Custom 節(jié)點(diǎn)中使用 // 輸入WorldPos (float3)、WorldNormal (float3)、TileSize (float) // 輸出混合后的顏色 float3 blend abs(WorldNormal); blend blend / (blend.x blend.y blend.z 1e-5); float3 projX Tex.SampleLevel(TexSampler, WorldPos.yz / TileSize, 0).rgb; float3 projY Tex.SampleLevel(TexSampler, WorldPos.xz / TileSize, 0).rgb; float3 projZ Tex.SampleLevel(TexSampler, WorldPos.xy / TileSize, 0).rgb; float3 result projX * blend.x projY * blend.y projZ * blend.z; return result;這里的分母加了1e-5是為了防止在極端情況下三個(gè)法線分量之和為零導(dǎo)致除零雖然實(shí)際幾乎不會(huì)出現(xiàn)但材質(zhì)里出現(xiàn) NaN 之后排查成本很高加上更保險(xiǎn)。另外注意用了SampleLevel而不是Sample因?yàn)?Custom 節(jié)點(diǎn)內(nèi)不能依賴自動(dòng)微分顯式指定 Mip 級(jí)別可以避免編譯報(bào)錯(cuò)。這段代碼每次調(diào)用會(huì)采樣三次如果材質(zhì)里還要混多個(gè)圖層采樣次數(shù)會(huì)迅速堆上去。實(shí)踐中的做法是只在巖石、懸崖這類需要三平面的區(qū)域啟用平緩草地仍然用 UV 采樣用頂點(diǎn)色或者遮罩做切換。6.4 驗(yàn)證用的控制臺(tái)命令跑起來之后需要確認(rèn)渲染路徑是否符合預(yù)期。在編輯器或者打包后的控制臺(tái)里執(zhí)行下面幾條命令。# 查看幀時(shí)間和瓶頸歸屬確認(rèn)是 GPU 還是 CPU 受限 stat unit # 查看 Nanite 相關(guān)的渲染統(tǒng)計(jì) stat nanite # 顯示虛擬紋理的邊界顏色用來檢查地形材質(zhì)的 VT 分布是否合理 r.VT.Borders 1 # 關(guān)閉地形顯示用于對(duì)比地形對(duì)整體開銷的貢獻(xiàn) show Landscaper.VT.Borders這條命令在調(diào)試地形材質(zhì)時(shí)特別有用。它會(huì)用不同顏色標(biāo)出虛擬紋理的各個(gè) Mip 層級(jí)如果地形上大片區(qū)域顯示為最低層級(jí)的顏色說明虛擬紋理的預(yù)算不夠材質(zhì)在低分辨率下被采樣視覺上會(huì)糊。這個(gè)問題在網(wǎng)格地形上比在 Landscape 上更容易出現(xiàn)因?yàn)榫W(wǎng)格的 UV 分布往往不如規(guī)則地形均勻。7. 運(yùn)行結(jié)果與效果驗(yàn)證代碼跑完之后怎么判斷是否成功分三個(gè)層次看。第一個(gè)層次是數(shù)據(jù)層。高度圖轉(zhuǎn) OBJ 的腳本執(zhí)行后控制臺(tái)會(huì)打印分辨率、采樣頂點(diǎn)數(shù)、三角形數(shù)量和輸出路徑。這里要重點(diǎn)核對(duì)三角形數(shù)量是否在預(yù)期范圍內(nèi)。一個(gè)粗略的參考是單塊地形網(wǎng)格控制在 100 萬到 300 萬三角形之間比較穩(wěn)妥超過這個(gè)量級(jí)就要考慮繼續(xù)降采樣或者切塊。如果打印出來的三角形數(shù)是零多半是降采樣步長(zhǎng)設(shè)得比分辨率還大導(dǎo)致只剩一行一列。第二個(gè)層次是引擎內(nèi)導(dǎo)入層。OBJ 導(dǎo)入成靜態(tài)網(wǎng)格體之后在內(nèi)容瀏覽器里選中資產(chǎn)查看細(xì)節(jié)面板的三角形數(shù)量和包圍盒尺寸。尺寸要和預(yù)期的世界尺寸對(duì)得上比如預(yù)期是 4 公里見方包圍盒的 X 和 Y 就應(yīng)該接近 400000 單位厘米。如果對(duì)不上回去檢查水平縮放參數(shù)。這個(gè)環(huán)節(jié)最常見的錯(cuò)誤是水平縮放和垂直縮放的比例搞反導(dǎo)致地形看起來像被壓扁或者拉長(zhǎng)。第三個(gè)層次是運(yùn)行時(shí)表現(xiàn)。把網(wǎng)格地形拖進(jìn)關(guān)卡站到近處和遠(yuǎn)處各看一次。近處主要看有沒有明顯的三角面片感和紋理拉伸遠(yuǎn)處主要看有沒有閃爍和 LOD 跳變。再用stat unit看幀時(shí)間用stat nanite確認(rèn) Nanite 確實(shí)在生效。如果stat nanite里顯示的三角形數(shù)量為零說明 Nanite 沒有啟用或者網(wǎng)格的材質(zhì)用了 Nanite 不支持的節(jié)點(diǎn)。如果失敗第一步應(yīng)該看哪里我的建議是先看導(dǎo)入日志而不是渲染結(jié)果。導(dǎo)入階段的錯(cuò)誤信息通常很明確比如“網(wǎng)格包含退化三角形”“UV 通道缺失”這些問題在渲染階段表現(xiàn)為莫名其妙的黑面或者閃爍很難反推。在 Output Log 里按 Warning 過濾先把導(dǎo)入警告清干凈再去看渲染問題能省掉大量猜測(cè)。8. 常見問題與排查思路問題現(xiàn)象可能原因排查方式解決方案導(dǎo)入后地形整體發(fā)黑三角形繞序反了法線朝下在建模模式里查看法線方向修改生成腳本的面索引順序或在引擎內(nèi)翻轉(zhuǎn)法線地形高度出現(xiàn)明顯臺(tái)階高度圖按 8 位讀取精度丟失檢查讀取時(shí)的 dtype 是否為 16 位改用u2讀取確認(rèn)源文件是 16 位導(dǎo)出相鄰地形區(qū)塊之間有裂縫區(qū)塊邊界頂點(diǎn)位置不連續(xù)或降采樣裁掉了邊緣放大到接縫處觀察頂點(diǎn)位置保證降采樣時(shí)保留首尾索引區(qū)塊間共享邊界頂點(diǎn)地形材質(zhì)在遠(yuǎn)處糊成一片虛擬紋理預(yù)算不足Mip 層級(jí)被壓低用r.VT.Borders 1查看層級(jí)分布提高 VT 預(yù)算或降低地形材質(zhì)的采樣層級(jí)需求stat nanite中三角形數(shù)為零Nanite 未啟用或材質(zhì)含不支持的節(jié)點(diǎn)檢查項(xiàng)目設(shè)置和網(wǎng)格資產(chǎn)的 Nanite 開關(guān)打開項(xiàng)目級(jí) Nanite替換不兼容的材質(zhì)節(jié)點(diǎn)幀率在進(jìn)入地形區(qū)域后驟降三角形總量超預(yù)算或碰撞網(wǎng)格過于精細(xì)用stat unit和stat gpu定位瓶頸降低網(wǎng)格密度為碰撞單獨(dú)生成簡(jiǎn)化網(wǎng)格打包后地形丟失資產(chǎn)未被正確引用或流式加載配置缺失檢查打包日志中的資產(chǎn)引用警告在關(guān)卡中顯式引用或修正 World Partition 的 Cell 配置編輯器內(nèi)正常打包后材質(zhì)異常材質(zhì)使用了僅編輯器可用的節(jié)點(diǎn)對(duì)比編輯器與打包后的材質(zhì)編譯日志替換為運(yùn)行時(shí)可用的節(jié)點(diǎn)或改為烘焙貼圖表格里最值得單獨(dú)說一句的是“區(qū)塊裂縫”。這個(gè)問題在網(wǎng)格地形上比在 Landscape 上出現(xiàn)頻率高得多因?yàn)?Landscape 的組件邊界由引擎保證連續(xù)而網(wǎng)格地形的邊界完全取決于你的生成邏輯。一個(gè)穩(wěn)妥的做法是生成時(shí)讓相鄰區(qū)塊共用同一批邊界頂點(diǎn)坐標(biāo)不要各自獨(dú)立計(jì)算浮點(diǎn)誤差累積到一定規(guī)模就會(huì)變成肉眼可見的縫。9. 最佳實(shí)踐、工程建議與后續(xù)方向把上面這些串起來幾條經(jīng)驗(yàn)值得在項(xiàng)目里落地。第一資產(chǎn)分層要嚴(yán)格。生成產(chǎn)物、修整產(chǎn)物、碰撞產(chǎn)物分開放在不同目錄命名里帶上區(qū)塊編號(hào)和 LOD 層級(jí)。生成產(chǎn)物隨時(shí)可刪可重建修整產(chǎn)物必須納入版本管理并且定期備份。這個(gè)習(xí)慣在項(xiàng)目做到中期、地形反復(fù)迭代的時(shí)候價(jià)值會(huì)非常明顯。第二三角形預(yù)算要前置。在開始做地形之前就定一個(gè)上限比如“單屏可見地形不超過 400 萬三角形”然后在生成腳本里把這個(gè)約束寫死。等到美術(shù)已經(jīng)把植被、建筑都擺上去之后再回頭削減地形密度返工成本會(huì)高得多。第三碰撞單獨(dú)處理。不要把渲染網(wǎng)格直接當(dāng)碰撞網(wǎng)格用除非地形非常簡(jiǎn)單。合理的做法是生成一份低精度的碰撞網(wǎng)格只保留大尺度起伏細(xì)節(jié)部分交給物理材質(zhì)和角色移動(dòng)組件去處理。視覺精度和物理精度本來就是兩件事混在一起做往往兩頭不討好。第四材質(zhì)走分層策略。核心區(qū)域用高質(zhì)量采樣遠(yuǎn)景用低成本方案中間用頂點(diǎn)色或者遮罩切換。三平面投影不要全場(chǎng)景鋪開它是解決特定問題的工具不是通用方案。第五把審查腳本納入日常流程。上面那個(gè) Python 審查腳本可以直接掛到提交前檢查或者每日構(gòu)建里輸出地形資產(chǎn)的數(shù)量、三角形總量、Nanite 開關(guān)狀態(tài)。地形這類資產(chǎn)的問題往往不是一次性的而是隨著迭代慢慢累積有自動(dòng)化檢查兜底會(huì)踏實(shí)很多。至于后續(xù)深入的方向我建議按這個(gè)順序先把高度圖轉(zhuǎn)網(wǎng)格這條鏈路跑通理解頂點(diǎn)、索引、繞序這些基礎(chǔ)概念的實(shí)際影響然后嘗試接入外部工具生成的非規(guī)則網(wǎng)格體會(huì)密度分配對(duì)性能的實(shí)際作用最后再研究 Nanite 和虛擬紋理在地形場(chǎng)景下的具體調(diào)優(yōu)參數(shù)。跳步的代價(jià)是遇到問題時(shí)缺少判斷依據(jù)只能靠猜。需要提醒的是網(wǎng)格地形不是萬能的。如果項(xiàng)目的地形尺度不大、風(fēng)格偏卡通、或者團(tuán)隊(duì)里沒有人熟悉網(wǎng)格管線繼續(xù)用 Landscape 反而是更穩(wěn)的選擇。技術(shù)選型的關(guān)鍵從來不是哪個(gè)更先進(jìn)而是哪個(gè)和你的團(tuán)隊(duì)能力、項(xiàng)目周期、目標(biāo)平臺(tái)更匹配。把這篇文章里的腳本拿去跑一遍看看產(chǎn)出結(jié)果和你預(yù)期差多少這個(gè)差距就是你需要補(bǔ)的部分。