Skip to content

Installing PKHeX Plugins

santacrab2 edited this page Oct 14, 2026 · 50 revisions

Installing Stable Releases

Stable builds are recommended for the vast majority of users. They are are posted on GitHub. Please note that you must install the correct stable release of PKHeX-Plugins for each stable version of PKHeX. Mismatched plugins will not work.

To update, simply redo the installation in a new, empty folder. Move the trainers folder along with any other folders from your PKHeX installation from your old PKHeX directory and discard the rest.

Manual Installation or Installing Older Releases

These are the installation instructions for manually installing the plugins.
PKHeX-Plugins only works with the matching version of PKHeX. This is how you can check that the versions are the same.

  1. Go to the PKHeX-Plugins Releases page and find the release you want to install. The red box highlights the version. Download the PKHeX-Plugins.zip file. Do not download the source code.
    image

  2. Go to the PKHeX Download page and find the matching version.

    • The regular Download button on the top right will give you the latest version.
    • Older versions are available from the drop-down. Click to change to the correct version and then download it.
      image
  3. Right-click and extract the PKHeX archive to a location where you have permissions. Good locations are within your Documents folder or on your Desktop. Do not place this folder in any folder named "OneDrive" or in any system location such as System32.

  4. Create a new folder named plugins in the same directory as PKHeX.exe.

  5. Extract the dll files from the PKHeX-Plugins zip file and put them in the plugins folder. The pdb files can be safely ignored. You can delete the PKHeX-Plugins zip and extracted folder afterwards.

  6. Open PKHeX.exe. The program icon should be blue if you did this correctly. All mod functions and settings should be located in the Tools > Auto-Legality Mod menu.

  7. You may optionally choose to set up custom Trainer Data.

More Help

If you have followed everything on this page and still cannot get your installation to work, visit Troubleshooting for more help.

Clone this wiki locally