Mods / PlayerPositionTracker

Tags: #Utility
Author: SiiMeR
Side: Server
Created: Jun 15th at 12:27 PM
Last modified: Jun 23rd at 5:42 PM
Downloads: 69
Follow Unfollow 8

Recommended download (for Vintage Story 1.20.11 - 1.20.12):
playerpositiontracker_1.0.1.zip  1-click install


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

The positions are saved down into 

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

 

Example log:

{"Timestamp":"2025-06-15T12:11:18.3535143Z","PlayerUid":"g1U2RO0yyLzWikUwC6Jmuzw2","X":512010.5,"Y":3.0,"Z":511895.5}
{"Timestamp":"2025-06-15T12:11:18.3535143Z","PlayerUid":"SwRjbGbiKK0riqyUMMDu1upq","X":511957.8,"Y":3.0,"Z":511966.4}
{"Timestamp":"2025-06-15T12:11:20.3813508Z","PlayerUid":"g1U2RO0yyLzWikUwC6Jmuzw2","X":512010.5,"Y":3.0,"Z":511895.5}
{"Timestamp":"2025-06-15T12:11:20.3813508Z","PlayerUid":"SwRjbGbiKK0riqyUMMDu1upq","X":511957.8,"Y":3.0,"Z":511966.4}
{"Timestamp":"2025-06-15T12:11:22.4112876Z","PlayerUid":"g1U2RO0yyLzWikUwC6Jmuzw2","X":512010.5,"Y":3.0,"Z":511895.5}
{"Timestamp":"2025-06-15T12:11:22.4112876Z","PlayerUid":"SwRjbGbiKK0riqyUMMDu1upq","X":511957.8,"Y":3.0,"Z":511966.4}
{"Timestamp":"2025-06-15T12:11:24.4412952Z","PlayerUid":"g1U2RO0yyLzWikUwC6Jmuzw2","X":512010.5,"Y":3.0,"Z":511895.5}
{"Timestamp":"2025-06-15T12:11:24.4412952Z","PlayerUid":"SwRjbGbiKK0riqyUMMDu1upq","X":511957.8,"Y":3.0,"Z":511966.4}
{"Timestamp":"2025-06-15T12:11:26.4659233Z","PlayerUid":"g1U2RO0yyLzWikUwC6Jmuzw2","X":512010.5,"Y":3.0,"Z":511895.5}
{"Timestamp":"2025-06-15T12:11:26.4659233Z","PlayerUid":"SwRjbGbiKK0riqyUMMDu1upq","X":511957.8,"Y":3.0,"Z":511966.4}
{"Timestamp":"2025-06-15T12:11:28.4967594Z","PlayerUid":"g1U2RO0yyLzWikUwC6Jmuzw2","X":512010.5,"Y":3.0,"Z":511895.5}

 

If you logged down positions every 2 minutes (which is the default) for 50 players, you would generate about 4MB of logs per day, which is basically nothing. 

 

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

 

 

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 For Game version Downloads Release date Changelog Download 1-click mod install*
1.0.1
1.20.11 - 1.20.12
30 Jun 23rd at 5:42 PM playerpositiontracker_1.0.1.zip 1-click install

* Fix crash on server start when some players joining don't have a position (can't expect to be there these days :( )

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

First release


4 Comments (oldest first | newest first)

💬 SiiMeR , Jun 24th 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 at 12:52 AM

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

💬 Kiroshiko, Jun 15th at 3:17 PM

I saw what you did there

💬 Kiroshiko, Jun 15th at 12:46 PM

Literally 1984

 (edit comment delete)