HideWater
Client-side F9 toggle for water surface rendering. Preserves water physics, supports configurable hotkeys and StartHidden. No server installation required.
模組介紹 作者原文
HideWater
Press F9 to hide water surfaces; press it again to restore them. Client-side only: the server does not need this mod. F8 remains available for Fish Tracker.
Installation
Install Mod Manager or r2modman, with BepInExPack Valheim enabled. To test the ZIP locally, use your manager's local mod import feature.
For manual installation, install BepInEx for Valheim and copy plugins/HideWater/HideWater.dll from this archive into your game's BepInEx/plugins/HideWater/ folder. Remove the DLL while the game is closed to uninstall.
Configuration
After the first launch, edit BepInEx/config/com.local.valheim.hidewater.cfg in your game installation or mod manager profile while the game is closed:
[General]
ToggleKey = F9
StartHidden = false
- ToggleKey: BepInEx KeyboardShortcut. Modifier combinations such as F9 + LeftControl are supported.
- StartHidden: hide water automatically on every world entry. Hotkey toggles are not saved between sessions.
How it works
Inspected against the locally installed Valheim 1.0.16 assembly. The mod disables only Renderer.enabled on WaterVolume.m_waterSurface and the MeshRenderer attached to Water objects. It discovers surfaces through WaterVolume.Instances and Water.Instances every two seconds, including newly loaded areas, and restores each renderer's previous state when water is shown or the plugin is disabled.
WaterVolume physics, colliders, buoyancy, water depth, swimming, terrain, networking and world saves are not modified. No Harmony patches, Jotunn or ServerSync are required.
Limitations and testing status
- Built and statically verified against Valheim 1.0.16; in-game testing is still pending. Swimming, stamina, Wet, drowning, boats, fish, teleporting, world re-entry and server connections have not yet been verified in a live game.
- Newly loaded surfaces may remain visible for up to two seconds.
- Underwater fog removal is not implemented. Fog, mist, splashes and other effects can remain and may limit seabed visibility.
- Custom water from other mods without the standard Water/WaterVolume components is not detected. Mods controlling the same renderer may conflict.
- The hotkey works while a local player exists, including with in-game windows open.
- Compatibility with other Valheim versions is unverified.
BepInEx logs state changes and the first nonempty water renderer count per world entry.
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時，主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝，否則該模組不會生效：