Citra Installation Guide

Last Updated: 2019-02-06

This document will explain how to build an Eternal X or Wilting Y ROM for use with Citra,
a 3DS emulator. The process is straightforward, but can take some time, especially on slower
computers. The guide will walk you through the entire process of unpacking a ROM,
installing the hack and repacking it.
 Part One: What you’ll need
1. A 3DS, or CXI file of the base game
To get started, you’ll need a clean copy of either Pokémon X or Pokémon Y, as either a
decrypted .3DS file, or a .cxi file. This guide will not explain how to obtain either of these in
detail, but a .cxi file can be obtained easily by dumping a legitimate cart or digital copy using
a 3DS with custom firmware.
This file will be referred to as the “ROM file” throughout the guide for simplicity.
2. A copy of .Net 3DS Toolkit
This excellent tool made by Project Pokémon user evandixon can be downloaded by clicking
the download link on this page, and is what you’ll be using to unpack and repack the ROM
file.
3. A Copy of the hack’s files
If you haven’t got these already, you can download your preferred version of the hack from
my Google Drive by clicking here. Simply download the appropriate file and unzip it when
it’s done.
 Part Two: Unpacking the ROM
1. Unzip the 3DS Toolkit file you just downloaded. The contents of the folder should
match the image below. You may want to move your ROM file to this folder to make
the following steps easier.

2. Run “ToolkitForm.exe” and use the upper “Browse” button to select your ROM file.
Leave the Source ROM Format check box on “Auto”.
 3. Select an output directory. This is where your unpacked ROM files will be saved, so
make sure you know where it is. For the sake of this guide I’m going to make a new
folder named “Output” in the 3DS Toolkit folder and use that.

4. Click “Extract” and wait for the tool to finish. This may take several minutes, so don’t
panic if nothing seems to be happening. We’re not done with the tool yet, so leave it
open once it’s finished.

Part Three: Applying the Hack

Due to the way 3DS games are structured, it was very easy to create several different versions
of EXWY. While maintaining them all has become very painful for me, it means lots of
options for you!
The next step is setting up the modified ROMFS folder for your chosen version. Note that the
instructions for X and Y are the same, just make sure you’re using the correct download for
your ROM. If you want to customise part of your ROM (this includes using the “Viola nerf”
files), go to Part Four: Extra Options before following these steps.
1) Open the folder containing your chosen version of the hack (Legal, Rebalanced, or the
Insanity version of either) and navigate to the “a” folder within it. The easiest way to
do this is to hover your mouse cursor over the “luma” folder and mash left-click until
you see the “a” folder.
2) Once the ROM files have been extracted, copy the entire “a” folder and the
“DllField.cro” file from the hack’s files to the “RomFS” folder in the output directory
you chose earlier. This will overwrite several files in the extracted ROM’s “a” folder,
so merge any folders and replace any files if prompted.

3) Now you will need to patch the “.code.bin” file located in the “ExeFS” folder in your
output directory. To do this:
a. Run the Lunar IPS executable included in the hack’s “Game Files” folders
and select “Apply IPS Patch”
b. When asked to select an ips patch, navigate to the title ID folder in the hack’s
files, (this is the folder with a long string of numbers and letters for a name)
and select the “code.ips” file.

c. When asked to select a file to patch, navigate to the ExeFS folder in your
output directory and choose the “.code.bin” file. If you can’t see the file,
change “Most Common ROM Files” to “All Files”.
 Part Four: Extra Options
If you want to customise a certain version by mixing and matching features, or just
remove a feature you don’t like, I’ll explain how to do this now. If you’re happy to play a
version of the hack as is, skip this step and go to Part Five.
The following is a list of files (where the names are file paths) which I edited in at least
one version of the hacks. To remove the changes made in one of these files from your
game, simply remove it from the “Game Files” folder in the EX or WY download before
following the steps in Part Three. You can also mix and match parts of the three versions,
but this may get a bit messy.
a/0/4/0: Trainer’s Pokémon (moves, levels, etc)
a/0/3/8: Trainer data
a/0/1/2: Wild encounters
a/0/7/4: Game text (used for new TM descriptions)
a/2/1/4: Level up move data
a/2/1/2: Move data
a/2/1/8: Pokémon data (stats, typing, etc)
a/2/2/0: Item data
a/2/1/5: Evolution data
a/0/8/2: Story Text (used to change the text of two NPCs who now hand out different
TMs)

Legal Pokémon
A common request is wanting any Pokémon you catch while playing the game to be
transferrable to Poké Bank or useable online. To do this, remove the a/0/1/2 and a/2/1/8
files before installing the hack, and delete any egg moves (or moves exclusive to previous
generations) your Pokémon may have learned by levelling up before transferring or using
them online (tutor moves are fine, provided they’re in ORAS). Bear in mind that doing
this will completely ruin the level curve (you’ll need to switch the EXP share on and off
regularly) and result in some Trainers’ Pokémon having the wrong ability. You’ll also
lose access to many Hidden Abilities, weak Pokémon will no longer level up faster, and
several items held by wild Pokémon, such as fossils, will no longer be obtainable.

Nerf Viola
Due to player feedback, there are now two versions of the first gym available. In the first,
Viola will have six Pokémon. In the second, she will only have four. If you don’t want to
be up against a full team in the first gym, simply merge the “a” folder found in the "Viola
 Nerf Files" folder with the "a" folder in the “RomFS” folder after the standard files have
been copied to the ROMFS (in other words, once you’ve completed Part Three). Note that
this is not available for Insanity Mode, as that would defeat the purpose of the mode.

Part Five: Rebuild the ROM

5. You can now rebuild the ROM. Click the “Build” tab in .Net 3DS Toolkit and click
“Browse” to select your output directory from earlier as the source directory. Click
the other “Browse” button to choose where to save your new ROM and what to name
it.
Choose either “0-key Encrypted CCI” or “Decrypted CCI” as your output format;
either one will work with Citra, but your source ROM may not be able to be built into
one of them. If one format doesn’t work, try the other.

6. Click the “Build” button and wait for your ROM to be rebuilt.
7. Done!

There are a few things you should be aware of before playing the game:
• If you have an official title update installed, it will be applied to the hack. This means
that the mart, text and wild Pokemon changes will be replaced by the vanilla versions.
Because of this, you should uninstall any X/Y game updates from Citra before
playing.
• Because the hacks do not support title updates, the Lumiose save glitch is still
present in the games. This means you shouldn’t save in the places shown:
 • If you accidentally save in this area and it breaks your save, simply install the title
update, boot up your game and save somewhere else. Then, uninstall the update and
continue playing.
I hope this guide helped you; if you have further questions or want to suggest changes to
either this guide or EXWY (criticism is welcome!), please leave a post in EXWY's
Pokecommunity thread or PM me. If it’s a question regarding the guide, a post in the thread
is preferred as that way other people with the same problem can benefit from the solution.
Thanks for playing!