TerrainForge Wiki

Overview · English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano · Website

TerrainForge 0.3.8 — 0.3.7 修正版本

Q 圓盤新增專用「複製/貼上」模式。矩形用「套用」標記 A/B；直線標記兩端；多邊形標記頂點並在 3 點以上雙擊複製；圓形/正方形複製筆刷範圍。HUD 會提示下一步。雪已整合至塗裝 > DeepSnow（按住 Shift 可移除）。F5 會鎖定本機移動與鏡頭；Esc 會暫停單人世界。 0.3.6：F5 分頁改為兩列，並依目前操作顯示對應設定。Ramp 提供兩點、固定角度與連續路徑模式；圓形坡道列入 0.4.0 計畫。

📥 安裝

需求

BepInEx 5（x64、Mono）安裝於客戶端與伺服器。Thunderstore 使用者已內建。

步驟

從 Thunderstore 或 GitHub Releases 下載 TerrainForge-<version>.zip。
解壓縮並將 TerrainForge.dll 放到： - 客戶端： ...\BepInEx\plugins\TerrainForge\TerrainForge.dll - 伺服器： <server>\BepInEx\plugins\TerrainForge\TerrainForge.dll
重新啟動遊戲 / 伺服器。

⚠️ 必須同時安裝於客戶端與伺服器，才能進行大於 ±8 m 的編輯並正確同步。

🚀 快速開始

加入一個世界。TerrainForge 法杖（鐵鎚的複製品）會自動給予並裝備。
按 F5 開啟選單（或點擊 ESC 暫停選單中的 TerrainForge 按鈕）。
若法杖尚未裝備，請裝備它。
瞄準地形並按住右鍵（Mouse1）進行雕塑。
使用 , 循環操作，. 切換形狀，/ 切換塗裝。
按住 Q → 環形選單，放開即確認。
Ctrl+Z / Ctrl+Y 復原/重做。

⌨️ 控制

動作	預設按鍵	說明
套用筆刷	按住 `Mouse1`（右鍵）	在準心下方雕塑地形
半徑 +	`=` 或 `Ctrl`+滾輪	增加筆刷半徑
半徑 −	`-` 或 `Ctrl`+滾輪	減少筆刷半徑
循環操作	`,`	循環 9 種操作
循環形狀	`.`	圓形 → 方形 → 線 → 矩形 → 多邊形
循環塗裝	`/`	循環 6 種塗裝類型
整平至腳下	按住 `Left Shift`	整平使用玩家高度
復原	`Ctrl+Z`	復原上一個筆觸
重做	`Ctrl+Y`	重做已復原的筆觸
取色器	`G`	將整平高度固定在準心處（再按一次 = 解除）
斜坡模式	`H`	循環：兩點 → 固定角度 → 路徑（或在設定中以 3 個按鈕選取）
固定斜坡角度	按住 `Alt` + 半徑/滾輪	在固定模式中調整角度
環形選單	按住 `Q`	以滑鼠選取操作，放開即確認
調整模式	`V`	滾輪 = 半徑，凍結縮放/快捷列/地圖
微調（0.1 m）	按住 `Shift` + 滾輪/半徑	精確調整半徑
複製印記	`Ctrl+Shift+C`	將標記區域複製到剪貼簿
貼上印記	`Ctrl+Shift+V`	幽靈預覽，點擊即確認
取得法杖	`F8`	給予 TerrainForge 法杖
開啟選單	`F5`	開啟按鍵/說明/設定選單

額外按鍵（無預設，於按鍵中指定）： - 直接操作：整平、升高、降低、平滑、塗裝、還原、斜坡、海岸、雪地 - 下一個 / 上一個設定檔 - 下一個 / 上一個印記（歷史）

「快速動作」區段（按鍵分頁）： 用於沒有強制快捷鍵的功能按鈕 — 復原、重做、固定高度、複製/貼上印記、上一個印記、清除標記、熱圖以及材質診斷（將 shader + 材質插槽傾印至日誌）。

🔄 操作

操作	說明
整平	整平至瞄準的高度（Shift = 在腳下）。透過取色器（`G`）或設定的文字方塊固定高度。
升高	每次套用將地形升高 `RaiseDelta`。由衰減模式塑形。
降低	每次套用將地形降低 `RaiseDelta`。由衰減模式塑形。
平滑	真正的模糊：將每個頂點與其 8 個鄰點平均。按住可漸進。模式：完整（兩者）、僅山脊（降低）、僅凹陷（升高）。線形狀 = 平滑一條路徑。
斜坡	3 種模式（循環 `H`）： • 兩點：標記 A 與 B → 一條直線斜坡連結兩處高度。 • 固定角度：B = 方向/長度；高度 = `SlopeAngle`（依準心上升/下降）。以 `Alt`+半徑調整。 • 路徑：標記一條曲線 A→B→C…（3 點以上時雙擊收尾）→ 平滑 Catmull-Rom。寬度 = 筆刷半徑。柔和度 = 僅在側邊邊緣混合。預覽：填充的走廊 + A/B 處的高度環。
海岸	整平至水位 + `ShoreOffset` 邊距（海灘）。柔和度如同整平。
塗裝	類型：Dirt、Cultivated、Paved、ClearVegetation、DeepSnow、Reset。可調整強度。
還原	將地形回復至原始狀態（高度 + 塗裝）。
複製/貼上	Q 圓盤中的專用模式，可選取地形並放置 stamp。

📐 形狀

以 . 鍵循環。全部支援復原。

形狀	標記	用途
圓形	單擊（筆刷中心）	一般雕塑
方形	單擊（中心）	平台、地基
線	2 次點擊（A → B）	路徑、牆、步道。半寬 = 半徑。
矩形	2 次點擊（對角）	地基、農場、平台。柔和邊緣。
多邊形	每個頂點點擊，雙擊收尾（3 個以上頂點）	複雜形狀、自訂區域

非圓形僅顯示 標記的輪廓（無圓環）。
柔和度影響所有形狀的邊緣混合。

⚙️ 衰減模式（升高/降低）

於設定 → 「升高/降低衰減」中配置：

模式	行為
尖銳	中央峰值。由「衰減強度」滑桿（1–5）控制。
平坦	均勻圓盤 — 整個半徑權重相同。
柔和	餘弦鐘形 — 平滑過渡，無硬邊。
線性	從中心到邊緣直線遞減。

🧱 印記（複製/貼上）

用於複製地形結構的強大功能。

矩形選取（推薦）

在 Q 圓盤選擇「複製/貼上」。按「套用」標記範圍：矩形選兩個角、直線選兩端、多邊形選頂點（3 點以上雙擊），圓形/正方形則使用目前筆刷範圍。HUD 會提示下一步。

工作流程

標記區域：使用任意形狀（圓形、矩形、線、多邊形、斜坡）— 或上述的矩形選取。
複製：Ctrl+Shift+C → 「Stamp copied: X tiles」（RAM 剪貼簿）。
貼上預覽：Ctrl+Shift+V → 準心處的幽靈線框。 - Q/E = 旋轉 ±15° - Alt+滾輪 = 連續旋轉 - Shift+滾輪 = 縮放 0.25×–4× - Esc = 取消
Confirm: 再次按下貼上快捷鍵以確認預覽。

選取印記僅寫入複製區域內；其外的地形保持不變。

歷史

RAM 中最多 10 個印記（最新在前）。
下一個印記 / 上一個印記 按鍵（可重新綁定）可循環。
提示：「Stamp history: Copy: 3 tiles [2/5]」

持久化

設定 → 印記：
將目前印記儲存至磁碟（.stamp 位於 BepInEx/config/TerrainForge/stamps/，最多 12 個）。
載入印記至剪貼簿。
列出/刪除已儲存的印記。

印記工具

設定 → 「印記工具」（4 個選項）：
與筆刷相同（預設）— 使用與筆刷相同的工具
任意 — 無要求
鎬 — 需要裝備鎬
TerrainForge 法杖 — 需要模組的法杖
當工具已裝備 + 剪貼簿中有印記時，HUD 會顯示 STAMP READY [2/5]。
若無工具：Stamp: tool not equipped，複製/貼上被封鎖。

💾 快照（備份）

完整的地形備份/還原。

儲存

設定 → 快照。
名稱（留空 = 自動日期/時間）。
儲存 → 已編輯的 tiles 至 BepInEx/config/TerrainForge/snapshots/<name>.dat（最多 12 個）。

載入

選擇一個快照。
載入 → 還原 tiles 及其歸屬，1 步復原。
未載入的 tiles 會乾淨地警告 — 請在原始位置附近匯入。

功能

版本化二進位格式（.dat）。
還原高度 + 平滑 + 塗裝 + 歸屬。
匯入可復原（Ctrl+Z 還原匯入）。
未載入的 tiles 會乾淨地警告。

💾 設定檔

儲存/載入完整的筆刷配置。

設定 → 設定檔。
名稱 + 儲存 → 半徑、柔和度、操作、形狀、塗裝、斜坡模式、角度、平滑模式、升高增量、塗裝強度、衰減、海岸偏移。
載入 → 立即套用。
最多 12 個設定檔（culture-invariant 格式，位於 Presets > Slots）。
按鍵綁定：Next Profile（於按鍵中指定）以循環。

🌐 語言

15 個選項： Auto、English、Español、Français、Deutsch、Русский、中文、繁體中文、日本語、한국어、Polski、Português、Türkçe、Українська、Italiano — 預設 Auto。

自動偵測

預設的 Auto 透過反射偵測遊戲語言：Localization.instance.GetSelectedLanguage()。
將 Valheim 語言 → 內部索引對應。
若某語言沒有完整翻譯 → 退回 English。
可於設定 → 「語言」中配置（循環 15 個選項）。
開啟選單時會重建按鍵標籤。

翻譯狀態

完整： English、Español
退回 English： Français、Deutsch、Русский、中文、繁體中文、日本語、한국어、Polski、Português、Türkçe、Українська、Italiano
歡迎透過 PR 提供社群翻譯。

本文件

已翻譯的 wiki 頁面：English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano。

🌍 多人遊戲

需求

客戶端與伺服器皆需安裝模組，以進行大於 ±8 m 的編輯並正確同步。
伺服器也需 UnlockDeltaLimit，否則伺服器會夾限地形。

伺服器權威（設定同步）

當伺服器執行此模組時，其 Server 區段優先： - AllowTerrainEdits（預設 true）— 主開關；若為 false，客戶端無法套用/復原/重做。 - AdminOnlyEdits（預設 false）— 僅管理員/主機能編輯。 - RespectWards（預設 true）— 封鎖他人結界內的編輯。 - RadiusCap / DeltaCap（0 = 關閉）— 伺服器強制的上限，顯示於 HUD+預覽中。

未安裝模組的伺服器會忽略該區段 → 客戶端可用於測試。

防止不同步

在伺服器 + 客戶端保持 MaxUpDelta / MaxDownDelta 一致。
較大的半徑可能使未安裝模組的客戶端不同步。

⚙️ 設定

檔案：BepInEx/config/com.terrainforge.valheim.cfg

一般

設定	預設	說明
`Enabled`	`true`	主開關
`PlayEffects`	`true`	套用時的塵土 + 打擊效果
`Language`	`Auto`	Auto / English / Español / Français / Deutsch / Русский / 中文 / 繁體中文 / 日本語 / 한국어 / Polski / Português / Türkçe / Українська / Italiano
`ToolTint`	`true`	為 TerrainForge 法杖（鐵鎚的複製品）著色，以便與原版鐵鎚輕鬆分辨
`ToolTintColor`	`#4FC3F7`	法杖的十六進位顏色（模型 + 圖示）。例如 `#FFC400` 金色、`#8BC34A` 綠色

筆刷

設定	預設	範圍	說明
`Radius`	8	1–100	筆刷半徑（m）
`RadiusMin`	2	—	調整時的最小半徑
`RadiusMax`	60	—	調整時的最大半徑
`RadiusStep`	1	—	每次按鍵/滾輪的半徑變化
`Softness`	50	0–100	邊緣柔和度（0 = 硬，100 = 非常柔）
`FalloffPower`	3	1–5	衰減指數（僅尖銳模式）
`RaiseLowerMeters`	2	0.5–10	每次升高/降低套用的公尺數
`PaintStrength`	1	0–1	塗裝強度
`DefaultOperation`	Flatten	—	起始操作
`Shape`	Circle	—	起始形狀
`Paint`	Dirt	—	起始塗裝
`RampMode`	TwoPoint	—	TwoPoint / FixedAngle / Path
`SlopeAngle`	30	5–60	固定斜坡角度（度）
`SmoothMode`	Full	—	Full / Bumps / Dips
`FalloffMode`	Pointy	—	Pointy / Flat / Smooth / Linear
`ShoreOffset`	0.5	-2–5	水面上方的海岸邊距（m）
`UseFixedHeight`	false	—	使用固定高度（取色器狀態）
`FixedHeight`	30	-10–150	精確的整平高度（m）

原版 / 整合

BlockVanillaTerrainTools：false — 裝備法杖時，忽略原版鋤頭/耕耘機的地形編輯。設定中也有切換開關。

輸入

所有快捷鍵皆可在按鍵分頁中重新綁定。重點： - ApplyKey（Mouse1）、RadiusUp/Down（=/-）、CycleOp/Shape/Paint（,/.//） - UndoKey（Ctrl+Z）、RedoKey（Ctrl+Y）、EyedropKey（G）、RampModeKey（H） - RadialKey（Q）、AdjustModeKey（V）、GiveToolKey（F8）、RebindMenuKey（F5） - 直接操作鍵（9 個，無預設）：OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow - CycleProfileKey、CycleStampKey、CycleStampBackKey - RequiredTool：Any / Pickaxe / TerrainForgeTool（預設） - AutoGiveTool：true（加入時給予法杖）

印記

StampToolMode：Same as Brush / Any / Pickaxe / TerrainForgeTool（預設 Same as Brush）

預覽

ShowPreview：true，ShowGuides：true（觸及範圍輔助、坡度著色、高度環）

歷史

UndoDepth：50（0–500，0 停用歷史）

伺服器（透過設定同步為權威）

AllowTerrainEdits：true（主開關）
AdminOnlyEdits：false（僅管理員）
RespectWards：true（封鎖他人結界）
RadiusCap / DeltaCap：0（關閉）— 伺服器強制的上限

效能

TilesPerFrame：4（1–32 tiles/frame）

🐛 疑難排解

問題	解決方法
選單未出現 / 游標不可見	關閉遊戲。刪除 `%APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\YourProfile\BepInEx\plugins\TerrainForge\` 與 `%APPDATA%\Thunderstore Mod Manager\PackageCache\`。重新啟動 TMM，檢查更新。
TMM 未顯示更新	TMM → Settings → 「Refresh mod list」（Ctrl+R）。關閉/重新開啟 TMM。確認正確的設定檔。
Thunderstore 版本衝突	在 `.csproj`、`Plugin.cs`、`manifest.json` 中提升版本（0.3.3 → 0.3.4）。重建 + 重新上傳。
印記複製/貼上無作用	HUD：`STAMP READY [X/Y]` = 就緒。若顯示「工具未裝備」，裝備工具（設定 → 印記工具）。
預覽在水下不可見	已於 0.3.2 修正 — 預覽會浮在水面上。請更新。
線/矩形/多邊形上出現圓圈	已於 0.3.2 修正 — 僅顯示標記的輪廓。請更新。
環形滾輪無作用	已於 0.3.2（`ZInput.GetMouseScrollWheel()`）與 0.3.4（游標置中時選取不再被清除）修正。請更新。
設定無法儲存	關閉選單（F5）以自動儲存。或直接編輯 `BepInEx/config/com.terrainforge.valheim.cfg`。
多人遊戲不同步	客戶端+伺服器皆安裝模組。兩者皆需 `UnlockDeltaLimit`。相同的 `MaxUpDelta`/`MaxDownDelta`。
建置失敗	檢查 `.csproj` 中的 `ValheimDir`、`BepInExCoreDir` 路徑或透過 CLI。需要 .NET SDK 8+。
編譯 / 打包	`dotnet build -c Release`（DLL 位於 `build/`）、`-p:Deploy=true`（安裝至設定檔）或 `-p:Package=true`（zip 位於 `build/`）。

🔗 連結

Thunderstore 頁面： https://thunderstore.io/c/valheim/p/MRAnalytics/TerrainForge/
GitHub 儲存庫： https://github.com/marceloanton/TerrainForge
贊助： cafecito.app/byrka
更新日誌： Changelog

TerrainForge — 無限制地改造 Valheim。