SilPho / medal-collection

Keep track of every Trackmania 2020 medal you've ever earned with this Openplanet plugin
GNU General Public License v3.0
0 stars 0 forks source link

Medal Collection

Keep track of every Trackmania 2020 medal you've ever earned with this Openplanet plugin.

Description

Are you a binger of bronze medals, securer of silver medals, gatherer of gold medals or hoarder of author medals? Now you can find out and show off.

After installing this plugin, it will check for every medal you've earned on every track you've ever played and display it proudly in a highly customisable medal window. Watch your collection grow in real-time or just let it run in the background.

Wondering which tracks you only managed to get bronze on? Click the button next to it and find out, with a quick link to play it straight away. This makes it really easy to find out which times you can improve on.

You can get the plugin to recheck all of your medals, but I only recommend doing this if you've played on other devices or had the plugin disabled for a while. This is because medals aren't always updated immediately, so your counts can seemingly go down if you recheck too soon after playing a map.

Known Issues

Royal Mode is not supported. You can't earn medals on a Royal map, so this isn't a big deal. Royal "training" maps work as normal. Stunt Mode should work fine though.

Settings

Window Options

Only show collection when Openplanet menu is visible

Show

Show collection while racing

Toggles whether the plugin window will be visible while you are driving. Make sure it's not positioned anywhere too distracting if this is turned on.

Show collection while in the main menu

Toggles whether the plugin window is visible in the main menu.

Display in horizontal mode

This is my preferred way of using the plugin. It fits neatly into the top centre of the screen and provides plenty of space for track names when using the randomiser buttons.

Column Options

Show collection title

Toggles the "[name] medal collection" title. You can turn this off if you want the plugin to take up less space.

Show medal colours

Toggles a small circle for each medal, in an appropriate colour.

Show medal names

Toggles the full name of the medals. You can hide these to save space or keep them visible to make things clearer.

Show \"Play Random Map\" buttons"

Clicking on one of these buttons will randomly select a map from that medal category and present you with a button that you can use to jump directly into that map. Very useful if you want to figure out which maps you only have a bronze medal on and want to improve. Note: This will require club access to let you download and play these maps.

Show cumulative totals

Since earning the gold medal, for instance, means you've obviously beaten the required time for silver and bronze medals, this option lets you count every medal in each of the lower tiers. This has the added benefit of showing you the total number of maps you've finished. The cumulative totals will appear alongside the per-medal counters, not instead of them.

Show percentages

Display the relative percentage of each medal alongside the number of medals in that tier.

Show cumulative percentages

Similar to cumulative totals, this will show the total percentage of each medal and all higher tiers. Since this would always display 100% for the "played" category, that gets hidden.

Show played but unfinished map count

Keep track of every map you've attempted but couldn't finish. Maybe you can finish them later. This is hidden by default, since there's nothing to be ashamed of if you can't finish difficult maps. Please note that Unfinished maps from before the plugin was installed won't be counted because there's no online history of unfinished maps that the plugin can check.

Advanced Options

Developer mode

Prints more lines to the Openplanet log to aid development and debugging.

Credits

Written by SilPho

Massive thanks to the Openplanet Discord server for support and troubleshooting.

Additional thanks:

A lot of inspiration and guidance was sourced from the following awesome plugins: