Ping Markers

Ping Markers

I just missed this feature so much I had to add it.

The goal is to improve cooperation and the sense of co-presence in the game with other players.

By default, if the player is in any group, it pings all players in their group. If they aren't in a group, it broadcasts to the whole server (intended for smaller servers).

How to Use

Press V to ping.

(This can be changed in Settings > Controls, just search for "ping").

Features & Roadmap

[x] Color pings based on players (dynamically via eye color or custom hex)
[x] Ping type based on what is pinged (entity, block...)
[x] Add player name to ping
[x] Ping sticks to entities (follows animals/players as they move)
[x] Config with mod properties
[x] Configurable max distance + allow global pings
[ ] Add map marker to pinged location

---

Configuration

Configuration files are generated after running the game with the mod installed. They can be found in your Vintage Story data folder:

%AppData%/VintagestoryData/ModConfig/

Server Configuration (PingMarkersConfig-Server.json)

Setting	Default	Description
EnableGlobalPings	false	If true, a player's pings are broadcast to all online players in the server (when they aren't in a group).

Client Configuration (PingMarkersConfig-Client.json)

Setting	Default	Description
MaxRenderDistanceMeters	10000	Maximum visual range from which ping markers can be seen.
MaxPingDistanceMeters	100	Maximum distance the player's view raycast can travel when creating new pings.
CooldownSeconds	1.0	Cooling delay needed between ping casts.
DistanceTextDigits	0	Number of decimal digits shown along with the distance text.
ShowDistance	true	Displays the numerical distance overlay above the markers.
ShowPlayerName	true	Shows the name of the player who cast the ping.
ShowPingedTargetName	false	Displays the specific name of the entity or block that was pinged.
ShowPingedTargetType	false	Displays the type of the target pinged (E for entity, B for block).
ColorByEyeColor	true	Dynamically colors the ping based on the player's custom eye color.
CustomPingColorHex	"#ffffff"	Custom hex color used if ColorByEyeColor is set to false.
StickToEntities	true	Pings attached to entities (like players or animals) will follow them as they move.