Pixelmon Server Configuration Guide

The Config section controls many of Pixelmon's global gameplay rules. This is where you can decide whether players can nickname Pokémon, change the maximum Pokémon level, sync Minecraft time with the server machine, automatically grant Mega Rings or Dynamax Bands, and configure several world and item features.

Pixelmon Config Settings

The settings below are listed in the same order as they appear in config.yml. Boolean options can be enabled or disabled, while some fields accept numbers, lists, or IDs. The Setting column shows a reader-friendly name first, followed by the matching config.yml key for reference.

Setting and Config Key	Default and Accepted Values	Description
Allow Pokemon Nicknames allow-pokemon-nicknames	Default: true Values: true or false	Controls whether players can nickname owned Pokémon. Disabling it also prevents nicknames from appearing to other players on a server.
Allow Planting allow-planting	Default: true Values: true or false	Controls whether players can plant Apricorns. Disabling it does not remove existing Apricorn trees or prevent natural generation.
Enable Cloning Machine cloning-machine-enabled	Default: true Values: true or false	Controls whether Cloning Machines can be crafted and used. Disabling this prevents Mewtwo from being obtained through the normal cloning process.
Lake Trio Max Enchants lake-trio-max-enchants	Default: 3 Values: whole number	Sets how many times Azelf, Mesprit, and Uxie can each enchant a ruby
Use System Time for World Time use-system-time-for-world-time	Default: false Values: true or false	Controls whether Minecraft world time syncs with the server machine's system time.
Time Update Interval time-update-interval	Default: 30 Values: whole number of seconds	Sets how often world time resyncs when use-system-time-for-world-time is enabled.
Max Level max-level	Default: 100 Values: positive whole number	Sets the maximum level a Pokémon can reach.
Automatically Give Mega Ring always-have-mega-ring	Default: false Values: true or false	Gives players automatic access to a Mega Ring when enabled.
Automatically Give Dynamax Band always-have-dynamax-band	Default: false Values: true or false	Gives players automatic access to a Dynamax Band when enabled.
Chance to Get Special Bidoof chance-to-get-special-bidoof	Default: 30 Values: -1 or a positive whole number	Sets the chance of receiving Sir Doofus III when catching Bidoof in a Luxury Ball. The value uses 1-in-X odds, so 30 means a 1-in-30 chance. Use -1 to disable it.
Fallback Capture Method fallback-capture-method	Default: gen8 Values: supported generation method ID	Selects the official game generation catch formula used by Pixelmon's fallback capture calculation.
Hammer Durability Loss Multiplier hammer-durability-loss-multiplier	Default: 3 Values: number	Multiplies the durability lost each time a hammer is used.
Old Gen Dimensions old-gen-dimensions	Default: [] Values: YAML list of dimension IDs	Lists dimensions that use Gen 7 features, such as Mega Bosses. Dimensions not listed use Gen 8 features, such as Max Raids.
Both Gen Dimensions both-gen-dimensions	Default: pixelmon:ultra_space, pixelmon:drowned, minecraft:overworld, minecraft:the_nether, minecraft:the_end Values: YAML list of dimension IDs	Lists dimensions that use both Gen 7 and Gen 8 features. This setting overrides other options that would otherwise determine which generation's features are used.
Dynamax Size dynamax-size	Default: 15.0 Values: positive number of blocks	Sets the displayed height of Dynamax and Gigantamax Pokémon.
Berry Juice Crafting berry-juice-crafting	Default: true Values: true or false	Controls whether Berry Juices can be crafted in the Infuser.
Poke Gift Reusable poke-gift-reusable	Default: false Values: true or false	When enabled, Poké Gifts remain after being claimed, but each player can claim each gift only once. When disabled, a gift disappears after it is claimed.
Elevator Search Range elevator-search-range	Default: 10 Values: whole number of blocks	Sets the maximum distance at which two elevators can link.
Starter On Join starter-on-join	Default: true Values: true or false	Controls whether players are prompted to choose a starter Pokémon immediately after joining the world.
Use Discord Rich Presence use-discord-rich-presence	Default: true Values: true or false	Controls whether Pixelmon's Discord Rich Presence integration is enabled.
Default Unlocked Sections default-unlocked-sections	Default: SPAWNING Values: YAML list of supported Pokédex section IDs	Sets which Pokédex sections are visible by default for Pokémon a player has not caught.

Important Setting Notes

Generation Features by Dimension

Use old-gen-dimensions for dimensions that should only use Gen 7 features. Use both-gen-dimensions when a dimension should support both Gen 7 and Gen 8 features. Entries in both-gen-dimensions take priority over other generation feature settings.

Real-Time World Sync

The time-update-interval setting only matters when use-system-time-for-world-time is enabled. With the default interval of 30, Pixelmon resyncs the world time every 30 seconds.

List and Identifier Settings

Set Boolean settings to true to enable them or false to disable them.
When a setting accepts multiple entries, preserve the list format used in config.yml.
Enter complete namespaced IDs, such as minecraft:overworld, without removing required punctuation.

Final Thoughts

The Config section is the best starting point for customizing Pixelmon's global rules. Make one group of changes at a time, then restart the server so you can confirm everything works as expected.

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.