Config

The Pixelmon config folder, config/pixelmon, is a folder containing numerous .yml file(s) for the various configurable settings Pixelmon supports. The folder can be located by going to the Minecraft folder (accessible by clicking the "Open Game Dir" button on the Minecraft launcher's profile editor screen) and opening the config folder.

These .yml file(s) can be edited outside of Minecraft with a plain text editor such as Notepad or TextEdit. If edited with a plain text editor, changes will only be reflected when the target world is not online; changing the config file while the world is online will cause no changes to occur to the world until the world is reloaded. On a multiplayer server, editing the config file(s) in-game will only affect client-side settings; server-side settings can only be changed by editing the server .hocon file outside of Minecraft.

The config file(s) and/or folder can be reset to default settings by deleting the file. The file will be regenerated the next time Minecraft is launched. It is recommended to do this when Updating Pixelmon, to ensure any changes made are applied to your file(s).

Battle

Settings that allow you to alter battle mechanics and rates.

Setting (battle.yml)	Description	Default value
battle-a-i-wild	The type of battle AI that wild Pokémon will use. The Different Modes are As Follows: RANDOM - The Pokémon will use moves randomly. AGGRESSIVE - The Trainer will use the move that deals the most damage to the opponent, avoiding status moves. TACTICAL - The Trainer will know how to use status moves alongside offensive moves. ADVANCED - Along with knowing how to use moves like tactical AI, the Trainer will switch out Pokémon if advantageous.	RANDOM
battle-a-i-boss	The type of battle AI that boss Pokémon will use. The Different Modes are As Follows: RANDOM - The Pokémon will use moves randomly. AGGRESSIVE - The Trainer will use the move that deals the most damage to the opponent, avoiding status moves. TACTICAL - The Trainer will know how to use status moves alongside offensive moves. ADVANCED - Along with knowing how to use moves like tactical AI, the Trainer will switch out Pokémon if advantageous.	AGGRESSIVE
battle-a-i-trainer	The type of battle AI that naturally spawning NPC Trainers will use. The Different Modes are As Follows: RANDOM - The Pokémon will use moves randomly. AGGRESSIVE - The Trainer will use the move that deals the most damage to the opponent, avoiding status moves. TACTICAL - The Trainer will know how to use status moves alongside offensive moves. ADVANCED - Along with knowing how to use moves like tactical AI, the Trainer will switch out Pokémon if advantageous.	TACTICAL
multiple-photos-of-same-pokemon	Whether a player can take multiple photos of a single Pokémon.	true
relaxed-battle-gimmick-rules	Whether which battle gimmick can be used is determined purely by band chosen.	true
battle-music-volume	Volume of the music that is played during battles.	1.0
allow-p-v-p-experience	Whether or not Pokémon can gain experience when battling other players.	true
allow-trainer-experience	Whether or not NPC Trainers' Pokémon award experience upon defeat.	true
return-held-items	If enabled, consumable held items used up during player vs. player battles will be restored when the battle ends.	true
force-end-battle-result	This setting determines what will occur if a battle is ended without a proper conclusion (e.g., too many errors in battle, player death while in battle). Determining an official winner and loser only matters for certain aspects, such as the /pokestats command, NPC Trainers that give items upon defeat, or Pixelmon sidemods that manipulate battle wins and losses. The Different Modes are as Follows: WINNER - A winner will be decided based on which battler has more Pokémon remaining. If both battlers have the same amount of Pokémon remaining, the percentages of HP of each Pokémon remaining are summed and the winner is decided based on whose percentage HP sum is greater. If both sums are the same, the battle is considered a draw. DRAW - The battle is declared a draw. ABNORMAL - The battle is considered to have ended abnormally. This setting is only useful if the server has a Pixelmon sidemod that uses PlayerBattleEndedAbnormalEvent.	WINNER
exp-modifier	Multiplier for experience gained in Pokémon battles.	1.0
synchronize-chance	Chance for Synchronize to sync nature on battle start. (1 is 100% chance, 0.5 is 50% chance)	1.0
allow-happy-hour	Whether Happy Hour will award PokéDollars when used.	true
happy-hour-multiplier	The multiplier for how many PokéDollars will be awarded by using Happy Hour (2.0 = 2x Multiplier)	2.0
allow-pay-day	Whether Pay Day will award extra PokéDollars when used.	true
pay-day-multiplier	The multiplier for how many PokéDollars will be awarded by using Pay Day (5.0 = 5x Multiplier)	5.0
allow-g-max-gold-rush	Whether G-Max Gold Rush will award extra PokéDollars when used.	100.0
allow-amulet-coin	Whether Amulet Coin will award double PokéDollars when used.	true
amulet-coin-multiplier	The multiplier for how many PokéDollars will be awarded by using Amulet Coin (2.0 = 2x Multiplier)	2.0
pickup-rate	The rate (1/x) that Pickup will collect special drops at. 0 disables this.	10
allow-catch-combo	Allows chaining catches to get bonus exp, higher shiny and perfect iv rates.	true
catch-combo-thresholds	Catch Combos count thresholds at which the effects of the combo change.	0 10 20 30 40
catch-combo-exp-bonuses	Catch Combos exp bonuses per threshold.	1.0 1.100000023841858 1.5 2 2.5 3
catch-combo-shiny-modifiers	Catch Combos shiny modifiers per threshold.	1.0 1.0 1.399999976158142 1.7999999523162842 2.200000047683716 2.200000047683716
catch-combo-perfect-i-vs	Catch Combos perfect IVs per threshold.	0 0 2 3 4 4
scale-grass-battles	Whether or not the levels Pokémon found in Pixelmon grass will scale to the level of the player's highest-leveled Pokémon.	false

Breeding

Settings for breeding behavior.

Setting (breeding.yml)	Description	Default value
allow-breeding	Whether or not ranch blocks can be crafted and used.	true
allow-ditto-ditto-breeding	Whether or not two Ditto can breed together to produce Eggs with random Pokémon inside them.	true
allow-ranch-expansion	Whether or not ranch upgrades exist.	true
allow-random-breeding-eggs-to-be-legendary	Whether or not Eggs made from two Ditto breeding together have a chance of hatching Legendary Pokémon.	false
breeding-ticks	How long it takes for a Pokémon to advance from one breeding level to the next with breeding strength 1 ("Pokémon 1 is more attracted to Pokémon 2 every day!"). This is measured in ticks (20 ticks = 1 second). If breeding environments are enabled, this time will be affected by multipliers depending on how suitable the breeding environment is.	18000
max-cumulative-pokemon-in-ranch	Maximum Pokemon a player can have in all ranches across the world. Max of 0 is unlimited.	0
num-breeding-levels	The number of breeding levels that breeding Pokémon must advance through in order to produce an Egg. Can be between 1 and 5.	5
oval-charm-multiplier	Breeding rate modifier that is applied if the Oval Charm is equipped.	0.5
steps-per-egg-cycle	Egg cycles are used to determine how many steps it takes for Eggs to hatch. The lower this value, the fewer steps it takes for Eggs to hatch.	255
use-breeding-environment	Whether or not the environment around a ranch block affects the speed of the breeding process. If this is disabled, the speed of breeding will always be equal to "Pokémon 1 is more attracted to Pokémon 2 every day!"	true

Commands

Settings that relate to Pixelmon's commands.

Setting (commands.yml)	Description	Default value
random-poke-allow-legendary	If enabled, Pokémon spawned from /pokegive or from any pokespec have the possibility of containing Legendary Pokémon.	false
random-poke-allow-mythical	If enabled, Pokémon spawned from /pokegive or from any pokespec have the possibility of containing Mythical Pokémon.	false
random-poke-allow-ultra-beast	If enabled, Pokémon spawned from /pokegive or from any pokespec have the possibility of containing Ultra Beast Pokémon.	false

Config

Config settings for the world.

Setting (config.yml)	Description	Default value
award-tokens		false
allow-pokemon-nicknames	Whether or not the player can nickname owned Pokémon. On a server, this will prevent nicknames from being visible to other players.	true
allow-anvil-autoreloading	Anvil auto-reloading is when players can continue to hammer an item on an anvil and the item will automatically be taken and replaced with its unfinished version when finished (e.g., an iron base being obtained and replaced with an iron disc from the player's inventory), allowing players to continuously hammer stacks of items to completion.	false
allow-vanilla-mobs	Whether or not regular Minecraft mobs like cows and zombies can spawn naturally. DANGER - can kill you while battling. Monster spawners containing zombies, skeletons, or spiders will be converted into monsters spawners that spawn pigs if this setting is disabled. Other monster spawners (including ones that spawn hostile mobs like Blazes, cave spiders, or silverfish) will not be affected, nor will spawn eggs. The Ender dragon also spawns naturally regardless of this setting.	false
allow-capture-outside-battle	Whether or not players are allowed to throw Poké Balls and capture Pokémon outside of battle.	true
allow-random-pokemon-to-be-legendary	If enabled, Pokémon spawned from /pokegive or from any pokespec have the possibility of containing Legendary Pokémon.	true
growth-scale-modifier	How much growth varies the size of Pokémon. This value can range from 0-2; if set to 0, growth will have no effect on Pokémon size.	1.0
allow-planting	Whether or not Apricorns can be planted by players. This does not remove existing Apricorn trees or prevent natural Apricorn tree generation.	true
cloning-machine-enabled	Whether or not cloning machines can be crafted and used. Disabling this setting prevents Mewtwo from being legitimately obtainable.	true
lake-trio-max-enchants	Sets The number of times a Azelf, Mesprit and Uxie can enchant a ruby.	3
engage-player-by-poke-ball	If enabled, battles between players can be initiated by a player throwing a Pokémon's Poké Ball at another player directly (rather than at the other player's Pokémon).	true
enable-wild-aggression	Whether or not aggressive wild Pokémon initiate battles against players.	true
shrine-encounter-mode	Whether Legendary bird shrines can be used multiple times. The Different Modes are as Follows: Once - A shrine may only be used once globally. OncePerPlayer - A shrine may only be used once per player. OncePerMCDay - A shrine may only be used once every Minecraft day (20 minutes). OncePerDay - A shrine may only be used once every 24 hours. Unlimited - A shrine may be used infinitely.	Once
spawners-op-only	Whether or not players have to be ops to edit Pixelmon spawners. If this option is disabled, any player in Creative mode can edit spawners.	true
npc-editor-op-only	If set to true, must be opped to use the NPC Editor. If false, must be in Creative mode.	true
quest-editor-op-only	If true, must be opped to use the Quest Editor. If false, must be in Creative mode.	true
traders-reusable	Whether or not traders can be used multiple times. If disabled, traders will disappear after completing their trade offers.	false
moves-per-tutor	The amount of moves a Move Tutor will have.	20
use-system-time-for-world-time	Whether or not Minecraft time will sync to real time (as defined by the server's system time).	false
time-update-interval	How often Minecraft time will sync to real time (in seconds) if real time syncing is enabled.	30
allow-pokemon-editors	Whether or not players can use Pokémon editors. When disabled client-side, this will prevent other players from using Pokémon editors on the player with the setting disabled.	true
allow-chisels	Whether or not players can place Chisels using a Chisel.	true
max-level	The maximum level that a Pokémon can be.	100
can-pokemon-be-hit	Whether or not out-of-battle wild Pokémon can be hurt by physical attacks.	false
always-have-mega-ring	Whether or not players will automatically have a Mega ring.	false
always-have-dynamax-band	Whether or not players will automatically have a Dynamax band.	false
chance-to-get-special-bidoof	The chance of obtaining a Sir Doofus III from catching a Bidoof with a Luxury Ball. (-1 to disable)	30
disabled-non-player-movement	Determines if non player owned pokemon's movement is disabled or not.	false
allow-shiny-charm-from-pokedex	If enabled, unlocks the Shiny Charm upon Pokédex completion.	true
allow-oval-charm-from-pokedex	Enables unlocking the Oval Charm upon completion of a regional Pokédex.	true
exp-charm-multiplier	Experience multiplier when an Exp. Charm is equipped.	1.5
catching-charm-multiplier	Multiplier of the chance that a critical capture will occur when a Catching Charm is equipped.	1.1
mark-charm-rolls	Number of rolls for a wild Pokémon to gain a mark when a Mark Charm is equipped.	3
ore-colors		'11': block-id: minecraft:sapphire_ore color: 4879335 pattern: 1 '12': block-id: minecraft:ruby_ore color: 14490675 pattern: 1 '13': block-id: minecraft:fossil color: 4472114 pattern: 6 '14': block-id: minecraft:crystal_ore color: 11529966 pattern: 4 '15': block-id: minecraft:bauxite_ore color: 13743492 pattern: 0 '16': block-id: minecraft:dawn_dusk_ore color: 0 pattern: 7 '17': block-id: minecraft:water_stone_ore color: 6123935 pattern: 8 '18': block-id: minecraft:thunder_stone_ore color: 15793921 pattern: 9 '19': block-id: minecraft:leaf_stone_ore color: 8298855 pattern: 10 '1': block-id: minecraft:iron_ore color: 14860458 pattern: 0 '2': block-id: minecraft:gold_ore color: 16576075 pattern: 0 '3': block-id: minecraft:redstone_ore color: 16711680 pattern: 0 '4': block-id: minecraft:emerald_ore color: 1564002 pattern: 0 '5': block-id: minecraft:diamond_ore color: 6682083 pattern: 0 '6': block-id: minecraft:lapis_ore color: 1594813 pattern: 2 '7': block-id: minecraft:quartz_ore color: 15394270 pattern: 3 '8': block-id: minecraft:amethyst_ore color: 9782185 pattern: 4 '9': block-id: minecraft:sun_stone_ore color: 15038274 pattern: 5 '20': block-id: minecraft:fire_stone_ore color: 13398322 pattern: 11 '10': block-id: minecraft:silicon_ore color: 14868462 pattern: 0
average-lure-expiry-ticks	How many ticks it will take for a lure to expire on average.	17920
limit-shop-keeper-stack-size	If set to False, this will be based on the remaining inventory of the player.	true
old-gen-dimensions	Which dimensions use Gen 7 features (eg. Mega Bosses). Any other dimension will use Gen 8 (eg. Max Raids).	[]
both-gen-dimensions	Which dimensions use both Gen 7 and Gen 8 features. Overrides other options that would affect this otherwise.	- pixelmon:ultra_space - pixelmon:drowned - minecraft:overworld - minecraft:the_nether - minecraft:the_end
dynamax-size	Height of Dynamax and Gigantamax in blocks.	15.0
allow-illegal-shinies	Whether shinies which aren't available in Pokémon are available here or not.	true
berry-juice-crafting	Whether berry juices can be crafted in the infuser or not.	true
poke-gift-reusable	If enabled, Poké Gifts will remain after players claim them, but each Poké Gift can only be claimed once per player. If disabled, claiming a Poké Gift will cause it to disappear.	false
elevator-search-range	The maximum distance that two elevators can link together at.	10
starter-on-join	Whether or not players will pick their starter Pokémon immediately upon entering a world.	true
Debug Settings
print-errors	If this option is enabled, any Pixelmon-related errors on a server will be printed to the server log in detail. If disabled, errors will be much shorter and less detailed.	true
use-update-entity-with-optional-force-fix	Whether to use the fix for clumping Pokémon around the edges of the world. If you are on Sponge, or don't know what it is, keep it off.	false
verbose	Verbose Logging - Keep this off unless you are diagnosing issues.	false
TMs Settings
allow-t-m-reuse	If enabled, TMs can be used an infinite amount of times without breaking. If disabled, TMs will break after being used once.	true
allow-t-r-reuse	If enabled, TRs can be used an infinite amount of times without breaking. If disabled, TRs will break after being used once.	true
universal-t-ms	Whether TMs, HMs, and TRs can be used regardless of generation if the Pokémon has it in their TM/HM/TR list somewhere.	true
super-universal-t-ms	Whether TMs, HMs, and TRs can be used regardless of generation if the Pokémon has it in their base stats somewhere.	false
Drops Settings
pokemon-drops-enabled	Whether or not certain Pokémon can drop items upon defeat.	true
use-drop-g-u-i	If enabled, the drops GUI will display after the player defeats a regular wild Pokémon. The drops GUI will always display when defeating NPC Trainers or boss Pokémon, regardless of this setting.	true
delete-unwanted-drops	Whether or not the "Drop All" button in the Pokémon drops screen will delete the items or drop them on the ground.	false
den-star-drops	Number of item drops for each star level in raids.	- 2 - 4 - 6 - 8 - 10
Healing Settings
beds-heal-pokemon	Whether or not beds will fully heal Pokémon when slept in.	true
use-passive-healer	Whether to passively heal party Pokémon over time or not.	true
chance-to-revive-passively	Chance to passively revive a knocked out party Pokémon with each step.	0.0010000000474974513
chance-to-heal-status-passively	Chance to passively heal status effects from a party Pokémon with each step.	0.004999999888241291
steps-to-heal-health-passively	Number of steps after which to heal 1 HP from a party Pokémon.	75
passive-healing-max-health-percentage	Percentage of maximum health that the passive heal can go up to.	0.25
AFK-Handler Settings
enabled	Whether or not the AFK handler is enabled.	false
afk-activate-seconds	The amount of time (in seconds) that a player can be unresponsive in battle before the AFK handler takes control.	90
afk-timer-turn-seconds	The amount of time that the AFK handler takes to make a move.	15
Pokerus Settings
enabled	Whether or not the Pokérus is enabled. This blocks the growth, the spread and the spawning of the Pokérus.	true
spawn-rate	Pokérus spawn rate (1/x). (0 to disable)	12288.0
inform-players	Whether or not the player should be informed if their Pokémon got Pokérus.	true
spread-rate	Chance to spread the Pokérus to the near Pokémon after a battle. (1/x) (-1 to disable; 0 to keep always active)	5
Riding Settings
allow-riding	Allow players to ride Pokémon. If false, no Pokémon can be ridden.	true
riding-speed-multiplier	A multiplier for the mounting speed of Pokémon. Can be between 0 and 1, where 1 is the default mounting speed.	1.0
enable-point-to-steer	If enabled, this option causes a mounted Pokémon to be steered by moving the camera, matching the directional controls on foot. If disabled, mounted Pokémon are steered using the keybinds for moving left and right.	true
land-mount	If enabled, allows riding Pokémon mounts that do not have the ability to fly or surf.	true
require-h-m	Whether or not Fly or Surf must be known by a water or flying mounted Pokémon in order to mount it. Land mounts are unaffected by this setting.	false
flying-speed-limit	Sets the flying speed limit for a mounted Pokémon in the new flying system.	4.0
Outside Effects Settings
use-outside-effects	Whether or not outside effects is enabled or disabled.	true
steps-to-apply-effects	Amount of steps for effects such as Poison to be applied.	15
poison-max-damage	The maximum amount of damage Poison can do outside of battle to a poisoned Pokémon.	5

Dimensions

Settings that relate to Pixelmon's dimensions.

Setting (dimensions.yml)	Description	Default value
ultra-space	Whether the Ultra Space Dimension is activated or not.	true
wild-berry-trees	Where the Berry Trees are capable of spawning in the wild.	false

Move Skills

Settings for controlling External Moves.

Setting (.hocon)	Description	Default value
allow-external-moves	Whether or not players are able to use Move Skills.	true
allow-destructive-external-moves	Whether or not players are allowed to use the following Move Skills: Cut Dig Explode Light Fire Rock Smash Thunder Bolt	true
forage-chance	Higher values for better chances of obtaining item with Forage.	0.949999988079071

Graphics

Graphics settings.

Setting (graphics.yml)	Description	Default value
render-distance-weight	A number that is multiplied to the default render distance (64) to produce a final render distance.	2.0
name-plate-range	How far away levels and names of Pokémon can be seen when outside of battle. This setting is client-side. 1: Default (closest) 2: Farther 3: Far (furthest away)	1
render-wild-levels	Whether or not wild Pokémon should show their level above their head.	true
show-wild-names	Whether to show wild Pokémon names on their nameplates.	true
scale-models-up	If this option is enabled, Pokémon will be 30% larger than if the option was disabled.	true
use-smooth-shading-on-poke-balls	Whether or not Poké Balls use SMD normal maps in their models, making them appear smoother.	true
enable-smooth-pokemon-shading	Whether or not Pokémon use SMD normal maps in their models, making them appear smoother.	true
smooth-animations	Whether SMD models use smooth animations or not.	false
show-current-attack-target	Whether or not a Pokémon's attack target (F key by default) is shown on the screen.	true
draw-health-bars	Whether or not HP bars will be displayed above Pokémon.	false
use-battle-camera	If enabled, the camera will change during battles to a third-person camera focusing on the battling Pokémon. If disabled, the camera will remain the same as if the player was not in a battle.	true
player-control-camera	Whether or not the camera can be manually moved by the player during battles.	true
only-show-attack-effects-to-battlers	If true, attack effects are only displayed to players participating in or spectating a battle.	true
advanced-battle-information	If true, show percentage of opponent HP remaining	true
range-to-display-attack-animations	The range (in blocks) at which battle effects should be displayed to players if they are not in the battle.	40
emissive-textures	Emissive textures add an additional effect that makes some Pokémon glow, but come with a significant performance penalty.	true
emissive-textures-distance	The distance to stop rendering emissive textures at.	32

Quests

Settings that alter how quests function.

Setting (.hocon)	Description	Default value
quest-max-range	The maximum distance a player can get before a quest can be found on a new NPC if not taken.	500
quest-random-n-p-cs	Whether to let NPCs be randomly assigned quests or not. This does not affect quests that have already been started.	True

Raids

Settings regarding Max Raid Dens.

Setting (raids.yml)	Description	Default value
raid-shiny-chances	Shiny rates per raid star level	4096.0 4096.0 2048.0 1024.0 1024.0
raid-h-a-chances	HA rates per raid star level.	150.0 125.0 100.0 75.0 50.0
raid-gigantamax-factor-chances	Gigantamax Factor rates per raid star level.	512.0 512.0 512.0 256.0 128.0
den-spawn-chance-modifier	Chance of a den spawning per chunk.	0.30000001192092896
den-additional-spawn-chance-on-liquid	Modifier of the den spawn chance if the den is going to spawn on liquid.	0.5
den-respawn-time	Time of day when dens attempt to respawn their boss.	100
den-respawn-chance	Chance of a den respawning their boss when the den respawn time is hit.	0.25
den-star-weights	Weights of each star level appearing in raids.	19 12 9 3 1
raid-have-legendaries	Whether raids can have legendaries.	true
raid-have-ultra-beasts	Whether raids can have Ultra Beasts.	true
raid-master-ball-block	Star levels at which Master Balls/Park Balls cannot be used.	false false false false false
raid-only-leader-can-catch	Star levels at which only the leader of the raid has a catch attempt.	false false false false false
raid-catch-health-percentage	Health percentage raids are treated as having for catch purposes, per star level.	0 0.05000000074505806 0.10000000149011612 0.15000000596046448 0.20000000298023224
raid-blacklist	Species which can never appear in raids.	MissingNo
raid-dens-breakable	Whether or not dens can be broken with repeat pickaxe hits.	true

Spawning

Settings that control what Pokémon spawns and how many of them spawn.

Setting (spawning.yml)	Description	Default value
despawn-radius	The minimum number of blocks away from the nearest player a Pokémon can be when despawned.	80
shiny-rate	Modifies the rarity of shiny Pokémon.	4096.0
ultra-space-shiny-rate-multiplier	Modifies the rarity of shiny Pokémon in the Ultra Space Dimension (shinyRate * ultraSpaceShinyModifier).	0.5
hidden-ability-rate	Modifies the rarity of Pokémon with hidden abilities.	150.0
ultra-space-hidden-ability-multiplier	Modifies the rarity of hidden abilities in the Ultra Space Dimension (hiddenAbilitySpawnRate * ultraSpaceHiddenAbilityModifier).	0.5
legendary-spawn-ticks	How often (in ticks) on average a Legendary Pokémon attempts to spawn. The actual time interval ranges from 60% to 140% of the specified value in this setting. The chance of the spawn attempt succeeding is defined by the legendarySpawnChance setting.	25000
legendary-spawn-chance	The chance of a Legendary Pokémon spawn attempt succeeding (0-1) if a viable location has been found for one to spawn. The frequency of this spawn attempt is defined by the legendarySpawnTicks setting.	0.30000001192092896
spawn-ticks-player-multiplier	A multiplier that speeds up legendary and mega boss spawning based on player count. ticks = spawnTicks / (1 + (number of players - 1) * spawnTicksPlayerMultiplier)	0.009999999776482582
spawn-levels-closer-to-player-levels	If enabled, wild Pokémon and trainers will spawn closer to the level range of the player. For example, a party where the highest level is 5 will never see Pokémon or trainers above level 15 unless through fishing. If the player has a Pokémon above level 39, only trainers are affected.	true
spawn-levels-increase-in-caves	If enabled, the y-value of the position a Pokémon spawns at will effect the Pokémon level proportionately, such that lower y-values will have higher level Pokémon.	true
cave-max-multiplier	The max level multiplier when you're at a lower level in caves	4
transform-to-ditto-on-catch	Chance for a wild Pokemon to turn into a Ditto on capture.	0.001
meltan-spawn-chance	Chance for a Meltan to spawn when smelting a metal ore block. 1/x	3072
meltan-transform-chance	Percentage chance for a Meltan to transform into Ditto on capture. 1 = 100%	0.25
can-transform-to-ditto-on-catch	Pokemon which can transform to Ditto.	Pidgey Rattata Gastly Zubat Mankey Yanma Hoothoot Sentret Zigzagoon Gulpin Whismur Taillow Remoraid Starly
gigantamax-factor-rate	Chance of a wild Pokémon spawning with the Gigantamax Factor (1/rate). 0 disables Gigantamax Factor spawns.	512.0
ultra-space-gigantamax-factor-modifier	Modifies the rarity of the Gigantamax Factor in the Ultra Space Dimension (gigantamaxFactorSpawnRate * ultraSpaceGigantamaxFactorModifier). -1 disables Gigantamax Factor spawns in Ultra Space.	-1.0
allow-legendary-spawn	Whether or not Legendary Pokémon will spawn naturally. This only affects Pokémon that use the Legendary spawn rate.	true
legendary-despawn-ticks	Number of ticks until legendaries will despawn.	6000
display-legendary-global-message	Whether or not a message will display when a Legendary Pokémon spawns. The message also displays which biome the Pokémon spawned in.	true
do-legendary-raid-event	Displays server-wide announcement 'A Legendary has spawned in a Max Raid Den in a <name> biome' when a Legendary spawns in one.	true
use-recent-level-moves	If set to true, Pokémon will spawn with the most recent moves in their level-up movepools. If false, Pokémon will spawn with random moves from their level-up movepools.	false
despawn-on-flee-or-loss	Whether or not wild Pokémon will despawn if the player flees from them or loses against them.	false
bell-success-chance	Chance that a bell, at dawn, will start to ring. 1 = 100%.	0.01
bell-inclusion-range	Range in blocks that Clear/Tidal Bells will seek out other bells.	10
lure-flute-duration	How long the effects of the Black/White Flute last for in seconds once used.	180
lure-flute-level-modifier	By how many levels the Black/White Flute can affect spawns by.	10
blocked-generations	Whether or not Pokémon from a specific generation can spawn. All generations enabled by default.	[]
replace-m-c-villagers	Whether to replace Minecraft's villagers with chatting NPCs in villages.	true
spawn-zygarde-cells	Allow Zygarde Cells to spawn randomly in the world.	true
level-distance
spawn-levels-by-distance	If enabled, wild Pokémon levels will increase as the distance from the world spawn point increases. If disabled, wild Pokémon will spawn with varying levels regardless of the distance from the world spawn point.	false
max-level-by-distance	The maximum level that Pokémon can spawn at when the spawnLevelsByDistance option is enabled.	60
distance-per-level	If the spawnLevelsByDistance setting is enabled, this setting determines the rate (in block distance) that wild Pokémon levels increase according to the distance from the world spawn point.	30
wild-spawning
entities-per-player	The maximum number of entities (NPC or Pokémon) that can spawn per player. Lower for better performance.	45
spawns-per-pass	The maximum number of spawns in a single spawn cycle for a single player. Lower for slower spawning and better performance. Values above 5 are very unlikely to make a noticeable difference.	2
spawn-frequency	The number of spawn passes made per minute. Decrease for better performance.	60.0
minimum-distance-between-spawns	The minimum number of blocks between a spawned entity and an existing living entity.	15.0
minimum-distance-from-centre	The minimum distance from the player that entities may spawn. The lower this is, the closer entities will spawn to players.	18
maximum-distance-from-centre	The maximum distance from the player that entities may spawn.	64
horizontal-track-factor	How many ticks 'lead' the player tracking spawner will give players based on their motion. This tries to spawn at locations the player is about to be.	80.0
vertical-track-factor	How many ticks 'lead' the player tracking spawner will give players based on their vertical motion. Typically best as zero due to the interference jumping can cause.	0.0
horizontal-slice-radius	The horizontal radius of the areas randomly selected near the player to do spawning in. Lower for better performance but less reliable spawning.	10
vertical-slice-radius	The vertical radius of the areas randomly selected near the player to do spawning in. Lower for better performance but less reliable spawning. Making this larger than the horizontal slice radius is a good idea.	25
maximum-spawned-pokemon	The maximum number of Pokémon that can be naturally spawned in at once. This does not count fishing, Move Skills, commands, or legendary spawning	3000
maximum-spawned-flying-pokemon	The maximum number of Flying Pokémon that can be naturally spawned in at once (soft limit). This does not count fishing, external moves, commands, or legendary spawning.	500
maximum-spawned-flying-pokemon-per-player	The maximum number of Flying Pokémon that can spawn per player. Lower for better performance.	45
boss-spawning
boss-rate	The rate of boss Pokémon in the wild (1/x) not including mega bosses.	256.0
ultra-space-boss-modifier	Modifies the rarity of bosses in the Ultra Space Dimension (bossRate * ultraSpaceBossModifier).	0.5
boss-level-increases	The level increases of each boss tier. Common, Uncommon, Rare, Epic, Legendary, Ultimate, Haunted, Drowned.	5 10 20 30 40 50 25 75
boss-weights	Relative spawn chances of each boss tier.	16 12 8 4 2 1
boss-candy-chances	Chances to get a Rare Candy from a boss, per boss type.	0.10000000149011612 0.20000000298023224 0.3499999940395355 0.5 0.75 1
bosses-always-mega-if-possible	Whether bosses that spawn must Mega Evolve if they can.	true
boss-spawn-ticks	How often (on average) a boss Pokémon will attempt to spawn.	10000
boss-spawn-chance	Chance that a Mega Boss spawn attempt will succeed. 1 = 100%	0.30000001192092896
poke-loot
spawn-normal	Whether or not visible PokéLoot chests spawn naturally.	true
spawn-hidden	Whether or not invisible PokéLoot chests spawn naturally.	true
spawn-grotto	Whether or not Hidden Grottos spawn naturally.	true
spawn-rate	The frequency at which PokéLoot chests spawn. The Different Modes are as Follows: MINIMAL NORMAL MORE EXTREME	NORMAL
spawn-mode	The default setting for how PokéLoot chests act once looted. The Different Modes are as Follows: FCFS - Chest disappears once looted by a player. PL - Chest doesn't disappear, but each individual player can only loot it once. PU - Chest doesn't disappear, can be looted infinitely by players. TIMED - Chest doesn't disappear, each individual player can loot the chest periodically (cooldown duration can also be set in config, defaults at once per day).	FCFS
loot-time	How often players can loot PokéLoot chests that are set to have timed loot. This value is in hours.	24

Storage

Setting (storage.yml)	Description	Default value
computer-boxes	The number of boxes a player has access to in the PC, up to a maximum of 256 per player.	30
write-entities-to-world	Whether or not Pixelmon entities (such as naturally spawning Pokémon and NPC Trainers) are saved with the world. If enabled, the size of the world save file and the time needed to save the world increase.	false
data-save-on-world-save	Whether or not data about players' Pokémon is saved when the world is saved. If this option is disabled, player Pokémon will need to be saved manually.	true
use-async-saving	Activates off-main thread saving of party and computer data. (server only)	true
async-interval	The interval in seconds that the async saver will save all queued data to disk.	60

Structures

Settings that relate to Pixelmon's structures.

Setting (structures.yml)	Description	Default value
replace-m-c-villagers	Whether to replace Minecraft's villagers with chatting NPCs in villages.	true
spawn-structures	Whether or not Pixelmon structures can spawn naturally.	true
spawn-bird-shrines	Whether or not shrines can spawn naturally. If disabled, shrines that already exist can still be used.	true
spawn-celebi-shrines	Whether or not Celebi shrines (Ilex Shrine) can spawn randomly in the world.	true
ilex-shrine-spawn-rate	Chance per valid chunk to contain an Ilex Shrine.	0.005
ice-shrine-spawn-rates	Modifier for the success-rate of whether Ice shrines can spawn in any valid chunk naturally.	0.033330000936985016
waypoint-spawn-rate	Modifier for the success-rate of whether Waypoints can spawn in any valid chunk naturally.	0.0333000011742115