**DolphinIOS: Adding AR Codes (as of Version 2.2.0 (JB: 103 / NJB: 105) and Patreon Version 3.0.0 (89)**
Guide written by JackFusion★#9669
This Pastebin will describe what is needed and how to add Action Replay codes to DolphinIOS. This guide will be a lot more in-depth compared to that of the pinned message in the #support. For this example, I will be using Mario Party 7 (NTSC-U). For those who may need visualisations, I will have some linked at the correct spot with images hosted on Imgur. If you notice part of this guide is incorrect, needs rewording or a complete rework, please notify me directly on Discord. This is my first ever fully written and detailed guide, so it may be confusing. If you need anything clarified, feel free to ask me to rework or reword any portion of this personally.
NOTE: AS OF THE CREATION OF THIS TUTORIAL GECKO CODES ARE **NOT** FUNCTIONAL AND WILL **NOT** WORK. PLEASE BE CAREFUL WHEN ASKING FOR SUPPORT AS YOU MAY BE USING A GECKO CODE RATHER THAN AN AR CODE.
- Oats and Simon for porting Dolphin to iOS and generally being good friends
- Those who contribute to the development via commits to the source code to make it even greater
- Anyone who helps people in #support to the best of their ability
DiOS Website: https://dolphinios.oatmealdome.me/
Developers' Discord: https://discord.gg/rdx6Bt8
Developers' Patreon: https://www.patreon.com/oatmealdome
The first thing you need to begin adding your cheats is the ID of your game. Depending on your version, there are two ways to find this.
Patreon Version 3.0.0 (89): Simply hold the cover art of the game of your choice until it gives you the option to delete it from your menu. Above the delete button, the game title and ID will be shown. (Seen here: https://imgur.com/a/xjLkZKa)
Version 2.2.0 (JB: 103 / NJB: 105): As the above option is only for Patreon testing currently, your best bet is to visit https://wiki.dolphin-emu.org/ and search your game in the search bar. Below the cover art for the game of your choice, there will be sections such as "Developer(s)", "Publisher(s)", etc. What we're looking for is "GameIDs", which should be listed below "Compatiblity". (Seen here: https://imgur.com/a/XEQ8i9V) What you will notice is that there are multiple IDs here. To find out which ID is correct for your dumped copy, the most typical difference is in the last letter before the number(s) at the end. For PAL, look out for a P (Example: RMCP01); for NTSC-J, look out for a J (Example: RMCJ01); for NTSC-U, look out for an E (Example: RMCE01). Some games may not follow this rule and make it a bit harder to identify the correct region, so it may be worth a Google search to double check on this.
Keep track of this ID, as we'll be using this to create an INI file.
Creating the .INI file
With the game ID in hand, we can now create an .INI file, which will hold our codes. Depending on if you are jailbroken or not, the way to do this will vary. However, the name of the file will the the game ID you just found. In my example using Mario Party 7, the file will be named **GP7E01.ini**.
For Jailbroken users: With Filza, you can navigate to **/var/mobile/Documents/DolphiniOS/GameSettings** and create a file there.
For Non-Jailbroken users: You can make the file on your PC and move it over to Files.app > On my iPhone / iPad > DolphinIOS > GameSettings .
Inside of this INI file will contain our codes. The next section will show the layout.
Gettings Codes + The General Format & Enabling Cheats
If you don't already have your codes, then my best advice for you is to give them a Google search. Something like the game ID followed by "ar codes". Note: Codes on https://wiki.dolphin-emu.org/ are GECKO CODES, NOT ACTION REPLAY CODES. THEY WILL NOT WORK. Also make sure that the codes you are getting are in fact Action Replay and not Gecko, as sometimes the two look alike.
There are two formats that I've seen work. Let's call them type one and type two for convenience sake.
Type One: XXXXXXXX YYYYYYYY
Type Two: XXXX-YYYY-ZZZZ
I've have some issues getting type two to work, so, if you can, try your best to find codes of type one.
Inside of our newly created INI file, we will have to make the format ourselves. To begin, let's start off with the proper listing of our code(s).
We'll begin with the header of [ActionReplay]; below that we will name the code, and then paste the code under. Here's a basic visual of what that should look like.
$Your Code Name
the code goes here
Cool, now the code is in. However, we're not finished just yet. We need to enable the code. This is done by creating a new header below the last code put in called [ActionReplay_Enabled]. Below that, we will put the CODE NAME ONLY in **exactly as it was written.** Only code names listed here will be active. Here is basic visualsation:
$Your Code Name
the code goes here
$Your Code Here
If this isn't making any sense, here are examples for both "type one" and "type two" AR codes: https://imgur.com/a/7PMgMV4
Once you got that, save the INI. If you haven't moved it from your PC to GameSettings, you should do that too.
What you should have now is:
- an INI file named your game ID located in GameSettings
- the correct format for AR codes
- code titles set under enabled so they are active in game
The last thing to do is to enable cheats in DolphinIOS itself, otherwise, despite doing everything correctly, the codes will not activate. You can do this by going to Settings > Config > General > Enable Cheats and turning that to ON.
Hopefully, should you have done everything correctly, the AR codes should work when you load your game and do whatever the code has you to do. If it does, then congrats! You've now added AR codes to DolphinIOS!
If you are still struggling: Here is a video of me doing it using my example of Mario Party 7 from scratch: https://www.youtube.com/watch?v=zfLXYWBQ6nk
If you are STILL struggling and don't know where you went wrong, you can ask on the Discord linked at the top of this pastebin.
Thank you for giving this guide a read! If you have any suggestions on what other guides to make, let me know, and I'll definitely consider it. Have fun!