# How to Install Pixelmon on Your Minecraft Server (/docs/minecraft/install-pixelmon)



Pixelmon adds Pokémon to Minecraft — you can catch, train, and battle Pokémon in a full open-world Minecraft experience. It's one of the most popular Minecraft mods ever made.

Installing Pixelmon [#installing-pixelmon]

<div className="fd-steps">
  <div className="fd-step">
    Set up a Forge server [#1-set-up-a-forge-server]

    Pixelmon requires Forge. Set your server type to Forge in `Startup` on the [XGamingServer panel](https://panel.xgamingserver.com). Use the Forge version recommended by Pixelmon.
  </div>

  <div className="fd-step">
    Download Pixelmon [#2-download-pixelmon]

    Get the latest Pixelmon server files from [Pixelmon's official site](https://pixelmonmod.com/downloads.php). Make sure the Pixelmon version matches your Forge and Minecraft version.
  </div>

  <div className="fd-step">
    Upload the mod [#3-upload-the-mod]

    Upload the Pixelmon `.jar` file to your `/mods/` folder via `Files`.
  </div>

  <div className="fd-step">
    Allocate enough RAM [#4-allocate-enough-ram]

    Pixelmon is resource-intensive. You need at minimum:

    | Players | Recommended RAM |
    | ------- | --------------- |
    | 1–5     | 4 GB            |
    | 5–15    | 6 GB            |
    | 15–30   | 8 GB+           |

    Check your RAM allocation in `Startup`.
  </div>

  <div className="fd-step">
    Restart the server [#5-restart-the-server]

    Restart from `Console`. First startup may take several minutes as Pixelmon generates its data files.
  </div>

  <div className="fd-step">
    Verify installation [#6-verify-installation]

    Check `Console` for Pixelmon loading messages. Connect with the Pixelmon mod installed on your client.
  </div>
</div>

Configuration [#configuration]

Spawning settings [#spawning-settings]

Edit `/config/pixelmon.hocon` via `Files`:

```ini
Spawning {
    # Maximum Pokémon spawned around a player
    maximumPokemonPerPlayer = 20
    # Spawn rate multiplier
    spawnFrequency = 50
}
```

Legendary spawn rates [#legendary-spawn-rates]

```ini
Spawning {
    legendarySpawnChance = 30.0
    legendarySpawnTicks = 24000
}
```

Lower `legendarySpawnTicks` = more frequent legendary spawns. Lower `legendarySpawnChance` = higher chance per attempt.

Disable specific Pokémon [#disable-specific-pokémon]

Create a custom spawn set or use the blocklist in the Pixelmon config to prevent certain Pokémon from spawning.

Common Commands [#common-commands]

| Command                           | Description                      |
| --------------------------------- | -------------------------------- |
| `/pokegive <player> <pokemon>`    | Give a Pokémon to a player       |
| `/pokespawn <pokemon>`            | Spawn a Pokémon at your location |
| `/pokeheal <player>`              | Heal a player's Pokémon team     |
| `/pokebattle <player1> <player2>` | Start a battle between players   |
| `/ivs`                            | Check your Pokémon's IVs         |

> ⚠️ **Warning:** Pixelmon is a large mod (200MB+). Both server and all players must have the same Pixelmon version installed. Version mismatches will prevent connection.

> 💡 **Tip:** Pixelmon works best on a dedicated server with at least 4 GB RAM. The mod adds hundreds of entities, so performance tuning is important for larger servers.

See also: [Installing Mods](/docs/minecraft/mod-setup) | [How Much RAM](/docs/minecraft/how-much-ram) | [Types of Server Lag](/docs/minecraft/types-of-server-lag)

If you need help, join our [Discord](https://discord.xgamingserver.com/).