BotanicPupPatch

BotanicPupPatch 2.1.1

Multiplayer add-on for PUP FPS:

• Protects building stability while required cluster collisions are loading.
• Keeps required cluster colliders available for animals and other physics objects, including on dedicated servers.
• Optional with FiresGhettoNetworking: Mob ownership follows its current AI player target. Target changes trigger a handoff attempt; transfers blocked by an attack are retried after it ends.

Requires: BepInExPack Valheim 5.4.2351 and PUP FPS 1.0.34 or newer. FiresGhettoNetworking is optional; tested with 1.5.36 and 1.5.41.

Compatibility is checked from the required native interfaces at startup, without a fixed PUP version or DLL hash lock. Tested with PUP FPS 1.0.34 and 1.0.36. Newer native collider preparation and retention remain in charge; building-stability, restore and ownership-change safeguards stay active.

Installation

Close the game and server. Import the ZIP or replace the existing BotanicPupPatch.dll. Install the same PupPatch and PUP FPS versions on the server and all clients, then restart.

FiresGhettoNetworking settings

Strongly recommended for dedicated servers already using FiresGhettoNetworking: TooManyLags - FGN Addon can replace and extend this patch's mob ownership feature with camera-directed ownership of interactive objects and idle tamed animals.

To use its mob feature, set PupPatch's [FGN AI Ownership] EnableAIOwnership=false on the server and all clients, and keep TooManyLags' EnableAIOwnership=true. Use a TooManyLags release compatible with your PUP FPS version. Install TooManyLags on the server and all clients, then restart. PupPatch's collision and building-stability protection remains active.

AI-target ownership is enabled by default when FiresGhettoNetworking is installed and applies when at least two eligible players are present. If the target player's ping is high, the server only takes ownership when another eligible player is close to the mob and FiresGhettoNetworking's Server-Side Simulation is enabled. Otherwise, the targeted player remains the intended owner. Tamed, ridden/player-controlled mobs and bosses are excluded.

Config: BepInEx/config/botanic.pup.patch.cfg, section [FGN AI Ownership].

| Setting | Default | Effect | | --- | --- | --- | | EnableAIOwnership | true | Enable this patch's AI-target ownership. | | ServerFallbackPingMs | 200 | Target player's ping threshold for server takeover, in milliseconds. | | ServerFallbackRadius | 6 | Maximum distance between another eligible player and the mob, in metres. |

On the server, set FiresGhettoNetworking's Balance Creature Ownership = true and disable both experimental Server ZDO Ownership Transfer options. Server-Side Simulation is only required for server takeover. Use the same EnableAIOwnership setting on the server and clients; changes require a restart. Existing config values are preserved.

Diagnostic logging is off by default. Automated checks passed; live dedicated-server testing is still pending. Previously destroyed objects are not restored.