JackFusion

DolphinIOS AR Code Guide

May 11th, 2020
1,516
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
  1. **DolphinIOS: Adding AR Codes (as of Version 2.2.0 (JB: 103 / NJB: 105) and Patreon Version 3.0.0 (89)**
  2. Guide written by JackFusion★#9669
  3.  
  4. ===
  5. WELCOME
  6. ===
  7. 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.
  8.  
  9. 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.
  10.  
  11. Special Thanks:
  12. - Oats and Simon for porting Dolphin to iOS and generally being good friends
  13. - Those who contribute to the development via commits to the source code to make it even greater
  14. - Anyone who helps people in #support to the best of their ability
  15.  
  16. DiOS Website: https://dolphinios.oatmealdome.me/
  17. Developers' Discord: https://discord.gg/rdx6Bt8
  18. Developers' Patreon: https://www.patreon.com/oatmealdome
  19.  
  20. ===
  21. Getting Started:
  22. ===
  23. 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.
  24.  
  25. 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)
  26.  
  27. 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.
  28.  
  29. Keep track of this ID, as we'll be using this to create an INI file.
  30.  
  31. ===
  32. Creating the .INI file
  33. ===
  34. 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**.
  35.  
  36. For Jailbroken users: With Filza, you can navigate to **/var/mobile/Documents/DolphiniOS/GameSettings** and create a file there.
  37.  
  38. 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 .
  39.  
  40. Inside of this INI file will contain our codes. The next section will show the layout.
  41.  
  42. ===
  43. Gettings Codes + The General Format & Enabling Cheats
  44. ===
  45. 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.
  46.  
  47. There are two formats that I've seen work. Let's call them type one and type two for convenience sake.
  48. Type One: XXXXXXXX YYYYYYYY
  49. and
  50. Type Two: XXXX-YYYY-ZZZZ
  51.  
  52. I've have some issues getting type two to work, so, if you can, try your best to find codes of type one.
  53.  
  54. 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).
  55.  
  56. 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.
  57.  
  58. //////////
  59. [ActionReplay]
  60. $Your Code Name
  61. the code goes here
  62. //////////
  63.  
  64. 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:
  65.  
  66. //////////
  67. [ActionReplay]
  68. $Your Code Name
  69. the code goes here
  70.  
  71. [ActionReplay_Enabled]
  72. $Your Code Here
  73. //////////
  74.  
  75. If this isn't making any sense, here are examples for both "type one" and "type two" AR codes: https://imgur.com/a/7PMgMV4
  76.  
  77. Once you got that, save the INI. If you haven't moved it from your PC to GameSettings, you should do that too.
  78.  
  79. What you should have now is:
  80. - an INI file named your game ID located in GameSettings
  81. - the correct format for AR codes
  82. - code titles set under enabled so they are active in game
  83.  
  84. 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.
  85.  
  86. ===
  87. The End
  88. ===
  89. 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!
  90.  
  91. 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
  92.  
  93. 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.
  94.  
  95. 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!
RAW Paste Data