PUP FPS

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.

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

• Install BepInExPack for Valheim.
• Install the same PUP FPS version on the host and every client.
• Copy PUP_FPS.dll into BepInEx/plugins/PUP_FPS/ when installing manually.
• 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.