The tools rely on ImageMagick to perform some conversions on the image files. You only need to install this once and not worry about it again.

Scroll down to the “Windows Binary Release” section, then click on the download at the top of the list:


Run the installer and proceed through with the installation.

Make sure to leave every option on default. The "Add application directory to your system path"

This is a requirement for Unreal ReZen, the software used to package the mod files, to work. You also only need to install this once and not worry about it again.


The installer will start downloading automatically.

Once downloaded, run the installer and proceed with the installation as usual.

• Extract the folder “Addon Decal Slots Toolset” from this ZIP containing the tools somewhere on your computer that you can easily access.
  
• Open the “Game Path.ini” file in a text editor and add the path to the folder where Steam installed the game to into the “GameRoot” parameter. You can quickly find the path by right-clicking the game on Steam, selecting the “Manage” option, and then clicking on the “Browse local files” button.
  
• Copy the path to the folder opened in Windows Explorer and paste it into the previously mentioned field. In my case, it looks like this:

• Make sure there are no spaces after the “=” character or at the end of the path.
  
• Close the text editor. You should now be ready to set up your own images.

Warning: Do not touch anything in the “Core” folder or the “Main.py” script to ensure the tools don’t break.

Open the toolset folder.

The “Decals” folder handles the vinyls you can apply to the car’s body, while the “Stickers” folder handles the stickers you can apply to pre-determined slots on the windows.

The number of added decal slots you have at your disposal is 1000 for decals and 100 for stickers. The 1000 decal slots are split into 10 categories inside the livery editor, with 100 each.

The image formats the script handles best are: PNG, TGA, WEB, BMP, JPEG, and DDS.

To import an image into a decal slot, simply move it inside the “Decals” folder and name it “Tvi_ModsCustom” followed by a number corresponding to the slot you wanna import over, starting from 1.

For example, if I wanted to import an image into the 3rd slot of the 2nd category, I would name it Tvi_ModsCustom203; If I want to import over the 3rd decal of the 1st category, it would be Tvi_ModsCustom3, and so on.

Do not include any leading zeroes (Ex: Tvi_ModsCustom001) as the script will not handle those.

To be clear, the count starts at 1 for the “ADDON 1” category in-game, not 101, which would be “ADDON 2.”

The process for window stickers is almost the same.

Move your image inside the “Stickers” folder and name it “Tst_ModsCustom” followed by a number corresponding to the desired slot. For example, if I wanted to import an image into the 39th slot, I would name it Tst_ModsCustom39.

The only detail to watch out for with window stickers specifically is that these need to be in an aspect ratio of either 1:1 or 4:1; otherwise, they will be stretched. The script will automatically handle this as long as your image isn’t already at a resolution that is a power of two.

Window stickers that use a ratio of 1:1 will be scaled smaller than 4:1 ones, which is something you can notice when comparing the vanilla rival emblems stickers with the brand stickers, so take that into account when making your own.

Once that process is done, you can run the “Import Decals & Stickers” batch file located in the main folder for the toolset. Just run it normally; do not run it as administrator. Once the batch finishes its job and closes automatically, you can boot the game, and your decals will be available for use on the respective slots you imported over.


There is no need to worry about your image’s dimensions unless you have something specific in mind. The script will automatically extend the image to the nearest power of two, so the texture is valid, and generate a thumbnail for it.

If you wish to set up a custom thumbnail for your decal, you can create an image that is exactly 400x256 pixels in dimension and move it to the folder with your decal, then rename it “Tth_vi_ModsCustom” followed by the number corresponding to the same slot for the main decal texture.

The process is the same for window sticker thumbnails.

Just rename the image to “Tth_st_ModsCustom” followed by the slot’s number instead.
If the given thumbnail is not in the right dimensions, the script will automatically resize it to 400x256, which will cause stretching.

Feel free to reach out to me on the Tokyo Xtreme Racer Modding Discord server or in the guide's comments in case you’re having any trouble with the tools.

Join the server and find the thread for the mod in the #community-releases channel: