LoyalSpears
Spears that are loyal - return on throw and do not get picked up by others.
About this mod Author’s original text
Loyal Spears
Spears that are loyal — they return to you after being thrown and prevent other players from auto-picking them up.
This is a Valheim 1.0+ port of the original Loyal Spears by Goldenrevolver, upgraded to use Jotunn's built-in config sync instead of ServerSync.
Features
- Auto-Return: Thrown spears automatically return to their owner after landing, or after traveling too far.
- Owner-Only Pickup: Prevent other players from auto-picking up your thrown spears.
- Weight Reservation: Throws reserve a portion of your carrying capacity so you don't accidentally overburden yourself picking up loot before retrieving your spear.
- Portal Safety: Spear tracking components are cleaned up when teleporting through portals, preventing spears from getting stuck across dimensions.
Installation
- Install BepInEx and Jotunn into your Valheim game.
- Download the latest release LoyalSpears.zip.
- Extract the contents directly into your Valheim game folder.
- This will place LoyalSpears.dll in BepInEx/plugins/
- The manifest.json and README.md are for mod manager compatibility.
- Launch Valheim. The mod will be active.
Uninstall
- Delete BepInEx/plugins/LoyalSpears.dll from your Valheim game folder.
Configuration
All settings are server-synced. The server's configuration is authoritative.
| Setting | Type | Default | Description |
|---------|------|---------|-------------|
| EnableBlockAutoPickup | bool | true | Prevent other players from auto-picking up your thrown spears. |
| ReturnAfterSeconds | float | 5 | Seconds until a thrown spear returns to its owner after hitting the ground. 0 or negative disables. |
| BlockReturnIfOverburdened | bool | false | Skip auto-return if picking it back up would overburden the owner. |
| ReserveThrowWeight | bool | true | Count thrown spear weight as reserved during auto-pickup checks. |
| MaxReservationSeconds | float | 60 | Safety cap so a lost spear doesn't reserve weight forever. |
| FlightDistanceUntilAutoReturn | float | -1 | If a thrown spear travels further than this distance from the owner without hitting the ground, it auto-returns. Negative disables. |
Find the config file at BepInEx/config/com.loyalspears.mod.cfg.
Dependencies
- BepInExPack for Valheim
- Jotunn (latest)
License
This project is licensed under the MIT License - see LICENSE for details.
Original code from Goldenrevolver/ValheimSpearModsAndFriends (MIT, Copyright 2023 Goldenrevolver).
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: