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.
You are viewing a potentially older version of this package.
View all versions.
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 | 3 weeks ago |
| Version | 1.4.0 |
| Download link | JoksterCube-PingMark-1.4.0.zip |
| Downloads | 42 |
| Dependency string | JoksterCube-PingMark-1.4.0 |
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.2351README
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
See what matters at a glance. Live distances, item names and creature highlights.
Choose what your party can mark. Objects and locations are sorted into searchable, color-coded collections.
๐งญ Features
- ๐ 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.
- Track creatures: highlight a mob with a nameplate and distance that follow it, colored red (hostile) or green (friendly).
- ๐ฎ Perception: stand still and press Left Shift + Z to outline listed objects and dropped items around you for a few seconds, handy for coins and gems in dark dungeons. A colored burst marks the moment, and nearby PingMark players see it and the outlines too. Perception Fatigue follows: the more you sensed, the longer it lasts, and it starts early once everything you found is looted or slain.
- Sense creatures: Perception also highlights every hostile and friendly creature around you, beyond the usual highlight limit (turn off Perceive Creatures to sense only objects).
- Mark teammates: optionally highlight players instead of the spot they stood on (off by default).
- Your rules: pick which objects count as Valuables, Locations or Useful, and customize colors, labels, shortcuts and range.
๐ฎ Controls
| Shortcut | Action |
|---|---|
| Z | Highlight the creature you aim at, or ping the spot/object. |
| Left Shift + Z | Perception (standing still): outline listed objects, drops and creatures near you (nearby PingMark players see them too). |
| Right Ctrl + P | Turn PingMark on or off. |
| Right Ctrl + Right Shift + P | Open the Prefab Collections menu (admins only on servers). |
Shortcuts can be changed 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.
- Find an object's ID: turn on Debug Ping Names (1 - General, shown with Advanced settings in Configuration Manager) and press Z on it; its IDs appear in the top-left corner.
- Auto Sort rebuilds the default Valuables, Locations and Useful sections, sorting modded objects too: traders and trader outposts, cut logs and deposits are listed, while rocks, roots and props that only drop wood or stone are left out. Undo reverts changes, Apply saves them. Copy YAML copies every section, including unapplied changes; Import YAML replaces all sections from the clipboard. A section's Import button replaces just that section from a copied CSV list or YAML section. Export Report writes every prefab's detected kinds and auto sort result to
BepInEx/config/JoksterCube.PingMark.AutoSortReport.csv, useful for checking modded prefabs.
๐ 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.ymland synced to all players.
โ๏ธ Installation
Install with a mod manager (r2modman, Thunderstore App), or manually:
- Install BepInExPack Valheim.
- Extract PingMark into
BepInEx/plugins. - 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. |
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. |
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 Gravestones | On | โ | Name and outline gravestones. |
| Enable Other Players | Off | โ | Highlight players instead of pinging their position. |
| Enable All Other | Off | โ | Name and outline anything not in a collection. |
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 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. | |
| 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 | Outline listed objects and drops near you. Only while standing still (no other key held). | |
| Enable Prefab Editor Shortcut โ๏ธ | On | Turn the menu shortcut on or off. |
10 - Perception
| Setting | Default | Synced | What it does |
|---|---|---|---|
| Enable Perception | On | โ | Allow the Perception Shortcut. |
| Perception Range | 10 m | โ | How far around you Perception looks. |
| Perception Duration | 8 s | โ | How long Perception keeps things outlined (the Perception status). Fatigue starts after it. |
| 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 | 5 s | โ | Cooldown once Perception ends, shown as a status effect; the base cost in Relative mode. 0 = none. |
| Perception Fatigue Mode | Relative | โ | Fixed: always the duration above. Relative: the duration plus a cost for everything sensed. |
| 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. |
| 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. |
๐ฌ Feedback & Support
Report bugs or suggest improvements on GitHub.
Author: JoksterCube
Version: 1.4.0
License: MIT
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. |
