This document describes how you can create your own medals to display in game.
For the sake of ease, copy the "DuckTimes.csv" file under "/Duck Medals/Riolu/"
as it has each map UID, game, envi, map name and time.

# ---------------------------------- Overview ---------------------------------- #
The names of each file/image and the folder names are specific and need to be
followed. The only exception is the main folder within "/Duck Medals/[name]/".
Whatever name is used for this folder will be the name of the ducker used
in game.

Inside you will need a folder named Images (/Duck Medals/[name]/Images/) where
"DuckMedalTurbo.png" goes. Next, you need the replay data
which needs to be named DuckTimes.csv such as "/Duck Medals/[name]/DuckTimes.csv".
Lastly, you need the medal settings which contain what colour the map text will be.
This file is named MedalSettings.json and is put in
"/Duck Medals/[name]/MedalSettings.json".



# -------------------------------- Medal Images -------------------------------- #
For the images, realistically you can use any image size you like, but to keep
the same shape as the default medals in game try to use a ratio (1:1, 2:1 etc)
of the original image sizes: 
DuckMedalTurbo.png: 512x512 

IMPORTANT: The images need to be transparent (png) and you cannot have any pixels
on the bounding boarder of the images all around. If any pixel is on the outside
pixels that colour will be extended to the edge of the box drawn in game.



# ------------------------------ Duck Medal Data ------------------------------ #
As stated above, copy "/Duck Medals/Riolu/DuckTimes.csv" as a template as it
contains all map entries. You do not need to keep or fill in all map entries. Just 
keep the map lines you want medals for and the headers.

Only Map UID and Race Time columns are inputted from the file, the other fields
are for you to be able to tell which UID is which map. For Race Time, keep the time
in MS, for example, 2:10.010 = 120010 (2 x 60000 sec + 10 ms).

If the file is open in Excel for example, you need to close before reading in game
as you cannot read while Excel is reading and the medal won't be added.

Basically overall, just remove the rows you do not want map entries for and only edit
the Race Time column to the updated values.



# ---------------------------- Duck Medal Settings ---------------------------- #
Inside "/Duck Medals/[name]/MedalSettings.json" you can define the colour you wish
the in game map numbers to change upon duck to. You can set to any colour but ideally
it should be similar to the colour of the duck image.

Select a colour using ManiaPlanet colour formatting RGB ranging from 0-F. For example,
red is "F00" and you can mix colours to get a combined colour such as purple which
would be "80F".

Populating the array with valid values of either: [White, Green, Blue, Red, Black], will
add a shadow to map names if ducked. Useful for when colours blend into the background.



# ------------------------------- File Structure ------------------------------ #
Files inside your ducker folder should consist of:
Duck Medals/[name]/Images/DuckMedalTurbo.png
Duck Medals/[name]/DuckTimes.csv
Duck Medals/[name]/MedalSettings.json