---
title: How to Configure Max Raid Battles in Pixelmon
description: Max Raid Battles offer cooperative challenges with valuable rewards, and raids.yml lets you decide how those encounters work. This guide explains every raid setting, from den behavior and star-level distribution to Pokémon pools, battle mechanics, and reward configuration on your Pixelmon server.
source: "https://nodecraft.com/support/games/minecraft/mods/pixelmon/how-to-configure-max-raid-battles-in-pixelmon"
image: "https://dynamic-assets.nodecraft.com/signedurl/w7vokBAexMnVlnMZ1Q/image.jpg?modifications=W3sibmFtZSI6ImdhbWVfYmciLCJpbWFnZV91cmwiOiJodHRwczovL2Ntcy1hLm5vZGVjcmFmdC5jb20vZi8xMzM5MzIvMjAwMHg1NTAvZGNiMGFkNjkzOC9jYXZlcy1hbmQtY2xpZmZzLXB0LTItMS0yLTAucG5nL20vIn0seyJuYW1lIjoiZ2FtZV9sb2dvIiwiaW1hZ2VfdXJsIjoiaHR0cHM6Ly9jbXMtYS5ub2RlY3JhZnQuY29tL2YvMTMzOTMyLzM3NXgxNTAvM2MxZGIyYmFiNS9taW5lY3JhZnQucG5nL20vIn0seyJuYW1lIjoiY3RhX3RleHQiLCJ0ZXh0IjoiQ3JlYXRlIHlvdXIgb3duIHNlcnZlciEifSx7Im5hbWUiOiJ0ZXh0IiwidGV4dCI6IkhvdyB0byBDb25maWd1cmUgTWF4IFJhaWQgQmF0dGxlcyBpbiBQaXhlbG1vbiJ9XQ&s=72ad78c2465d08f4496cbf58e808d4905303f8b3800e1c2a857d99e91a21a856"
published: "2026-08-16T23:26:03.209Z"
updated: "2026-08-16T23:26:03.209Z"
---

# How to Configure Max Raid Battles in Pixelmon

Max Raid Battles offer cooperative challenges with valuable rewards, and raids.yml lets you decide how those encounters work. This guide explains every raid setting, from den behavior and star-level distribution to Pokémon pools, battle mechanics, and reward configuration on your Pixelmon server.

The Max Raid Battle section contains the options Pixelmon uses for this part of the server. Configure raid dens, star-level weights, Pokémon pools, rewards, and battle behavior.

## Pixelmon Max Raid Battle Settings

The settings below are listed in the same order as they appear in raids.yml. The table preserves each default and identifies the accepted value type. The Setting column shows a reader-friendly name first, followed by the matching raids.yml key for reference.

| Setting and Config Key | Default and Accepted Values | Description |
| --- | --- | --- |
| **Raid Shiny Chances** raid-shiny-chances | **Default:** [4096.0, 4096.0, 2048.0, 1024.0, 1024.0] **Values:** list | Shiny rates per raid star level |
| **Raid H A Chances** raid-h-a-chances | **Default:** [150.0, 125.0, 100.0, 75.0, 50.0] **Values:** list | HA rates per raid star level. |
| **Raid Gigantamax Factor Chances** raid-gigantamax-factor-chances | **Default:** [512.0, 512.0, 512.0, 256.0, 128.0] **Values:** list | Gigantamax Factor rates per raid star level. |
| **Den Respawn Time** den-respawn-time | **Default:** 100 **Values:** whole number | Time of day (in ticks) when dens attempt to respawn their boss. |
| **Den Respawn Chance** den-respawn-chance | **Default:** 0.75 **Values:** decimal number | Chance of a den respawning their boss when the den respawn time is hit. |
| **Den Star Weights** den-star-weights | **Default:** [19, 12, 9, 3, 1] **Values:** list | Weights of each star level appearing in raids. |
| **Raid Have Legendaries** raid-have-legendaries | **Default:** true **Values:** true or false | Whether raids can have legendaries. |
| **Raid Have Ultra Beasts** raid-have-ultra-beasts | **Default:** true **Values:** true or false | Whether raids can have Ultra Beasts. |
| **Raid Master Ball Block** raid-master-ball-block | **Default:** [false, false, false, false, false] **Values:** list | Star levels at which Master Balls/Park Balls cannot be used. |
| **Raid Only Leader Can Catch** raid-only-leader-can-catch | **Default:** [false, false, false, false, false] **Values:** list | Star levels at which only the leader of the raid has a catch attempt. |
| **Raid Blacklist** raid-blacklist | **Default:** [MissingNo] **Values:** list | Species which can never appear in raids. |
| **Raid Dens Breakable** raid-dens-breakable | **Default:** true **Values:** true or false | Whether or not dens can be broken with repeat pickaxe hits. |

## Important Max Raid Battle Setting Notes

### Defaults and Value Types

Boolean toggles, numeric rates, timers, lists, and mappings use different value formats. Preserve the value type shown in the table and keep collection syntax intact when changing raids.yml.

### Settings That Work Together

Several max raid battle options can affect the same outcome. Review related rates, limits, timers, and lists together before deciding that one value is responsible for a result.

### Testing Changes

- Change one related group of settings at a time so its effect is easy to measure.
- Test the result under the conditions affected by the setting, including relevant dimensions, player states, or encounter types.
- Keep a copy of the previous values so unexpected balance or performance changes can be reversed quickly.

## Final Thoughts

Max Raid Battle settings are easier to balance when changes are deliberate and documented. Start with the defaults, adjust only what the server needs, and verify the result before moving on to the next group.