You are viewing a potentially older version of this package. View all versions.
JoksterCube-PingMark-1.6.2 icon

PingMark

Mark loot, creatures, and locations with named pings, colored outlines, and live distances. Sense what's hidden around you and share discoveries with your party.

Date uploaded a week ago
Version 1.6.2
Download link JoksterCube-PingMark-1.6.2.zip
Downloads 70
Dependency string JoksterCube-PingMark-1.6.2

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
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.2351

README

PingMark

Share discoveries and keep your party on target!

See how far away every ping is, something vanilla Valheim never shows. Aim, press Z, and your friends see exactly what you found: a named marker, a colored outline and a live distance. Stand still and press Left Shift + Z to sense loot and creatures hidden in the dark around you.


๐Ÿ“ธ Screenshots

Everyone sees what you found, and how far away it is.

Dropped weapons named and outlined, with who pinged them and their distance

Sense the loot hidden in the dark. One press of Perception outlines every coin, gem and chest around you.

Perception outlining coins, gems and chests in a dark forest

Read creatures and fish from afar. Taming progress and fish quality, without walking up to them.

Wolf being tamed, showing Wolf (2%) and its distance Pinged pufferfish showing its quality and distance


๐Ÿงญ Features

๐Ÿ“ Pinging

  • ๐Ÿ“ Distance on every ping: world and map pings show who pinged and how far away it is, updating as you move. Works on regular map pings too.
  • ๐ŸŽฏ Aim and ping: mark what you are looking at with its name and an outline, even while running.
  • ๐Ÿ’Ž Find the loot: dropped weapons, armor and materials glow so they're easy to spot in the grass, and so do cut logs and broken ore deposits.
  • โฑ๏ธ Longer pings: set how long pings stay with Ping Duration (vanilla 5 s).

๐Ÿบ Creatures & fish

  • ๐ŸŽฏ Track creatures: highlight a mob with a nameplate and distance that follow it, red for hostile, green for friendly.
  • ๐Ÿ— Taming from afar: ping an animal from across the field to see how its taming is going, like Wolf (15%), or how a tamed one feels, like Boar (Hungry).
  • ๐ŸŸ Fish quality: pinged fish show their quality before you cast, like Pufferfish โ€ข 5, in their own color.
  • ๐ŸŽฃ Watch your catch: ping a fish before it bites and it stays outlined until you land it or it gets away. While a fish is hooked, the Fishsight slot next to your power appears: press Left Alt + Z to switch the outline on or off. Auto Outline Hooked Fish outlines every catch.

๐Ÿ”ฎ Perception

  • ๐Ÿ‘๏ธ Sense what's near: stand still and press Left Shift + Z to outline loot around you for 15 s, handy for coins and gems in dark dungeons. Nearby PingMark players see it too.
  • ๐Ÿบ Sense creatures: it also highlights every hostile and friendly creature in range, beyond the usual highlight limit.
  • โณ Like a Guardian Power: its own slot shows Ready or the time left, and it's ready again 60 s after each use. Prefer a cost that grows with what you sensed? Set Perception Fatigue Mode to Relative.

๐ŸŽจ Your rules

  • ๐Ÿ‘ฅ Mark teammates: optionally highlight players instead of the spot they stood on (off by default).
  • ๐Ÿ—‚๏ธ Choose what counts: pick which objects are Valuables, Locations or Useful, and change colors, labels, keys and range.

๐ŸŽฎ Controls

Shortcut Action
Z Ping the spot or object you aim at, or highlight a creature.
Left Shift + Z Perception (standing still): sense loot and creatures near you.
Left Alt + Z While a fish is hooked: switch its outline on or off.
Right Ctrl + P Turn PingMark on or off.
Right Ctrl + Right Shift + P Open the Prefab Collections menu (admins only on servers).

๐ŸŽ›๏ธ Ping, Perception and Fishsight can be rebound in the game's Settings > Controls (the modifier stays, so Perception keeps Left Shift). Every shortcut is also in the config under 9 - Inputs.


๐Ÿ› ๏ธ Prefab Collections Menu

Decide which objects get a name and outline when pinged.

  • Search and filter every object and location in the game, including modded ones.
  • Move objects between colored sections, or add, rename and remove sections.
  • Auto Sort rebuilds the default Valuables, Locations and Useful sections, modded objects included. Undo reverts, Apply saves.
  • Find an object's ID: turn on Debug Ping Names (an Advanced setting) and press Z on it.
  • For admins sharing lists: Copy YAML / Import YAML move every section through the clipboard, a section's Import takes a CSV list, and Export Report writes how every object was sorted to BepInEx/config/JoksterCube.PingMark.AutoSortReport.csv.

๐Ÿ”’ On a server with PingMark, only admins can change collections, and the server checks every change. Collections are saved in BepInEx/config/JoksterCube.PingMark.Collections.yml and synced to all players.


๐Ÿ“ฆ Installation

Install with a mod manager (r2modman, Thunderstore App), or manually:

  1. Install BepInExPack Valheim.
  2. Extract PingMark into BepInEx/plugins.
  3. Launch the game. Settings are in BepInEx/config/JoksterCube.PingMark.cfg.

Installing on the server is optional. It syncs settings, filters ping range on the server and protects the collections.


๐Ÿงฉ Compatibility

  • โœ… Works in single-player and on servers without PingMark.
  • โœ… Players without the mod can join. They see ordinary pings (no names, outlines or highlights).
  • ๐Ÿ“ Z pings reach players within 200 m of you by default. Map pings stay global.
  • โš ๏ธ On a PingMark server, every player with PingMark needs the same version as the server. Players without the mod can still join.

๐Ÿ”ง Configuration

Most players never need to change anything. These are the settings worth knowing about. Synced settings come from the server when it runs PingMark.

Setting Default Synced What it does
Z Ping Broadcast Distance 200 m โœ” How far your Z pings reach. 0 = unlimited.
Send Z Pings To Unmodded Players On โœ” Players without the mod still get an ordinary ping.
Ping Cooldown 0 s โœ” Minimum time between Z pings.
Enable Other Players Off โœ” Let Z highlight players.
Show Pinger Name / Show Distance On What ping labels display.
Outline Width 2 px 0 hides all outlines.
Lock Configuration On โœ” Only admins can change synced settings.

๐Ÿ’ก Some settings are hidden as Advanced in Configuration Manager. Turn on Advanced settings there to see them. They are marked with โš™๏ธ in the full reference below.

Full settings reference

1 - General

Setting Default Synced What it does
Enabled On Turn all PingMark features on or off.
Lock Configuration On โœ” Only admins can change synced settings.
Refresh Interval โš™๏ธ 0.25 s โœ” How often distances update (0.05โ€“5 s).
Ping Cooldown 0 s โœ” Minimum time between Z pings and highlights (0โ€“60 s).
Z Ping Broadcast Distance 200 m โœ” Sender-to-recipient range (0โ€“10,000 m, 0 = unlimited). Without a modded server, the shorter of both players' ranges applies.
Send Z Pings To Unmodded Players On โœ” Send ordinary pings to players without PingMark, at any distance.
Debug Ping Names โš™๏ธ Off Show the detected object/location IDs when pinging. Useful for editing collections.
Show Ability Names On Show the names above the Guardian Power and the ability slots beside it. Turn off to hide them and bring the slots closer.

2 - Ping Label

Setting Default Synced What it does
Show Pinger Name On Show who pinged.
Show Distance On Show your distance to pings and highlights.
Show Target Name On Show the pinged object's name.
Use Kilometers On Show 1,000 m and above as km.
Empty Label Text โš™๏ธ PING Text shown when everything above is hidden.
Ping Color White Label color.
Match Ping Text To Outline Off Use the outline color for the label instead.
Ping Duration 5 s โœ” How long a location or object ping stays: label, outline and map marker (1โ€“120 s).

3 - Camera Ping

Setting Default Synced What it does
Max Distance 500 m How far you can aim (10โ€“2,000 m).
Max Underwater Depth โš™๏ธ 10 m Deeper targets ping the water surface instead (0โ€“100 m).

4 - Ping Targets

Setting Default Synced What it does
Enable Drops On โœ” Name and outline dropped items.
Enable Fish On โœ” Name and outline fish, with their quality.
Enable Gravestones On โœ” Name and outline gravestones.
Enable Other Players Off โœ” Highlight players instead of pinging their position (Perception highlights them too).
Enable All Other Off โœ” Name and outline anything not in a collection (Perception outlines it too).

5 - Outlines

Setting Default Synced What it does
Enable Ping Outline On Outline pinged objects and players.
Outline Width 2 px 0โ€“10 px, visible through walls. 0 hides outlines.
Ping Drop Color Purple Dropped items.
Ping Fish Color Pink Fish, and the fish on your line.
Ping Gravestone/Player Color Orange Gravestones and players.
Ping Anything Color White Other objects.
Hostile / Ally Outline Color Red / Green Highlighted creatures.

6 - Mob Highlight

Setting Default Synced What it does
Enable Mob Highlight On โœ” Allow creature highlights.
Enable Mob Outline On Outline highlighted creatures.
Mob Highlight Duration 10 s โœ” How long a highlight lasts (1โ€“120 s).
Max Highlighted Mobs 1 โœ” Highlights per player at once (1โ€“20). A new one replaces your oldest.

7 - Prefab Collections

Setting Default Synced What it does
Color 1 โ€“ Color 12 โš™๏ธ Gray, White, Red, Orange, Gold, Lime, Green, Teal, Cyan, Blue, Violet, Pink Palette that collection sections pick from.
Unassigned Section Color ID โš™๏ธ 1 Palette slot for the menu's Unassigned column.

8 - Player Highlight

Setting Default Synced What it does
Player Highlight Duration 5 s โœ” How long a player highlight lasts (1โ€“120 s).
Hide Own Player Outline On โœ” Don't outline yourself when someone marks you.

9 - Inputs

Setting Default Synced What it does
Ping Shortcut Z Ping what you aim at, or highlight the creature you aim at. Also in Settings > Controls.
Toggle Mod Shortcut Right Ctrl + P Turn PingMark on or off.
Prefab Editor Shortcut Right Ctrl + Right Shift + P Open the Prefab Collections menu.
Perception Shortcut Left Shift + Z Use Perception. Only while standing still (no other key held). Its main key can also be set in Settings > Controls.
Fishsight Shortcut Left Alt + Z While a fish is hooked, switch its outline. Empty hides the Fishsight slot. Also in Settings > Controls.
Enable Prefab Editor Shortcut โš™๏ธ On Turn the menu shortcut on or off.

10 - Perception

Setting Default Synced What it does
Enable Perception On โœ” Allow Perception and show its slot next to the Guardian Power. It senses what Ping Targets allows.
Perception Range 10 m โœ” How far around you Perception looks.
Perception Line Of Sight On โœ” Only sense what you can see: things behind walls, rock or buildings, or buried underground, are left out.
Perception Duration 15 s โœ” How long Perception keeps things outlined (the Perception status).
End Perception Early On โœ” End Perception and start fatigue once every drop, pickable, chest, deposit and enemy it found is gone.
Perception Max Outlines 64 โœ” Most objects outlined per use, nearest first.
Perception Fatigue Duration 60 s โœ” Fixed mode: cooldown from each use, like a Guardian Power. Relative mode: the base fatigue once Perception ends. 0 = none.
Perception Fatigue Mode Fixed โœ” Fixed: ready again the duration above after each use. Relative: fatigue starts once Perception ends, adds a cost for everything sensed, and starts early once it's all looted or slain.
Fatigue Per Object 1.5 s โœ” Relative mode: added for each listed object outlined.
Fatigue Per Drop 0.25 s โœ” Relative mode: added for each dropped item on the ground outlined.
Fatigue Per Ally 0.5 s โœ” Relative mode: added for each tamed or non-hostile creature.
Fatigue Per Enemy 2.5 s โœ” Relative mode: added for each hostile creature.
Perception Max Fatigue 90 s โœ” Relative mode: the longest the fatigue can get.
Perceive Creatures On โœ” Perception also highlights every hostile and allied creature in range, ignoring Max Highlighted Mobs. Players follow Enable Other Players.
Perception Effect On Play a Guardian Power style burst around a player who uses Perception (nearby PingMark players see it too).
Perception Effect Color Light blue Color of that burst, for your Perception and other players'.
Perception Sound sfx_WishbonePing_near Sound played with the burst (any sound prefab, e.g. sfx_secretfound). Empty = silent.

11 - Fishing

Setting Default Synced What it does
Auto Outline Hooked Fish Off Outline every fish you hook until it's caught or gets away. Off: only a fish you pinged before it bit; the rest wait for Left Alt + Z.

๐Ÿ–ผ๏ธ Gallery

Outlines in their own colors: treasure and a hostile skeleton, a runestone, a Greydwarf nest.

Treasure chest and hostile skeleton highlighted with distinct colors Runestone marked with a colored outline and distance label Greydwarf nest marked with a colored outline and distance label

Creature nameplates and distances that follow them.

Wildlife highlight with a moving nameplate Friendly creature highlights with names and distances World ping with a live distance label

Fishing: the fish you pinged stays outlined on your line, and the Perception and Fishsight slots sit beside your power.

Hooked fish outlined in pink while fishing from a boat Guardian Power, Perception and Fishsight slots on the HUD

Prefab Collections menu: searchable, color-coded sections of everything that can be pinged.

Prefab Collections admin menu


๐Ÿ’ฌ Feedback & Support

Report bugs or suggest improvements on GitHub.


Author: JoksterCube
Version: 1.6.2
License: GNU GPL v3 or later

CHANGELOG

Version Update Notes
1.6.2 โ€ข New runes on the Perception icon ring.
1.6.1 โ€ข Easier-to-read changelog: every change on its own line.
1.6.0 New:
โ€ข Pinged tamed animals show their mood next to their name, like Boar (Hungry) or Husk (Happy), and animals being tamed show their progress, like Wolf (15%).
โ€ข Pinged fish show their quality, like Pufferfish โ€ข 3, and have their own toggle and color (Enable Fish, Ping Fish Color).
โ€ข Ping a fish before it bites and it stays outlined until you land it or it gets away.
โ€ข A Fishsight slot beside the Guardian Power shows while a fish is hooked: Left Alt + Z outlines that fish or turns it off. Turn on Auto Outline Hooked Fish to outline every catch.
โ€ข Ping Duration sets how long pings stay (vanilla 5 s).
โ€ข In Settings > Controls, PingMark's keys now show the mod's name in grey, like PingMark ยท Ping.
Changes:
โ€ข Perception only senses what you can see: buried treasure and things behind walls or rock are left out (turn off Perception Line Of Sight for the old behavior).
โ€ข Perception has a new painted icon, on its status and its slot.
โ€ข The Perception slot lines up evenly with other mods' ability slots beside the Guardian Power, such as TempestRite's Rally Call, and the slots sit closer together: their names are narrower and shrink to fit. Turn off Show Ability Names to hide the names and bring the slots closer still.
โ€ข The Useful list no longer holds crafting station upgrades, statues, waymarkers or other decorations you can't use; crafting stations themselves stay, and statues and waymarkers are now Locations.
โ€ข Valuables no longer holds build pieces, or their copies in villages, that only give materials when broken, such as cauldrons; chests, pots, beehives, sap collectors and trophy stands stay, and village braziers and bonfires are now Useful.
Press Auto Sort in the collections editor to update a list you already have.
1.5.0 New:
โ€ข A Perception slot next to your Guardian Power shows when Perception is ready, with a countdown after use; the Perception Fatigue status icon is gone.
โ€ข Ping and Perception keys can be changed in the game's Settings > Controls.
โ€ข Perception now senses everything Ping Targets allows, such as gravestones, other players and, with Enable All Other, any object.
Changes:
โ€ข Perception lasts 15 s and is ready again 60 s after use, like a Guardian Power (new Fixed default; Relative mode is still available).
Important:
โ€ข Update together with your server.
โ€ข Existing configs keep their old Perception timings; set Perception Duration 15, Perception Fatigue Mode Fixed and Perception Fatigue Duration 60 for the new ones.
1.4.0 New:
โ€ข Perception becomes an ability with its own status, a colored burst and chime, and Perception Fatigue afterwards (Relative mode grows it with what you sensed).
โ€ข Perception ends early once everything found is looted or slain.
โ€ข Cut logs can be pinged.
Auto Sort:
โ€ข Traders and their outposts are always sorted.
โ€ข Wood-only objects are no longer valuables.
Changes:
โ€ข Z pings while moving; Perception only works standing still.
Fixes:
โ€ข Broken ore deposits keep their name and outline.
1.3.0 New:
โ€ข Perception (Left Shift + Z) outlines listed objects and drops around you, and can highlight nearby creatures.
โ€ข Birds can be pinged.
โ€ข The Prefab Collections menu can copy and import YAML and export a sorting report.
Auto Sort:
โ€ข Smarter with modded prefabs.
โ€ข Rocks, bushes and debris are left out.
Fixes:
โ€ข Dungeon walls and location geometry are no longer outlined.
1.2.0 New:
โ€ข Pings from others show names in your language and outline the exact object.
โ€ข Undo for removed sections.
โ€ข Tidier Configuration Manager settings.
Servers:
โ€ข Only admins can change collections, now kept in their own file.
โ€ข Ping spam is limited.
Fixes:
โ€ข Many stability, nameplate and shortcut fixes, plus better performance.
1.0.4 โ€ข Added more screenshots to the mod page.
1.0.3 โ€ข Larger screenshots on the mod page.
1.0.2 โ€ข Fixed screenshot sizes on the mod page.
1.0.1 โ€ข Fixed oversized screenshots on the mod page.
1.0.0 โ€ข Initial release: named Z pings with outlines, distances on world and map pings, creature and player highlights with nameplates, adjustable ping range, plain pings for players without the mod, and the admin Prefab Collections menu.