FAQ and Troubleshooting

FAQ

Do I need CFW?
Yes, CFW is required for any save editing or live editing.

Can I use this on SXOS?
Some people have figured out how to get it to run sys-modules. We don't provide any technical support for SXOS so you have to figure it out yourself.

Should I use the stable builds or the bleeding edge builds?
Stable builds are recommended for most users. Bleeding edge builds are only for experienced users who want to test the latest commits and are able to troubleshoot errors.

How do PKHeX-Plugins work?
The plugins provided in this repository make use of PKHeX's IPlugin interface to sideload our custom code. PKHeX looks for provided plugins and loads them when the program is launched. These plugins provide various extra features that base PKHeX does not include.

How does Auto-Legality Mod work?
PKHeX provides numerous APIs for checking legality:

• Searching PKHeX's internal encounter database for encounters that match specifications
• Generating a PKM from an encounter template

With this plugin, we can find an encounter and generate a battle-ready PKM with just a ShowdownSet template! See this page for more details on how ALM works.

Troubleshooting

PKHeX doesn't open after installing the plugins.
PKHeX opens but the icon is not blue.
Make sure that you have unblocked both DLLs and your folder is in a location where you have access (not OneDrive or any system folder). The version of the plugins must be the same date as the PKHeX release version. Older versions of PKHeX can be downoaded from "See Changelog" on the PKHeX download page. Go back to basic installation of PKHeX-Plugins if you do not know how to install.

I have to open and close PKHeX multiple times to get the plugins to load.
Go into PKHeX > Options > Settings and change Startup > PluginLoadMethod to LoadFile.

"Legalize Active Pokémon" is not working.
Auto-Legality Mod does not create legal sets for you; it takes the bare minimum information from a Showdown set and adds extra game data to make the Pokémon legal in game. This means that you must ensure that the Pokémon you are trying to legalize has appropriate basic information. Recommendation is to start with Import Showdown Set first by following the Getting Started with Auto-Legality Mod page.

I am getting an error saying "An item with the same key has already been added" when I connect in BDSP.
This occurs when LiveHeX is unable to detect your game version, and will show "Forced" at the top as a best guess. This usually happens if:

• You are not on the latest release. Reinstall the plugins.
• You are running the plugins from the wrong blank save (e.g. trying to connect to BDSP from a SWSH save).
• You have cheats/mods or something else causing RAM shift active. This is usually because of Edizon's cheat engine (even if no cheats are loaded), Tesla, Capturesight, or layeredFS / game mods. It is suggested that you remove these programs and reboot if you are still having problems, but you can temporarily disable all Atmosphère cheats by holding L while booting up the game.

I am seeing red boxes when I connect with LiveHex.

• On Switch, this means your RAM is displaced due to cheats, mods, or programs ilke CaptureSight and Tesla. See the issue above for the solution.
• On 3DS, this may simply be because NTR is sluggish. Change the box back and forth until the problem resolves.

I connect without any errors, and I see completely blank boxes.
This can be due to the same problem as what causes red boxes, but can additionally occur if your device and computer are on different bands of s dual-banded router. Put them both on the same band, and if one does not work, try the other band.

I am having an error like "Field not found" or "Method not found" every time I try to legalize a Pokémon.
Your PKHeX and PKHeX-Plugins are mismatched. Please ensure that you are on the stable builds. Reinstall in an empty folder using the Installing PKHeX-Plugins page. Move the trainers folder from your old PKHeX directory and discard the rest.

I can't legalize a newly released Pokémon.
The Pokémon must first be legal in base PKHeX. Normally, Wonder Cards are bundled into stable releases.

• If it is a new event Pokémon, wait until a Wonder Card is released on Project Pokémon Event Gallery or the Github repository
• Create an mgdb folder in the same directory as PKHeX.exe and put new Wonder Cards inside.
• If it is not an event Pokémon, this may not be possible on the latest stable build.
• A Wonder Card is NOT a pk8/pb8 file; putting pk8/pb8 files into this directory will not work. The file extension should be wc8/wb8.
• Restart PKHeX afterwards.

When I click "Connect", the program freezes or I get an error about a connection attempt failing.

Please carefully review the Troubleshooting Connection Errors page.

When I try to Generate Living Dex with LiveHex, changing the box overwrites what I had.
You need to disable "Read on Changed Box" so changing the box does not erase the currently loaded mons. Every box must be written individually.