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