LoyalSpears
Spears that are loyal - return on throw and do not get picked up by others.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.dllinBepInEx/plugins/ - The
manifest.jsonandREADME.mdare for mod manager compatibility.
- This will place
- Launch Valheim. The mod will be active.
Uninstall
- Delete
BepInEx/plugins/LoyalSpears.dllfrom 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).
