ValheimScalability
Valheim Scalability - improves performance and scalability of Valheim
模組介紹 作者原文
ValheimScalability
ValheimScalability is a client-side performance mod for Valheim focused on
improving rendering performance in large builds, dense settlements, and heavily
populated world areas.
The mod reduces the number of individual objects that need to be rendered by
grouping compatible static meshes into larger render batches. It includes
safeguards for animated, interactive, destructible, modded, physics-driven, and
wind-affected objects so they can remain independent when needed.
Let Valheim render more without requiring players to build less.
Features
Sector Mesh Clustering
ValheimScalability groups compatible static meshes within loaded world sectors
into larger combined meshes.
This can significantly reduce renderer and draw-call overhead in areas
containing large numbers of:
- Building pieces
- Walls
- Floors
- Roof pieces
- Static decorations
- Rocks and other compatible world geometry
- Other static meshes added by mods
Original gameplay objects remain loaded and functional. ValheimScalability
changes how compatible geometry is rendered; it does not remove the underlying
Piece, WearNTear, ZNetView, physics, collider, or other gameplay
components.
Adaptive Rendering
In Adaptive mode, distant cells use clustered rendering while nearby visible
cells return to their original renderers.
This provides a compatibility-oriented balance between normal interaction and
lower draw-call overhead.
Full Cluster Rendering
FullCluster keeps compatible geometry clustered regardless of player distance.
This generally provides the strongest draw-call reduction and is especially
useful for benchmarking and extremely large builds.
Easy A/B Performance Testing
Set:
Mode = Off
to restore normal object rendering without uninstalling the mod.
This makes it easy to compare the same location with clustering enabled and
disabled.
Rendering Modes
| Mode | Behavior | Recommended Use |
|---------------|----------------------------------------------------------------------------------------------|-----------------------------------------------------------|
| Off | Original Valheim renderers only. Generated cluster rendering is not presented or rebuilt. | Baseline FPS comparisons, troubleshooting |
| Adaptive | Nearby visible cells use originals; farther cells use clustered rendering. | General gameplay |
| FullCluster | Uses clustered rendering everywhere it is safe; player proximity does not restore originals. | Maximum performance, very large settlements, benchmarking |
Installation
Install ValheimScalability like a normal BepInEx Valheim mod.
Mod Manager
Install the mod through your preferred -compatible mod manager.
Manual Installation
Copy the ValheimScalability plugin into your Valheim BepInEx plugins directory:
Valheim/
└── BepInEx/
└── plugins/
└── ValheimScalability/
Launch the game once to generate the configuration file under:
BepInEx/config/
Client-Side Mod
ValheimScalability is a client-side rendering optimization.
It does not change:
- World data
- Building placement
- Damage values
- Networking ownership
- Saved objects
- Server-authoritative gameplay state
Dedicated servers do not need to run the rendering system. Each player can
configure the rendering behavior for their own client.
Recommended Profiles
| Profile | Mode | Cell Divisions | Lowest LOD | MaterialPropertyBlocks | Notes |
|---------------------|---------------|---------------:|------------|------------------------|--------------------------------------------------------|
| General gameplay | Adaptive | 1 | true | Skip | Recommended starting point |
| Maximum performance | FullCluster | 1 | false | Skip | Strongest batching and easiest benchmark configuration |
| Baseline / disabled | Off | 1 | N/A | N/A | Compare against normal rendering |
CellDivisionsPerSector = 1 is the default because it produced the strongest
real-world gains during testing. Higher values trade batching efficiency for
finer Adaptive-mode p
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。