Required tools:#
Tools/programs you need before we continue further in the tutorial:
| Tools/programs |
|---|
| Mktoolbox |
| Nitropaint |
| Wine |
| Steam |
| g3dcvtr |
| Blender |
| NNS plugins |
| melonds |
Note: I will not be teaching you how to acquire or teach you the basics of using your Linux distribution, that is up to the user to figure out to use it or how to install blender, wine, Melonds or steam as the installation can completely vary from the distribution you are using, i simply will be teaching you how to generally use these programs within the environment. I will also not provide on how to acquire a MKDS rom, it is up to you to dump the game or find it. I will also assume you already have the NNS plugins installed on blender and have some starting experience with it.
Getting started:#
With all tools installed, what first you will want to do is launch steam and enter in your steam account, if you don't then create your steam account. After that is done you will be greeted to the main screen. What you will want to do is go to the settings located here:
 |
You the will be greeted with this window, go to beta participation, for you it would be set to none, change it to Steam beta update:
 |
Afterwards just let steam restart and let it update to steam beta. Once you are back to the main screen again go to settings again and click on steam play:
 |
After you are there, Enable steam play for all other titles and set it to proton experimental.
Now that you have access to steam proton and will be able to run Mktoolbox and Nitropaint. But first we will need to add Mktoolbox and Nitropaint as non-steam games in our library. So go to the library tab in steam and click on Add A Game, then select Add a non-steam game:
 |
you will be greeted with a window to select any non steam game you have available, click on browse:
 |
Note: Remember to have Mktoolbox and Nitropaint downloaded and extracted.
Now simply select the mktoolbox executable and click open:
 |
Now that mktoolbox is selected, simply do the same thing with nitropaint. After that is done, simply click on add selected program:
 |
Now that we have the programs added to the steam library, right click on the program and select properties:
 |
You will be greeted with a new window, select compatibility and after that click on Force the use of specific steam play compatibility tool:
 |
Note: you must do this with both mktoolbox and nitropaint.
After that is done, you are finally done and can launch mktoolbox and nitropaint!!!
Extracting the MKDS file system:#
The goal here now is to extract the entire Mario kart DS file system and have every file accessible to us to mess with. First lets launch Mktoolbox in steam. We should be greeted with something like this:
 |
In this window all you have to do is simply search for your Mario kart ds rom and open it. After you did that you should be greeted with the main program. Now what we will want to do is simply hover to file and select export > export project:
 |
After that then simply select the folder you wish to save the project file on:
 |
You will have a prompt asking you to unpack the files, select yes:
 |
After you are done with that simply go to the directory you have your files saved:
 |
Now that is done you have access to the entire mkds file system!!!
Now you can open the .nkproj file in mktoolbox and edit the game from the extracted files:
 |
When you are ever done editing anything in the game, all you will have to do is simply export as NDS and save it on the directory of your choice:
 |
With this we conclude this and now on to the next section...
Importing your custom track/character/kart:#
Note: You must have blender and the NNS plugins installed on the program already. You also have to have wine installed, also have g3dcvtr downloaded and extracted before we continue.
Let us start in Blender, assuming you already have your custom model made. all you would have to do now is export the custom model as imd and if it uses animations then enable .ica or .ita:
 |
NOTE:This part is crucial, save your imd, ica or ita in g3dcvtr's directory (the location where you have g3dcvtr on your computer.), you will need them there for the next crucial step.
 |
Now that you have the files saved on g3dcvtrs directory, open the terminal on g3dcvtrs directory and type the following command:
| wine cmd |
now you should be in the windows command line, now type the following commands following your specific needs:
-For exporting the nsbmd and nsbtx type:
| start mdltex.bat (name of your imd file) |
-For exporting only the nsbmd
| start g3dcvtr.exe (name of your imd file) |
-For exporting only the nsbca
| start g3dcvtr.exe (name of your ica file) |
-For exporting only the nsbta
| start g3dcvtr.exe (name of your ita file) |
-For exporting only the nsbtp
| start g3dcvtr.exe (name of your itp file) |
After they are done executing the exported files should be in your directory like this:
 |
Now simply replace the files you want to replace in the game, i decided to replace Mario's in game model and animations. Remember to rename the files exactly to how it was named before:
 |
After that is done we must launch Mktoolbox and check if our custom model is there and we you can begin editing the course or attributes of your character or kart. Once you are done editing, then simply export as NDS our project.
Note: If you don't know how to export as NDS go back to "Extracting file system" part of the tutorial.
Finally, all that is left to do is simply launch the custom rom, in this case i will be using melonds:
 |
Bingo it imported successfully!
If you run into any issue with g3dcvtr as in it spits out an error regarding any of your files you wish to convert, you can come to the mkds modding server on Discord for further assistance. Also be sure you are using the latest version of wine or at the very least wine 5.0.
How to convert textures with Nitropaint:#
Note: This is assuming if you already have a texture made and simply all you need to do is convert it to the nitro tga format.
First lets launch Nitropaint (Note: you must have already prepared Nitropaint to launch with proton or you can also launch Nitropaint with wine as its fully compatible, be sure that wine is on its latest version if you desire to launch it with wine.):
 |
now that you are in the main program, you can simply drag and drop the texture into the program and select create texture. You can also manually open the texture and look for it in your directory:
-Drag and drop
 |
-Opening the image manually
 |
After you have that you should be met with something like this:
 |
click on convert to.. and you should have this window pop up:
 |
select the format you want to convert your texture with:
-Plt4 -tex 4x4 -plt16 -plt256 -a3i5 -a5i3 -direct
after you have selected the format and messed with its quality settings if you so desire to. Now click on convert and your texture should be successfully converted. Now all that is left is to save the image. click on file then click on save, then simply choose where you want to save your image:
 |
After you saved your image you should have a fully converted Nitro tga texture, to confirm it is, simply drag and drop the image in nitropaint and it should identify the image with the format you converted it with.
Conclusion:#
You have reached the end of this tutorial on how to use mkds modding tools on your linux distribution. If you ever run into any issues along the way, please contact us in the Mario kart ds modding server for further assistance. I hope this tutorial has served you very well and happy modding.
-Xgone
