PUP FPS

Author: PUP

PUP FPS improves performance around very large player-built bases in Valheim. It combines supported static building pieces into GPU-rendered clusters while preserving their appearance, collision and restoration data.

The mod is most effective when a base contains thousands of repeated pieces made from the same materials. Large Grausten, stone or wooden structures usually benefit more than small buildings containing many different decorative objects.

Important

• Make a world backup before first use.
• Doors, gates, animated pieces and unsupported multi-material objects are excluded.
• Keep only one version of PUP_FPS.dll installed.
• After baking a large base, restart the game to get the full performance benefit.
• The mod cannot raise FPS above the limit of your hardware. If Valheim normally runs at a maximum of 50 FPS on your PC, the mod will not turn it into 200 FPS.

Multiplayer

PUP FPS now works in multiplayer.

• The host and all players must install the same version of the mod.
• Only the host can bake or restore zones.
• The first time a player joins, the baked zones are downloaded and saved on that player's PC. This may take some time on a very large base.
• The next time the player joins, saved zones load much faster.
• If the host changes a baked zone, the player downloads only that zone again.
• The player's local cache cannot change or damage the host's world.

Controls

Key	Action
[	Bake the 64x64 metre cell containing the player
]	Restore the nearest baked cell
\	Toggle material highlighting
F8	Emergency restoration of all parked PUP FPS objects

On a Russian keyboard layout, [ and ] are the physical keys normally used for Х and Ъ. Switching to an English layout can make the controls clearer.

To repair or rebuild pieces in a baked cell, restore that cell with ], make the changes, and bake it again with [. Multiplayer controls are available only to the host/administrator.

Highlight colours

Highlighting marks supported building materials, not the whole area:

• 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/glass

Installation

1. Install BepInExPack for Valheim.
2. Install the same PUP FPS version on the host and every client.
3. Copy PUP_FPS.dll into BepInEx/plugins/PUP_FPS/ when installing manually.
4. Start Valheim and load a world.

How it works

Each 64x64 metre bake area is divided into 16x16 metre clusters. Supported static pieces are rendered through GPU instancing while collision, structural support and precipitation protection are preserved.

Results depend on the base and hardware. The largest improvement is expected when the original bottleneck is a very high number of repeated building instances.

Restoring safely

Normal restoration is intentionally gradual so physics and structural support have time to settle. Wait until restoration finishes before leaving the world. If normal restoration cannot be started, the host can use F8 and check BepInEx/LogOutput.log.

If necessary, the saved PUP FPS configuration for a world can be removed through the r2modman Config Editor. This removes the mod's saved configuration, not the world itself.