Login Logout Preferences
Jump to: navigation, search

Pixelmon launcher

Revision as of 21:13, 10 September 2015 by Some body (talk | contribs) (Config settings)

The Pixelmon launcher is an optional alternative Minecraft launcher that can be used to install and run Pixelmon. Additional mods can be installed along with Pixelmon as well, either manually or through the use of custom modpacks known as "Pixpacks". It was primarily designed to simplify and legalize the distribution and installation of Pixelmon modpacks.

The Pixelmon launcher is currently only compatible with Windows systems. It will not function on Unix-based systems like Mac or Linux.

Installation and Setup

  1. Download the Pixelmon launcher here.
  2. Once the download is completed, run the downloaded executable file to install the Pixelmon launcher.
  3. Accept the terms and conditions and specify where the Pixelmon launcher should be installed.
  4. When the installation finishes, the Pixelmon launcher will start automatically. A shortcut will be placed on the desktop for future use.
  5. Enter in your Minecraft account details to log into your account.
  6. If you are using the launcher to run a Pixpack, click here. Otherwise, continue below.
  7. Click the "Create New Profile" button in the green box. This will cause the profile editor interface to appear.
  8. Choose the desired Pixelmon and Forge versions
  9. Name the new profile if desired.
  10. If you want to use any additional mods alongside Pixelmon, click the "Add Official Side-Mods" button for Pixelmon sidemods and/or the "Browse for Mods" button for other mods on your system.
  11. Save your profile once you are finished creating it.
  12. Click the download icon in the top-right area of the launcher to install Minecraft, Pixelmon, and Forge into the Pixelmon launcher. This may take a few minutes.
  13. Once the downloading is finished, the download icon will be replaced with a play icon. Pressing this button will launch Minecraft.


Profile settings

These settings can be found in the profile editor screen.

  • Use custom window size: This allows a window size (width and height) to be defined exactly; it is an alternative to dragging the lower-right corner to resize the window.
  • Additional arguments to use when initializing Minecraft.
  • Keep output dialog open after Minecraft exits: This specifies whether the Minecraft console will persist after Minecraft closes.
  • Reinstall all libraries next install: This will force all files to be re-downloaded the next time the profile is used.

Minecraft settings

These settings can be found on the header of the main launcher screen.

  • Volume: The volume of the music playing in the Pixelmon launcher
  • Maximum memory: The amount of memory to allocate to Minecraft when it is running.
  • Select Java Install: This specifies which version of Java to use when running Minecraft.
  • Java arguments: The JVM arguments to use when running Minecraft.
  • Auto-updater: This feature will check if there is a Pixelmon launcher update periodically (can be configured or disabled) and automatically update the Pixelmon launcher if there is one.
  • Enable experimental features: If any new, unstable features are included within the Pixelmon launcher version, enabling this option will allow these features to be accessed. It is encouraged to report any bugs with these features to Pixelmon's issue tracker.

Config settings

A reduced version of the pixelmon.cfg file can be edited by selecting the wrench icon in the lower-right corner of the launcher. This config file is unique to the currently selected profile and will not affect any other profiles. The full config file can be accessed by clicking the "Open File" button in the top-right corner of this screen.

Other settings

  • Language can be changed by clicking the flag button in the top-right corner of the launcher.


Pixpacks are packages that can be used to make profiles in Pixelmon launcher. Within them, it is possible to bundle:

  • A specific Pixelmon version
  • Additional mods
  • Config files (for both Pixelmon and the additional mods
  • Resource packs and shaders
  • World saves
  • Server IPs
  • A custom Pixelmon database

If a mod contained in the Pixpack doesn't allow distribution through external means, it is possible to instead link players to the mod's own download page.

Creating a Pixpack

  • To begin making a new Pixpack, create an empty folder (location is irrelevant).
  • Using a text editor such as Notepad, create a file named "setup.json" inside the new empty folder. This file is used to define several aspects of the Pixpack, including its name and the mods to be included inside it. An example setup.json file is shown below:
 "Name":"Example Pack",
   "forgeFile": "forge-1.7.10-",
   "name":"Pixelmon Dark v0.6.zip",
   "Name":"Example Server"
The contents of an example Pixpack
  • Depending on what you want to include inside the Pixpack, place any of the following items inside the folder:
    • Mods that are bundled with the Pixpack (including the Forge installer)
    • In a "config" folder, modified config files for any included mods (including pixelmon.cfg)
    • In a "customdatabase" folder, a modified Pixelmon database (Pixelmon.h2.db)
    • In a "resourcepacks" folder, any resource packs bundled with the Pixpack
    • In a "saves" folder, world saves that will be available when using the Pixpack
    • In a "shaderpacks" folder, shaders to be used with the Pixpack
    • A "banner.png" file, which changes the banner at the top of the Pixelmon launcher. The default banner image can be found here.
    • A "style.xaml" file, a text file that defines the color schemes used by various parts of the Pixelmon launcher. The default style.xaml file is shown below:
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
   <Color x:Key="MainColour">#00000000</Color>
   <Color x:Key="DarkerColour">#33000000</Color>
   <Color x:Key="DarkestColour">#55000000</Color>
   <Color x:Key="MenuBGColour">#FF29B6F6</Color>
   <Color x:Key="LoginBGColour">#FF8BC34A</Color>
   <Color x:Key="ProfileRegionBGColour">#FF8BC34A</Color>
   <Color x:Key="ProfileRegionBGDarkColour">#FF6F9C3B</Color>
   <Color x:Key="ProfileRegionBGDarkerColour">#FF4F782C</Color>
   <Color x:Key="MainFontColour">White</Color>
   <Color x:Key="AltFontColour">Black</Color>
   <Color x:Key="RadioButtonPressed">#FF8BC34A</Color>
   <Color x:Key="PopupBGColour">#FF26A69A</Color>
   <Color x:Key="PopupBGDarkColour">#FF00897B</Color>
   <Color x:Key="PlayButtonInnerColor">#FF8BC34A</Color>
   <Color x:Key="PlayButtonOuterColor">White</Color>
   <Color x:Key="DeleteButtonBGColour">#FFEF5350</Color>
   <Color x:Key="SaveButtonBGColour">#FF00695C</Color>
  • After adding the files you want in the pack, highlight all of the files and compress them into a compressed (zipped) folder.
  • Rename the zipped folder to the name you want for your Pixpack. Add the ".pixpack" extension after the file name.

Running a Pixpack

  1. Select the .pixpack file from Windows Explorer/File Explorer and open it with the Pixelmon launcher.
  2. If the Pixpack requires you to download mods via the mods' websites, follow the links provided and download them. Drag and drop the required mod files into the launcher.
  3. Click the "Install Profile" button.
  4. Click the button with the download icon at the top-right area of the launcher and wait for installation to finish.
  5. Run the pack directly from the box.
  6. In subsequent sessions, press the play button at the top-right area of the launcher, where the download icon previously was.