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

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

Changelog

Author: PUP

1.0.19

• Final stable release based on the fully tested 1.0.15 build.
• Fixed precipitation passing through baked darkwood roofs and ridge pieces.
• Preserved the original appearance, colours, transparency and collision of supported pieces.
• Preserved safe staged loading, exact restoration and guarded F8 emergency recovery.
• Removed temporary diagnostics and experimental code from the public build.

1.0.15

• Added exact support for darkwood roofs and 26/45-degree ridge pieces.
• Preserved the strict object filter and excluded animated or incompatible multi-material pieces.
• Improved precipitation handling without adding visible proxy surfaces.

1.0.7

• Added guarded F8 emergency recovery with structural protection.
• Added immediate collision loading beneath the player.
• Added distance-prioritized asynchronous loading for remaining cached clusters.
• Added an adaptive frame budget to reduce freezes when entering very large bases.

1.0.6

• Embedded collider geometry in newly baked cache files.
• Fixed collision on black-marble stairs after reloading a zone or restarting the game.

1.0.5

• Added safe rediscovery of baked objects when saved ZDO IDs change.
• Rebinds stale IDs only after full count and uniqueness validation.

1.0.4

• Removed unsafe rotation repair.
• Added exact-object restoration by saved ZDO IDs.
• Allowed cells to be restored after the world was opened with the mod disabled.

1.0.2

• Restored remote-parking optimization.
• Original coordinates are restored before normal Valheim world saves.
• Added migration support for existing baked cells.

1.0.1

• Added safe behavior when the mod is disabled or removed.
• Original GameObjects are disabled only locally while an optimized cluster is active.

1.0.0

• Initial release.
• Added 64x64-metre bake cells with 16x16-metre subclusters.
• Added optimized rendering for supported static building pieces.
• Added staged restoration, collision and structural-support protection.
• Added support for Grausten, wood families, thatch, stone, black marble, Dvergr copper, Flametal and crystal.