FendragonPlayerTimeReward

<h1 style="text-align: center;" data-start="196" data-end="336"><strong data-start="196" data-end="232"><span style="color: #e67e23;">WIP (Work In Progress)</span></strong></h1> <pre style="text-align: center;">&nbsp;</pre> <pre style="text-align: left;">&nbsp;</pre> <p style="text-align: center;"><img style="display: block; margin-left: auto; margin-right: auto;" src="https://donatik.io/logo.svg" alt="[DonatikIO]" width="252" height="56" /><br /><br /><span style="color: #8e44ad; font-family: terminal, monaco, monospace;"><strong><span style="font-size: 18pt;">Fendragon Player Time Reward (FPTR)</span></strong></span><br /><br /><br /><span style="font-family: terminal, monaco, monospace; font-size: 14pt;"><strong>-ENG-</strong></span><br /><strong><span style="font-family: terminal, monaco, monospace;">Is a server&ndash;client mod for Vintage Story that rewards players for time spent playing on the server.</span></strong><br /><strong><span style="font-family: terminal, monaco, monospace;">The mod tracks playtime per day, grants configurable rewards, and have visual + audio feedback when a reward is received.</span></strong><br /><br /><strong><span style="color: #2b3e50;"><span style="color: #000000;"><span style="color: #646972;"><span style="font-family: terminal, monaco, monospace;"><em><span style="color: #34495e;">Fixes, edits, development and testing are done specifically for/on the server:<br /></span></em></span><span style="color: #34495e; font-size: 18pt;"><a title="Discord" href="https://discord.gg/gexyPqdmkV"><span style="color: #9b59b6;"><span style="font-family: terminal, monaco, monospace;">Fendragon Story Tale</span></span></a></span></span></span></span></strong></p> <p style="text-align: center;"><strong><span style="color: #2b3e50;"><span style="color: #000000;"><span style="color: #646972;"><span style="color: #34495e; font-size: 18pt;"><span style="color: #9b59b6;"><span style="font-family: terminal, monaco, monospace;"><a title="Discord" href="https://discord.gg/gexyPqdmkV"><img src="https://i.imgur.com/hbs3hRb.png" alt="[Discord]" width="60" height="60" /></a><br /><br /></span></span></span></span></span></span></strong></p> <hr data-start="4435" data-end="4438" /> <div class="spoiler"> <div class="spoiler-toggle"><strong>-ENG-</strong></div> <div class="spoiler-text"> <h3 data-start="402" data-end="426">🔹 What the mod does 🧐</h3> <ul data-start="427" data-end="830"> <li data-start="427" data-end="501"> <p data-start="429" data-end="501">Tracks <strong data-start="436" data-end="456">real online time</strong> per player (only while the player is online)</p> </li> <li data-start="502" data-end="565"> <p data-start="504" data-end="565">Uses <strong data-start="509" data-end="536">Kyiv time (Europe/Kyiv)</strong> to separate playtime by days</p> </li> <li data-start="566" data-end="657"> <p data-start="568" data-end="657">Grants <strong data-start="575" data-end="599">configurable rewards</strong> at specific minute thresholds (e.g. 60, 120, 180 minutes)</p> </li> <li data-start="658" data-end="713"> <p data-start="660" data-end="713">Each reward is given <strong data-start="681" data-end="713">only once per player per day</strong></p> </li> <li data-start="714" data-end="785"> <p data-start="716" data-end="785">Automatically <strong data-start="730" data-end="758">creates daily save files</strong> and archives previous days</p> </li> <li data-start="786" data-end="830"> <p data-start="788" data-end="830">Fully safe for restarts and server crashes</p> </li> </ul> <h3 data-start="832" data-end="854">🔹 Server features 💽</h3> <ul data-start="855" data-end="1185"> <li data-start="855" data-end="909"> <p data-start="857" data-end="909">Server-only configuration (players cannot modify it)</p> </li> <li data-start="910" data-end="1027"> <p data-start="912" data-end="925">Configurable:</p> <ul data-start="928" data-end="1027"> <li data-start="928" data-end="956"> <p data-start="930" data-end="956">reward intervals and items</p> </li> <li data-start="959" data-end="981"> <p data-start="961" data-end="981">save/check intervals</p> </li> <li data-start="984" data-end="1027"> <p data-start="986" data-end="1027">Kyiv time source (local or internet time)</p> </li> </ul> </li> <li data-start="1028" data-end="1185"> <p data-start="1030" data-end="1045">Admin commands:</p> <ul data-start="1048" data-end="1185"> <li data-start="1048" data-end="1108"> <p data-start="1050" data-end="1108"><em><strong><span style="color: #d35400;"><code data-start="1050" data-end="1075">/fptr timeplayer &lt;name&gt;</code></span></strong></em> &ndash; view another player&rsquo;s playtime</p> </li> <li data-start="1111" data-end="1185"> <p data-start="1113" data-end="1185"><em><span style="color: #d35400;"><strong><code data-start="1113" data-end="1138">/fptrconfigserverrebuid</code></strong></span></em> &ndash; rebuild/update server config without restart</p> </li> </ul> </li> </ul> <h3 data-start="1187" data-end="1209">🔹 Client features 🤗</h3> <ul data-start="1210" data-end="1581"> <li data-start="1210" data-end="1374"> <p data-start="1212" data-end="1274">Client-side reward feedback (fully optional and configurable):</p> <ul data-start="1277" data-end="1374"> <li data-start="1277" data-end="1291"> <p data-start="1279" data-end="1291">on/off reward sound</p> </li> <li data-start="1294" data-end="1320"> <p data-start="1296" data-end="1320">on/off reward image</p> </li> <li data-start="1323" data-end="1374"> <p data-start="1325" data-end="1374">configurable location for image</p> </li> </ul> </li> <li data-start="1375" data-end="1420"> <p data-start="1377" data-end="1420">Each player has <strong data-start="1393" data-end="1420">their own client config</strong></p> </li> <li data-start="1421" data-end="1581"> <p data-start="1423" data-end="1439">Client commands:</p> <ul data-start="1442" data-end="1581"> <li data-start="1442" data-end="1488"> <p data-start="1444" data-end="1488"><em><code data-st