FearNoSpear

FearNoSpear prevents thrown spears from disappearing on long throws, zone unloads, and network cleanup. It also adds a chat locator for tracked spears and can clean up vanilla death pins when tombstones are recovered.

Features

Protects recoverable thrown spear projectiles.
Extends tracked spear projectile TTL to a fixed 60 seconds.
Rescues the original spear before TTL expiry or unexpected projectile cleanup.
Uses Valheim's own Projectile.SpawnOnHit path first, then verifies that a matching spear drop exists.
Falls back to ItemDrop.DropItem only when the native path cannot produce a matching drop.
Uses owner-only rescue, a ZDO claim flag, and a 4 meter duplicate check to reduce multiplayer duplicate-spawn risk.
Adds a configurable chat command, default !myspear, that pins up to 5 known tracked spear locations.
Optionally removes vanilla death pins when the local player's tombstone is recovered, and removes death pins from deaths that create no tombstone.

Chat Locator

Type the configured command in normal in-game chat:

!myspear

The command is consumed locally, so it is not sent as public chat. It creates saved minimap pins for known tracked spear locations and opens the map. A single result is named Spear!; multiple results are named Spear 1, Spear 2, and so on.

Tracked spear positions are updated while the spear is flying and when a matching tracked spear drop is observed. The locator keeps a session-only registry and uses it to answer later chat requests.

The locator is not a generic spear scanner. It only tracks spears observed by this mod. Loaded ItemDrop scanning only refreshes spears that already have a tracked locator record.

When a tracked spear is picked up, locator pins created by the current session are removed and the matching local/server session records are cleared.

Death Pin Cleanup

CleanDeathPins removes the vanilla Death map pin when the local player's tombstone is recovered. It also removes the death pin immediately if the death created no tombstone, such as when there was nothing to drop.

The cleanup only targets saved minimap pins of type Death near the matching death or tombstone position.

Config

Available config options:

[General]
Lock Configuration = On
Enabled = true
ChatCommand = !myspear
CleanDeathPins = true

[Rescue]
TTLRescueWindowSeconds = 1.0
AllowLastKnownOwnerIfZNetViewInvalid = true
LastKnownOwnerGraceSeconds = 2

General

Lock Configuration
Locks synchronized settings to the authoritative config.

Enabled
Master switch for spear tracking, rescue, locator, and death pin cleanup.

ChatCommand
Chat command used to pin known tracked spear locations. The comparison is case-insensitive. Leave empty to disable the chat command.

CleanDeathPins
Enables death pin cleanup for recovered tombstones and deaths that create no tombstone.

Rescue

TTLRescueWindowSeconds
How close to projectile TTL expiry the mod should rescue a still-airborne tracked spear. 1.0 means the final second of projectile lifetime.

AllowLastKnownOwnerIfZNetViewInvalid
Allows the most recent known owner to rescue if the projectile ZNetView has already become invalid.

LastKnownOwnerGraceSeconds
Maximum age, in seconds, for the last-known owner fallback.

Fixed Internal Defaults

These are intentionally not exposed as config options:

Minimum tracked spear projectile TTL: 60 seconds.
Locator pins per command: 5.
Rescue before TTL expiry: enabled.
Rescue on unexpected destroy: enabled.
ItemDrop fallback: enabled.
Owner-only rescue: enabled.
ZDO rescue claim flag: enabled.
Nearby duplicate cleanup radius: 4 meters.
Verbose debug logging: disabled.

Github

https://github.com/sighsorry1029/FearNoSpear