Installation/zh-cn

如果你在使用 Windows，那么推荐你使用 Pixelmon 启动器。下面的大多数教程针对 Minecraft 官方启动器。

这是一个安装 Pixelmon 的教程，覆盖了客户端部分的安装说明，这样你就可以加入单人游戏，或是加入已经存在的 Pixelmon 服务器。如果你需要将 Pixelmon 安装到服务器，那么请查看服务器安装向导。

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.

Notes

• 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.
• Do not use the Technic launcher to install Pixelmon. You will not receive a starter Pokémon, and will not be able to use Pixelmon features; this incompatibility will not be fixed. Use the Minecraft launcher or the Pixelmon launcher.
• 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.

Versions

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.10.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 or 1.12 yet. See this page for Pixelmon's current status with regards to the latest Minecraft versions.

Minecraft version	Pixelmon version
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 here.
   • Make sure that the downloaded JAR file's size is around 380 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.

Troubleshooting

• 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.
• If you still have issues with Minecraft crashing and the notes above don't contain the answer you need, try posting a support ticket on Pixelmon's support tracker.