PUP FPS

Author: PUP

Requires BepInExPack_Valheim 5.4.2350 or newer.

Maintaining PUP FPS, especially its dedicated-server support, takes a great deal of time, testing and development work. If you would like to help the mod keep growing, you can support the author on Boosty.

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 or leave the rendered area and return 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 supports single-player, player-hosted multiplayer and dedicated servers. Single-player and hosting use the same world cache; guests receive a compact client cache.

• The host and all players must install the same version of the mod.
• Only the host or a server administrator can bake, restore, or highlight zones.
• Dedicated-server administrators are assigned through Valheim's adminlist.txt (one platform ID per line).
• 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.

Configuration

A ready-to-use PUP FPS.cfg is included and installed under BepInEx/config. All 17 material groups and baking damaged pieces are enabled by default.

Settings are available under PUP FPS in BepInEx ConfigurationManager, without Debug mode. ConfigurationManager is optional: the file can also be edited directly. Restart the game after editing settings.

• Keyboard: assign Bake, Unbake, Highlight and RestoreAll to individual keys. For keyboards requiring AltGr for brackets, use keys such as F6 and F7 instead. None disables an action.
• BakingMaterials: enable or disable Wood, Corewood, Finewood, Darkwood, Shingle Roof, Ashwood, Thatch Roof, Timberwood, Stone, Black Marble, Grausten, Iron, Copper, Flametal, Crystal, Ice and Other.
• Baking / BakeDamagedPieces: allow damaged pieces within enabled material groups. Disabling a material also excludes its damaged pieces. This option does not repair damage.
• ServerStreaming / Enabled: enables adaptive packet-size increases on dedicated servers, with fallback under load. Does not apply to single-player or player-hosted games.

Material filters affect new baking only. To change an already baked cell, restore it and bake it again. Restoration and F8 remain available regardless of the selected materials. Multiplayer uses the host/server's material settings.

The supplied configuration contains defaults and may replace existing settings during installation; preserve custom key bindings when updating.

Loading protection

Non-player physical objects, including animals and carts, are temporarily held while the baked replacement is not ready during loading, baking and restoration. Players are excluded from this freeze. Objects resume when readiness is confirmed.

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

Use ] to restore one baked cell or F8 to restore all parked objects. Wait for the on-screen completion message before leaving the world. Preserve the world's PUP FPS cache and restoration data; do not delete them while objects are baked.