PyMedal is a lightweight Openplanet plugin for Trackmania that automatically tracks players' performance on every map. It records personal best times, medal achievements (Bronze, Silver, Gold, Author), and key map metadata like the TMX ID.

Each player's data is stored in a separate .json file under /OpenplanetNext/PluginStorage/pymedal/players/, named after their in-game nickname. The main player (usually the streamer) also writes to a global mapinfo.json file.

All JSON files contain:

pb_time: best time in mm:ss.mmm format

pb_medal: the best medal reached (0–4)

current_time: most recent finish time

current_medal: current medal rating

new_medal: true if a better medal was reached

new_time: true if a new personal best was achieved

tmx_id: Trackmania Exchange ID of the map

author_time, gold_time, etc.: map medal reference times

Output Example (JSON) /players/SpeedDevil.json

{ "uid": "ABC123", "tmx_id": "98765", "name": "SuperSpeed Track", "author": "TrackMaker", "pb_time": "00:47.293", "pb_medal": 3, "current_time": "00:47.293", "current_medal": 3, "new_time": true, "new_medal": true, "author_time": "00:42.000", "gold_time": "00:48.000", "silver_time": "00:55.000", "bronze_time": "01:10.000" }

Note: This plugin currently requires Streamer.bot to utilize the JSON data for chat interactions or overlay logic. A standalone .exe is being developed to support non-StreamerBot users in the future.

For help, questions, or updates, visit https://twitch.tv/godis3mpty.