Login Logout Preferences
Jump to: navigation, search

Difference between revisions of "Installation"

m (macOS)
Line 81: Line 81:
==Video tutorials== <!--T:10-->
==Video tutorials== <!--T:10-->
<div class="col-md-6">
<div class="col-md-12">
<div class="wrapper">
<div class="wrapper">
     <div class="youtube" data-embed="uQj11CtgYAI">
     <div class="youtube" data-embed="uQj11CtgYAI">

Revision as of 07:31, 18 April 2018

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

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.

Installation requirements

  • 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.
  • 2 GB of available RAM.
  • A 64-bit Java 8 version.


  • If Minecraft is currently running, quit out of it before installing anything.
  • Make sure that you 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.
  • Be sure that you have a paid copy of Minecraft, not a cracked launcher. If you use a cracked launcher, your Pokémon will not be saved when you quit Minecraft. This will not be fixed.
  • The Pixelmon JAR file is universal, meaning that the same JAR can be used for both client and server.
  • If you are installing other mods alongside Pixelmon, check the incompatibilities list to make sure you don't install mods incompatible with Pixelmon.


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 6.2.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. Find the recommended Forge version for your chosen Minecraft version on this page. Depending on your operating system, download either the "Installer-win" (Windows) or "Installer" (macOS/Linux) file.
  2. The downloaded file is an automatic installer; when you run it, make sure you select "client".
  3. When the Forge installation is done, open the Minecraft launcher.
  4. Select the "Launch Options" tab on the header bar of the launcher.
  5. Either add a new profile or edit an existing profile.
  6. Find the drop-down menu labeled "Version" and select it. There should be an option named after the Forge version you installed. Choose this version.
  7. Save your profile.
  8. Navigate to any other tab and start Minecraft.
  9. If Minecraft loads without crashing, check the bottom-left corner of the main menu. If the Forge version you downloaded is listed in this corner, you have installed Forge correctly.
  10. Close Minecraft. Minecraft cannot be open while you are installing Pixelmon.

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.
    • Make sure that the downloaded JAR file's size is around 290 MB. If it is significantly smaller (e.g., 0 B), then the download was corrupted, and you should try re-downloading the file.
  2. Open the Minecraft launcher.
  3. Edit the profile that you installed Forge with.
  4. Find the text box labeled "Game directory". To the right of this text box is a folder and a green arrow. Click on the green arrow to open the Minecraft game directory folder.
    • Alternatively, use your system's file browser (e.g., File Explorer, Finder) to navigate to the file path listed in the "Game directory" text box.
  5. In the game directory folder, look for a folder named mods. If you do not see a folder with this name, create a mods folder.
  6. Place the downloaded Pixelmon file inside the mods folder.
    • Do not extract or unzip the file. Place the JAR file directly into the folder.
  7. Save your profile.
  8. Navigate to any other tab and start Minecraft.
  9. If Minecraft loads without crashing, check the "Mods" section on the main menu. If Pixelmon is listed among the mods that are installed, you have installed Pixelmon correctly.


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

Video tutorials