PUP82-PUP_FPS icon

PUP FPS

Improves FPS around massive Valheim bases by combining thousands of repeated building pieces. Controls: [ bake, ] restore, \ highlight, F8 emergency restore.

Last updated 13 hours ago
Total downloads 31
Total rating 0 
Categories Mods Utility Building
Dependency string PUP82-PUP_FPS-1.0.19
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333

README

PUP FPS

Author: PUP

PUP FPS improves performance around very large player-built bases in Valheim. It combines thousands of supported static building pieces into a small number of optimized clusters.

The mod works best on large builds made from many repeated pieces. The fewer different materials a base uses, the larger the FPS improvement can be. Mixed-material builds also benefit, but usually less.

Test results

Test PC: AMD Ryzen 9 7900X, NVIDIA GeForce RTX 4070 SUPER.

  • 50,000 instances, mostly Grausten: 40 FPS before, 170 FPS after on low settings, and 120 FPS after on maximum settings.
  • 22,000 instances, mostly wood: 80 FPS before and 180–200 FPS after.

Results depend on the base, graphics settings and hardware.

Controls

Key Action
[ Bake the current 64x64 metre cell
] Restore the current baked cell
\ Highlight supported pieces in the current cell
F8 Emergency safe restoration

Each supported material type has its own highlight colour.

To repair or rebuild pieces, restore the cell with ], make the changes, and bake it again with [.

Highlight colours

  • Blue — Grausten
  • Green — regular wood
  • Purple — dark wood
  • Orange — Ashwood
  • Yellow — logs and roundwood
  • Beige/gold — thatch roofs
  • Grey — stone
  • Pink/red — black marble
  • Cyan — Dvergr copper
  • Red-orange — Flametal
  • Brown — crystal and glass

Supported materials

Grausten, regular wood, core wood, dark wood, Ashwood, thatch, stone, black marble, Dvergr copper, Flametal, crystal and glass.

Doors, gates, animated pieces and incompatible multi-material objects are skipped automatically.

Installation

  1. Install BepInExPack for Valheim.
  2. Copy PUP_FPS.dll into BepInEx/plugins/PUP_FPS/.
  3. Start Valheim and load a single-player world.
  4. Check that the BepInEx log contains PUP Safe Building Combiner 1.0.19 loaded.

Important

  • PUP FPS is intended for single-player worlds only.
  • Make a world backup before first use.
  • Keep only one version of PUP_FPS.dll installed.
  • Wait until baking or restoration finishes before leaving the world.
  • Use F8 only if normal restoration does not work.
  • If necessary, saved PUP FPS world data can be removed through the BepInEx Config Editor. Restore baked cells first whenever possible and make a world backup before deleting the data.

PUP FPS preserves collision, structural support and exact restoration data. Original pieces are saved at their normal world coordinates so the world remains usable if the mod is disabled.

Video

https://youtu.be/7gId6gBINAk