FAQ and Troubleshooting
Yes, CFW is required for any save editing or live editing.
Yes.
Yes, LiveHeX is not made for emulators.
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.
Make sure 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.
Go into PKHeX > Options > Settings and change Startup > PluginLoadMethod to LoadFile.
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.
Your Pokémon likely has specific PIDIV requirements. Refer to the section on Generating to learn how this works.
Same as above. Your Pokémon likely has specific PIDIV requirements. Refer to the section on Generating to learn how this works.
You need to follow the link to download a compatible version (usually the latest), install it, and reboot your Switch.
PKHeX-Plugins is telling me that the detected game does not match the current save file. (The top of the window says "Forced" for the game version.)
This happens if you are running the plugins from the wrong blank save (e.g. trying to connect to BDSP from a SWSH save). From the main PKHeX menu, go to Options > Settings and change the blank save version to match the game you are connecting to.
Example of an error when connecting to LGPE on version 1.0.0, which is unsupported.
- If the latest version of the game is supported, and you are not on the latest version of the game, you need to update your game. Close the game and press
+while hovered over the icon, then selectSoftware Update.- For example, you are on Scarlet version 1.0.0 and PKHeX-Plugins only supports 1.0.1 onward.
- If the latest version is not supported, be patient and wait for the program to be updated to support it.
- For example, you are on Scarlet version 1.3.0 and PKHeX-Plugins only supports up to 1.2.0. In this case, the plugins need to be updated to support 1.3.0.
As it says, you are running mismatched plugins. Please see the Installation Guide to learn how to match the version number with PKHeX's release number. If there is no matching version for the latest PKHeX, either use an older version of PKHeX or wait for an update to PKHeX-Plugins.
- On Switch, this means your RAM is displaced due to cheats, mods, or programs like CaptureSight and Tesla. 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.
- A quick fix for extra things running on your Switch that are interfering is to remove everything from the
atmosphere/contentsfolder except for sys-botbase (and ldn_mitm for SWSH), and reboot to see if it works. Then add things back until it breaks. - Also read the FAQ regarding red boxes or Poké Ball icons.
- Please check first that the game you have PKHeX set to matches the one you are trying to connect to. This should be displayed at the top of PKHeX's header. You should have gotten a warning if the game or version does not match.
- On 3DS, this may simply be because NTR is sluggish. Change the box back and forth until the problem resolves.
This is the same problem as the one above for red boxes and Poké Ball icons, and tends to happen with BDSP. Follow those instructions.
- This can be due to the same problem as what causes red boxes, but can additionally occur if your console and computer are on different bands of a dual-banded router. Put them both on the same band, and if one does not work, try the other band.
- If you see "Forced" version, you should have gotten an error about the game or version not matching. Follow the instructions for the error.
You cannot have "OneDrive" in the path where your files exist. The current path will appear at the top of the window when you attempt the automatic installation.
Move your files somewhere else, or look up how to disable OneDrive. Here is an example guide.
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. A Wonder Card is NOT a
pk8/pk9/etc. file; putting Pokémon files into this directory will not work. The file extension should be something likewc8/wb8. - Create an
mgdbfolder in the same directory as PKHeX.exe and put new Wonder Cards inside. - For new Tera Raid Pokémon, you likely need to update your PKHeX to UNSTABLE development builds. You can also try Installing Bleeding Edge Releases if you are able to build the programs yourself.
- For new Pokémon GO Pokémon, you can build PGET and extract the pkl files to put in the same folder as PKHeX.exe. Remove these pkl files when a new stable PKHeX is released.
- Restart PKHeX afterwards.
Please carefully review the Troubleshooting Connection Errors for sys-botbase page or Troubleshooting Connection Errors for USB-botbase depending on what you are using.
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.
- If these still don't resolve your issue, come to the ALM Discord linked on the repository's main page.