Making CTGP‐7 Work

Tutorial

For mario kart fans, Mario Kart 7 in 3d on a VR headset is the crowning gem of CitraVR. Doubly so with CTGP-7.

Below is how to get it working, albeit with an older version of ctgp (< v1.5, which requires code changes and recompiling of CitraVR)

Prerequisites

• Mario Kart 7 Game (.cia/.3ds/.cci/.cxi)
• Mario Kart 7 v1.2 update (.cia/.3ds/.cci/.cxi)
• Ability to extract the game and update files (lime3ds/citra, 3dstool, etc.)
• Version of CTGP-7 < v1.5 with the citra specific loader app and 3gx plugin!!! The ones that typically come with available archived citravr versions require a 3ds and will crash citra/citraVR. The only version of this I have found is 1.4.9, and requires you to download both v1.3.14 and the v1.4.9 Update
• Sideloading/adb (obviously)

Steps

1. If citraVR didn't have the cia install bug, we would just install the base game and update file (assuming they are decrypted - citra/citraVR/lime3ds cannot use encrypted .cia's) - but alas. If your copies of the game and update are encrypted, you need to decrypt them first. Then install both the game and the update using citra/lime3ds or extract them manually.
2. Copy the extracted files from the sdmc folder in the citra/lime3ds install folder to the sdmc folder in your citravr install folder on the headset (using sideloader / adb)
3. Extract the CTGP-7 folder from the base v1.3.14 7z file to a temporary location. Then copy/extract the files from the v1.4.9 update archive in the "CTGP-7updates-1.4.9/updates/data/" path into that same CTGP-7 folder at the temporary location - overwriting the existing files with the updated ones. Then copy/extract the files from the update archive path "CTGP-7updates-1.4.9/updates/dataCitra/" to that same CTGP-7 folder at the temporary location, again overwriting the files (which copies the citra specific/compatible loader app, 3gx plugin, and ghosts.bin).
4. Sideload/adb/copy the tooInstall.3dsx file from the cia folder in the CTGP-7 folder at the temporary location from the previous step to the location where you keep citraVR games on the headset. You may want to rename it from "toolInstall.3dsx" to something more accurate - like "ctgp-7 v1.4.9 loader.3dsx".
5. Sideload/adb/copy the entire CTGP-7 folder from the temporary location to the sdmc folder in the citraVR install folder on the headset.
6. Load citra, go into settings and make sure that the 3gx plugins setting is enabled.
7. Run citraVR and load the tooInstall.3dsx (or whatever you named it to) to load ctgp-7 and enjoy!

Notes/Known Issues

1. Sometimes citraVR will crash when you launch ctgp from the loader app. This seems random; just keep trying until it works. If it never works you have done something wrong in the steps above or perhaps there is something wrong with the game and/or update file you are using. I have only tested this on a Quest2 on OS v64 - so there may be other potential problems with other headsets and OS versions too...
2. MK7 only runs with hardware shaders enabled on v0.3.2 of citravr. This is a known issue with citravr. See more details here, including a copy of v0.3.2 that can be installed simultaneously with the latest version.
3. The language set in the "hacks" menu in ctgp-7 (accessed from the main game menu screen by pressing start) is not set to english - likely deleting the savedata in the ctgp-7 folder will remedy this, but i clicked around until i found the language select screen and changed it to english.