Ping Markers

<h2 data-path-to-node="2">Ping Markers</h2> <p data-path-to-node="3">I just missed this feature so much I had to add it.</p> <p data-path-to-node="4">The goal is to improve cooperation and the sense of co-presence in the game with other players.</p> <p data-path-to-node="4">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).</p> <h3 data-path-to-node="5">How to Use</h3> <p data-path-to-node="6">Press <strong data-path-to-node="6" data-index-in-node="6">V</strong> to ping.</p> <p data-path-to-node="6"><em data-path-to-node="6" data-index-in-node="17">(This can be changed in Settings &gt; Controls, just search for "ping").</em></p> <h3 data-path-to-node="7">Features &amp; Roadmap</h3> <p data-path-to-node="8,0,0">[x] Color pings based on players (dynamically via eye color or custom hex)<br />[x] Ping type based on what is pinged (entity, block...)<br />[x] Add player name to ping<br />[x] Ping sticks to entities (follows animals/players as they move)<br />[x] Config with mod properties<br />[x] Configurable max distance + allow global pings<br />[ ] Add map marker to pinged location</p> <hr data-path-to-node="9" /> <h3 data-path-to-node="10">Configuration</h3> <p data-path-to-node="11">Configuration files are generated after running the game with the mod installed. They can be found in your Vintage Story data folder:</p> <p data-path-to-node="11"><code data-path-to-node="11" data-index-in-node="134">%AppData%/VintagestoryData/ModConfig/</code></p> <h4 data-path-to-node="12">Server Configuration (<code data-path-to-node="12" data-index-in-node="22">PingMarkersConfig-Server.json</code>)</h4> <table style="width: 975px;" data-path-to-node="13"> <thead> <tr> <td style="width: 179.212px;"><strong>Setting</strong></td> <td style="width: 72.0875px;"><strong>Default</strong></td> <td style="width: 722.9px;"><strong>Description</strong></td> </tr> </thead> <tbody> <tr> <td style="width: 179.212px;"><span data-path-to-node="13,1,0,0"><code data-path-to-node="13,1,0,0" data-index-in-node="0">EnableGlobalPings</code></span></td> <td style="width: 72.0875px;"><span data-path-to-node="13,1,1,0"><code data-path-to-node="13,1,1,0" data-index-in-node="0">false</code></span></td> <td style="width: 722.9px;"><span data-path-to-node="13,1,2,0">If <code data-path-to-node="13,1,2,0" data-index-in-node="3">true</code>, a player's pings are broadcast to all online players in the server (when they aren't in a group).</span></td> </tr> </tbody> </table> <h4 data-path-to-node="14">Client Configuration (<code data-path-to-node="14" data-index-in-node="22">PingMarkersConfig-Client.json</code>)</h4> <table style="width: 972px;" data-path-to-node="15"> <thead> <tr> <td style="width: 233.975px;"><strong>Setting</strong></td> <td style="width: 100.975px;"><strong>Default</strong></td> <td style="width: 636.25px;"><strong>Description</strong></td> </tr> </thead> <tbody> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,1,0,0"><code data-path-to-node="15,1,0,0" data-index-in-node="0">MaxRenderDistanceMeters</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,1,1,0"><code data-path-to-node="15,1,1,0" data-index-in-node="0">10000</code></span></td> <td style="width: 636.25px;"><span data-path-to-node="15,1,2,0">Maximum visual range from which ping markers can be seen.</span></td> </tr> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,2,0,0"><code data-path-to-node="15,2,0,0" data-index-in-node="0">MaxPingDistanceMeters</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,2,1,0"><code data-path-to-node="15,2,1,0" data-index-in-node="0">100</code></span></td> <td style="width: 636.25px;"><span data-path-to-node="15,2,2,0">Maximum distance the player's view raycast can travel when creating new pings.</span></td> </tr> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,3,0,0"><code data-path-to-node="15,3,0,0" data-index-in-node="0">CooldownSeconds</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,3,1,0"><code data-path-to-node="15,3,1,0" data-index-in-node="0">1.0</code></span></td> <td style="width: 636.25px;"><span data-path-to-node="15,3,2,0">Cooling delay needed between ping casts.</span></td> </tr> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,4,0,0"><code data-path-to-node="15,4,0,0" data-index-in-node="0">DistanceTextDigits</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,4,1,0"><code data-path-to-node="15,4,1,0" data-index-in-node="0">0</code></span></td> <td style="width: 636.25px;"><span data-path-to-node="15,4,2,0">Number of decimal digits shown along with the distance text.</span></td> </tr> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,5,0,0"><code data-path-to-node="15,5,0,0" data-index-in-node="0">ShowDistance</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,5,1,0"><code data-path-to-node="15,5,1,0" data-index-in-node="0">true</code></span></td> <td style="width: 636.25px;"><span data-path-to-node="15,5,2,0">Displays the numerical distance overlay above the markers.</span></td> </tr> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,6,0,0"><code data-path-to-node="15,6,0,0" data-index-in-node="0">ShowPlayerName</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,6,1,0"><code data-path-to-node="15,6,1,0" data-index-in-node="0">true</code></span></td> <td style="width: 636.25px;"><span data-path-to-node="15,6,2,0">Shows the name of the player who cast the ping.</span></td> </tr> <tr> <td style="width: 233.975px;"><span data-path-to-node="15,7,0,0"><code data-path-to-node="15,7,0,0" data-index-in-node="0">ShowPingedTargetName</code></span></td> <td style="width: 100.975px;"><span data-path-to-node="15,7,1,0"><code data-path-to-node="15,7,1,0" data-index-in-nod