Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
LoyalSpears
Spears that are loyal - return on throw and do not get picked up by others.
| Last updated | a week ago |
| Total downloads | 871 |
| Total rating | 0 |
| Categories | Mods Gear Misc Server-side Utility AI Generated Deep North Update |
| Dependency string | jorstar-LoyalSpears-1.0.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.
Preferred version: 5.4.2350ValheimModding-Jotunn
Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.
Preferred version: 2.30.2README
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).