This is a guide to installing Pixelmon. 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.
This guide assumes that you have already purchased and installed Minecraft. If you do not have Minecraft installed, you will need to do so before installing Pixelmon.
- A paid copy of the computer edition of Minecraft. This is the version that is obtained by purchasing Minecraft at minecraft.net using a Mojang account.
- Only the computer edition can run Pixelmon. Minecraft Pocket Edition (including Windows 10 Edition) and console editions (Xbox, PlayStation, Wii U, Switch) cannot run 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 the same file can be used on both clients and servers. A smaller server-specific file is also available, which is missing files that a server would never use. Files with "-server" in the name will not work on things that aren't 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|
- Find the recommended Forge version on this page.
- Depending on your operating system, download either "Installer-win" (Windows) or "Installer" (macOS/Linux).
- Note: Make sure you download Forge 2655 or earlier. Newer versions currently break Pixelmon.
- The downloaded file is an automatic installer. Run it, select "Install client" and then click "OK".
- Note: If you are using an alternative launcher, you may need to change the folder it installs to first.
- When the Forge installation is done, open the Minecraft launcher.
- Click the "Launch Options" tab on the header bar of the launcher.
- You should now see a Forge profile.
- Note: If no Forge profile shows up (or it is outdated), follow the additional steps below before proceeding.
- Click any other tab, such as "News".
- Click the arrow to the right of the "PLAY" button.
- Select your new Forge profile and then click "PLAY".
- If Minecraft loads without issues, check the bottom-left corner of the main menu. If the Forge version you downloaded is listed here, you have installed Forge correctly!
- Close Minecraft and move on to Pixelmon installation. Minecraft should not be open while installing mods.
Additional steps for upgrade installs or installs without a Forge profile:
- 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.
- Download the latest version of Pixelmon Reforged.
- Note: If the mod's file size is significantly below 290MB, it may be corrupt. Try re-downloading it, if so.
- Open the Minecraft launcher.
- Edit the profile that you installed Forge with.
- 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 your system's file browser (e.g. File Explorer, Finder).
- In the game directory, look for a folder named
mods. If you do not see a folder with this name, create it.
- Place the downloaded Pixelmon file inside the
- Warning: Do not extract or unzip the file. Place the downloaded .jar file directly into the folder.
- Save your profile.
- Navigate to any other tab and start Minecraft.
- If Minecraft loads without crashing, 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.