How to Configure Max Raid Battles in Pixelmon
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.
Need Help?
If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.