Join our discord
In partnership with NodeCraft Logo NodeCraft

You are not logged in! Create an account or login to contribute! Log in here!
From Pixelmon Wiki
This page contains changes which are not marked for translation.

Other languages:
Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎português do Brasil • ‎čeština • ‎русский • ‎中文(中国大陆)‎

This is a guide to installing Pixelmon through the default Minecraft launcher. This guide covers the installation of Pixelmon client-side, either for use in singleplayer or for joining existing Pixelmon servers. If you are installing Pixelmon on your own server, see the server installation guide instead.

This guide assumes that you have already purchased and installed the Java edition of Minecraft. If you do not have this version of Minecraft installed, you will need to do so before installing Pixelmon.

Installation requirements

  • A paid copy of the Java edition of Minecraft. You can purchase Minecraft at after creating or logging into a Mojang account.
    • Only the Java edition can run Pixelmon. Other editions (Pocket, Windows 10, console releases) cannot run Forge mods such as Pixelmon.
    • Cracked launchers may not save your Pokémon when you quit Minecraft, or may cause other issues. This will not be fixed.
  • 2 GB of available RAM.
  • A 64-bit Java 8 version.


  • If Minecraft is currently running, quit out of it before installing anything.
  • If you are installing other mods alongside Pixelmon, check the incompatibilities list first to avoid issues.
  • It is recommended to have at least 2 GB of RAM allocated to Minecraft. Note that this requires a 64-bit operating system and a 64-bit version of Java. If you do not know how to allocate memory, see this page.
  • The Pixelmon .jar file is universal, meaning that it can be used on both clients and servers. A smaller "-server" .jar is also available, which is missing assets that a server would never use. The server file only works on servers.


Pixelmon is compatible with several versions of Minecraft, shown in the table below. Each version of Minecraft requires a different version of Pixelmon to be used. Note that only the Minecraft 1.12.2 version of Pixelmon currently receives updates; versions of Pixelmon for older versions of Minecraft will no longer receive updates or bug fixes.

There is no Pixelmon version for Minecraft version 1.11.

Minecraft version Pixelmon version
1.12.2 8.1.2
1.10.2 5.1.2
1.8.9 4.3.1
1.8 4.1.4
1.7.10 3.5.1
The Forge installer

Forge installation

  1. Go to this page, and find the latest build (at the top).
  2. Click the "Installer" button to download the Forge installer.
  3. Run the Forge installer, select "Install client" and then click "OK".
    • Note: If nothing happens while on Windows, you may need the 2847 "installer-win" file instead.
  4. When the Forge installation is done, open the Minecraft launcher.
  5. Click the "Installations" tab.
  6. There should now be a Forge profile listed. Check if it's there.
    • Note: If no Forge profile shows up (or it is outdated), follow these steps first:
    1. If no Forge profile is present, click "Add new". If an older profile is present, click that instead.
    2. Find the drop-down menu labeled "Version" and select your new Forge version.
    3. Save your profile.
  7. Click on the tab "Play".
  8. Click the arrow underneath the "PLAY" button.
  9. Select your new Forge profile and then click "PLAY".
  10. Check the bottom-left corner of the main menu. You should see the Forge version you installed.
  11. Close Minecraft and move on to Pixelmon installation. Minecraft should not be open while installing mods.

Pixelmon installation

The Minecraft launcher profile editor. Sections and buttons that are important for installing Forge and Pixelmon are outlined in blue.
  1. Download the latest version of Pixelmon Reforged.
    • Note: If the mod's file size is below 400MB, it may be corrupt. If this happens, try again.
  2. Open the Minecraft launcher.
  3. Click the "Installations" tab on the header bar of the launcher.
  4. Click the profile that you installed Forge into.
  5. Find the text box labeled "Game directory", and click the green arrow to the right of it.
    • Note: You can also navigate to the shown path using something like File Explorer or Finder.
  6. In the game directory, look for a folder named mods. Forge should have created one.
    • Note: If no mods folder is present, refresh your view (try the F5 key). If that fails, create one.
  7. Place the downloaded Pixelmon file inside the mods folder.
    • Warning: Do not extract or otherwise edit the downloaded .jar file. Copy it in directly.
  8. Save your profile.
  9. Click on the "Play" Tab. Start the game.
  10. Check the "Mods" section on the main menu. If Pixelmon is listed here, it was installed correctly. Have fun!


  • If you follow the instructions above and Minecraft crashes, start by examining the crash report using this crash reading guide.
  • If Minecraft never finishes loading or is very laggy, you may need to allocate more memory for it to use. See Fixing memory issues for instructions about resolving this issue.

Video tutorials


© 2014 - 2020 Pixelmon Mod