Mods / PlayerPositionTracker

Tags:
Utility
Author:
SiiMeR
Side:
Server
Created:
Jun 15th 2025 at 12:27 PM
Last modified:
Feb 2nd at 9:58 PM
Downloads:
710
Follow Unfollow 32
Latest release (for Vintage Story 1.21.0-pre.1 - 1.21.6, outdated):
playerpositiontracker_2.4.0.zip  1-click install

This mod logs down the positions of all connected players once every few minutes (configurable) 

 

To view the history ingame, download the companion mod:  https://mods.vintagestory.at/show/mod/40909 

The position history can viewed by players with the admin role while in creative mode (the tab won't appear otherwise). 

All actions on this layer are audit logged so you can verify that it is being used purposefully. You can optionally configure the Discord Bot token and channel ID to send the audit logs to there as well. 

 

The positions are saved down into 

VintagestoryData\ModData\{YourSaveGameIdentifier}\playerpositiontracker\playerpositions-{yyyy-MM-dd}.json (one new file per day)

 

Example log:

[
    {
        "Timestamp": "2026-01-28T00:00:00.0000000Z",
        "PlayerUid": "g1U2RO0yyLzWikUwC6Jmuzw2",
        "X": 512035.8,
        "Y": 3.5,
        "Z": 512118.4,
        "Yaw": -1.0799642
    },
    {
        "Timestamp": "2026-01-28T00:01:00.0000000Z",
        "PlayerUid": "g1U2RO0yyLzWikUwC6Jmuzw2",
        "X": 512035.6,
        "Y": 3.5,
        "Z": 512118.5,
        "Yaw": 2.4399333
    },
    {
        "Timestamp": "2026-01-28T00:02:00.0000000Z",
        "PlayerUid": "g1U2RO0yyLzWikUwC6Jmuzw2",
        "X": 512037.8,
        "Y": 3.4,
        "Z": 512115.9,
        "Yaw": 1.6702892
    },
]

 

The configuration can be found at VintagestoryData\ModConfig\playerpositiontrackerconfig.json

Example config:

{
  "PositionUpdateIntervalSeconds": 60,
  "DiscordBotToken": "YOUR_BOT_TOKEN",
  "DiscordChannelId": "YOUR_CHANNEL_ID"
}

 

What is this mod useful for? 

  • Generating cool-looking graphs about player movement
  • Tracking down rulebreaks like robberies and grief
  • Extra info for general investigations

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
2.4.0 playerpositiontracker
1.21.0-pre.1 - 1.21.6
125 Feb 2nd at 9:58 PM playerpositiontracker_2.4.0.zip 1-click install

* Make this mod server-side only. New client side optional mod can be found at https://mods.vintagestory.at/show/mod/40909 

2.3.0 playerpositiontracker
1.21.0-pre.1 - 1.21.6
126 Jan 29th at 7:11 PM playerpositiontracker_2.3.0.zip 1-click install

* Do not recreate world map instance every time (hopefully solves the lag issues)

 

2.2.0 playerpositiontracker
1.21.1 - 1.21.6
52 Jan 29th at 1:24 PM playerpositiontracker_2.2.0.zip 1-click install
  • Better validation of data before logging it down
  • Map is now last in list
2.1.0 playerpositiontracker
1.21.1 - 1.21.6
90 Jan 28th at 3:05 PM playerpositiontracker_2.1.0.zip 1-click install
  • Added ability to post audit logs into a Discord channel
  • Center map on player selection
2.0.0 playerpositiontracker
1.21.1 - 1.21.6
18 Jan 28th at 2:51 PM playerpositiontracker_2.0.0.zip 1-click install
  • New feature: Map layer to query and view player position history
  • Feature is available to only players with role code "admin" and in Creative mode (the tab will not appear otherwise) 
  • The layer is disabled by default, and upon enabling it, a confirmation is shown if you really want to enable it.
  • Any usage of this layer or the GUI in it is audit logged 
  • The data is now stored in a JSON array
1.1.0 playerpositiontracker
102 Sep 9th 2025 at 11:29 AM playerpositiontracker_1.1.0.zip 1-click install

* Update to 1.21

1.0.1 playerpositiontracker
65 Aug 11th 2025 at 12:04 PM playerpositiontracker_1.0.1.zip 1-click install

* reupload

1.0.0 playerpositiontracker
1.20.11 - 1.20.12
84 Jun 15th 2025 at 12:28 PM playerpositiontracker_1.0.0.zip 1-click install

First release

15 Comments (oldest first | newest first) (threaded | flat)

Sir_Real, 4 days ago

1.22 Pretty pwease 👉👈 🥺

 

 

🪼

SiiMeR , Mar 8th at 10:11 PM

You have the serverside mod too? 

Ricksdetrix, Mar 8th at 3:25 PM

I can't see the ingame map with the companion mod, nor is there any log files generated, but the config was generated. Any idea what I could do? (1.21.6, only mod I can think that would conflict is prospect together but removing it didn't change it). It also didn't prompt me to download it when I joined the server, not sure what else might be useful

SiiMeR , Jan 31st at 12:26 PM

Is it okay on the latest version AgataPrisma

AgataPrisma, Jan 30th at 12:31 PM

SiiMeR No, I just noticed that you uploaded a new version, I will try and I'll reach here to tell if it was fixed

SiiMeR , Jan 29th at 1:46 PM

Yes, I am working on fixing it. Did you try out 2.2.0 out already? That has some fixes AgataPrisma

AgataPrisma, Jan 29th at 1:43 PM

Hi! this mod is super useful for admins! but sadly the latest version creates a lot of lag. Is this a known thing already?

Zebby, Sep 10th 2025 at 7:10 AM

For how much a few of my players get lost all the time...... This might be my new best friend. 

 

Vermit, Aug 13th 2025 at 7:34 PM

SiiMeR
Ye, not your fault :D Thx!  

SiiMeR , Aug 11th 2025 at 12:04 PM

Huh, interesting. Never seen this before

 

Reuploaded Vermit

Vermit, Aug 11th 2025 at 8:43 AM (modified Aug 11th 2025 at 9:04 AM)

SiiMeR Download link for 1.0.1 gives 404. :) 

SiiMeR , Jun 24th 2025 at 10:32 AM

This is simply for log purposes as of now. 

I am thinking about making this into a client-side mod for the admins that would overlay timestamps and positions on a map, but it is not a priority atm. 

BrokenCasanova

BrokenCasanova, Jun 24th 2025 at 12:52 AM

Are they displayed on the map, or is this simply for tracking them via log purposes?

Kiroshiko, Jun 15th 2025 at 3:17 PM

I saw what you did there

Kiroshiko, Jun 15th 2025 at 12:46 PM

Literally 1984