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.
- A paid copy of the Java edition of Minecraft. You can purchase Minecraft at minecraft.net 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|
- Go to this page, and find the latest build (at the top).
- Click the "Installer" button to download the Forge installer.
- 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.
- When the Forge installation is done, open the Minecraft launcher.
- Click the "Installations" tab.
- 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:
- If no Forge profile is present, click "Add new". If an older profile is present, click that instead.
- Find the drop-down menu labeled "Version" and select your new Forge version.
- Save your profile.
- Click on the tab "Play".
- Click the arrow underneath the "PLAY" button.
- Select your new Forge profile and then click "PLAY".
- Check the bottom-left corner of the main menu. You should see the Forge version you installed.
- Close Minecraft and move on to Pixelmon installation. Minecraft should not be open while installing mods.
- 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.
- Open the Minecraft launcher.
- Click the "Installations" tab on the header bar of the launcher.
- Click the profile that you installed Forge into.
- 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.
- In the game directory, look for a folder named
mods. Forge should have created one.
- Note: If no
modsfolder is present, refresh your view (try the F5 key). If that fails, create one.
- Note: If no
- Place the downloaded Pixelmon file inside the
- Warning: Do not extract or otherwise edit the downloaded .jar file. Copy it in directly.
- Save your profile.
- Click on the "Play" Tab. Start the game.
- 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.