Config

The Pixelmon config file, pixelmon.hocon, is a file containing numerous settings for Pixelmon. The file 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. If using the Pixelmon launcher, the config file can be accessed by selecting the "Browse to Profile Folder" option on the main launcher screen and navigating to the config folder.

The config file can be edited inside Minecraft by pressing a certain hotkey (P by default), or by selecting Pixelmon from the "Mods" section in the main menu or the "Mod Options" section in-game. The file can also 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 in-game will only affect client-side settings; server-side settings can only be changed by editing the .hocon file outside of Minecraft.

The config file can be reset to default settings by deleting the file. The file will be regenerated the next time Minecraft is started up.

Settings

AFK handler

The AFK handler is a system that automatically takes control of battling players that have not responded for an amount of time. Once the AFK handler takes over, the unresponsive player may resume control at any time.

Setting (.hocon)	Setting (in-game)	Description	Default value
afkActivateSeconds	AFK activate seconds	The amount of time (in seconds) that a player can be unresponsive in battle before the AFK handler takes control.	90 seconds
afkHandlerTurnSeconds	AFK turn seconds	The amount of time that the AFK handler takes to make a move.	15 seconds
enableAFKHandler	AFK handler enabled	Whether or not the AFK handler is enabled.	False

Battle

Settings that allow you to alter battle mechanics and rates.

Setting (.hocon)	Setting (in-game)	Description	Default value
allowAmuletCoin	Allow Amulet Coin	Whether Amulet Coin will award double PokéDollars when used.	True
allowCatchCombo	Allow Catch Combos	Allows chaining catches to get bonus exp, higher shiny and perfect iv rates.	True
allowGMaxGoldRush	Allow G-Max Gold Rush	Whether G-Max Gold Rush will award extra PokéDollars when used.	True
allowHappyHour	Allow Happy Hour	Whether Happy Hour will award double PokéDollars when used.	True
allowPayDay	Allow Pay Day	Whether Pay Day will award extra PokéDollars when used.	True
allowPvPExperience	Enable PvP exp.	Whether or not Pokémon can gain experience when battling other players.	True
allowTrainerExperience	Enable Trainer exp.	Whether or not NPC Trainers' Pokémon award experience upon defeat.	True
catchComboExpBonuses	Catch Combo exp bonuses	Catch Combos exp bonuses per threshold.	1, 1.100000023841858, 1.5, 2, 2.5, 3
catchComboPerfectIVs	Catch Combo perfect IVs	Catch Combos perfect IVs per threshold.	0, 0, 2, 3, 4, 4
catchComboShinyModifiers	Catch Combo shiny modifiers	Catch Combos shiny modifiers per threshold.	1, 1, 1.399999976158142, 1.7999999523162842, 2.200000047683716, 2.200000047683716
catchComboThresholds	Catch Combo thresholds	Catch Combos count thresholds at which the effects of the combo change.	0, 10, 20, 30, 40
expModifier	Experience modifier	Multiplier for experience gained in Pokémon battles.	1
forceEndBattleResult	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. 0: 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. 1: The battle is declared a draw. 2: The battle is considered to have ended abnormally. This setting is only useful if the server has a Pixelmon sidemod that uses PlayerBattleEndedAbnormalEvent.	0 (determine winner based on Pokémon remaining)
gMaxGoldRushMultiplier	G-Max Gold Rush modifier	Whether G-Max Gold Rush will award extra PokéDollars when used.	100.0
payDayMultiplier	Pay Day modifier	Amount to multiply the level by when Pay Day is used.	5.0
pickupRate	Pickup rate	The rate (1/x) that Pickup will collect special drops at. 0 disables this.	10
returnHeldItems	Return held items after PvP battles	If enabled, consumable held items used up during player vs. player battles will be restored when the battle ends.	True
synchronizeChance	Synchronize nature sync chance	Chance for Synchronize to sync nature on battle start. (1 is 100% chance, 0.5 is 50% chance)	1

Breeding

Settings for breeding behavior.

Setting (.hocon)	Setting (in-game)	Description	Default value
allowBreeding	Allow breeding	Whether or not ranch blocks can be crafted and used.	True
allowDittoDittoBreeding	Allow Ditto-Ditto breeding	Whether or not two Ditto can breed together to produce Eggs with random Pokémon inside them.	True
allowRanchExpansion	Enable ranch expansion	Whether or not ranch upgrades exist.	True
allowRandomBreedingEggsToBeLegendary	Ditto-Ditto can contain Legendaries	Whether or not Eggs made from two Ditto breeding together have a chance of hatching Legendary Pokémon.	False
alolanEggDimensions	Alolan egg dimensions	The list of dimensions where eggs will be alolan. Requires regionalFormsByDimension to be enabled.	72
breedingTicks	Ticks per stage	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 (15 minutes)
galarianEggDimensions	Galarian egg dimensions	The list of dimensions where eggs will be galarian. Requires regionalFormsByDimension to be enabled.	0
maxCumulativePokemonInRanch	Maximum cumulative Pokemon In ranch blocks	Maximum Pokemon a player can have in all ranches across the world. Max of 0 is unlimited.	0
numBreedingStages	Breeding stages	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
ovalCharmMultiplier	Oval Charm breeding modifier	Breeding rate modifier that is applied if the Oval Charm is equipped.	0.5
regionalFormsByDimension	Regional forms by dimension	Whether alolan and galarian forms are granted to an egg if they are in a certain dimension.	True
stepsPerEggCycle	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
useBreedingEnvironment	Use breeding environments	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

Dimensions

Settings that relate to Pixelmon's dimensions.

Setting (.hocon)	Setting (in-game)	Description	Default value
drownedWorld	Enable Drowned World	Whether the Drowned World has its quest based restrictions or not.	True
drownedWorldRadius	Drowned World Radius (chunks)	The radius of the Drowned World. If a player travels beyond this, they are teleported to the opposite side.	30
spawnUltraSpaceEndCities	Ultra Space End City Spawning	Whether End Cities should be generated in new Ultra Space chunks.	True
spawnUltraSpaceExtraLoots	Ultra Space Extra Pokéloot	Whether more Pokéloot Chests should be generated in new Ultra Space chunks.	True
spawnUltraSpaceExtraOres	Ultra Space Extra Ore spawns	Whether more ores should be generated in new Ultra Space chunks.	True
spawnUltraSpaceExtraPlants	Ultra Space Extra Plant spawns	Whether more plants (apricorns, berries) should be generated in new Ultra Space chunks.	True
spawnUltraSpaceExtraShrines	Ultra Space Extra Shrines	Whether more shrines should be generated in new Ultra Space chunks.	True
spawnUltraSpaceNetherForts	Ultra Space Nether Fort spawns	Whether Nether Forts should be generated in new Ultra Space chunks.	True
ultraSpace	Enable Ultra Space	Whether the Ultra Space Dimension is activated or not.	True
ultraSpaceBossModifier	Ultra Space Boss Modifier	Modifies the rarity of bosses in the Ultra Space Dimension (bossRate * ultraSpaceBossModifier).	0.5
ultraSpaceColourblindMode	Ultra Space Colourblind Mode	Whether to use Ultra Space fog colourblind mode.	False
ultraSpaceDimId	Ultra Space Dimension ID	The dimension ID Ultra Space will utilize. If smaller than 2, defaults to ID 72.	0
ultraSpaceGigantamaxFactorModifier	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.
ultraSpaceHiddenAbilityModifier	Ultra Space Hidden Ability Modifier	Modifies the rarity of hidden abilities in the Ultra Space Dimension (hiddenAbilitySpawnRate * ultraSpaceHiddenAbilityModifier).	0.5
ultraSpaceShinyModifier	Ultra Space Shiny Modifier	Modifies the rarity of shiny Pokémon in the Ultra Space Dimension (shinyRate * ultraSpaceShinyModifier).	0.5

Elevator

Setting (.hocon)	Setting (in-game)	Description	Default value
elevatorSearchRange	Search range (up/down)	The maximum distance that two elevators can link together at.	10

External Files

Settings for enabling External JSON files.

Setting (.hocon)	Setting (in-game)	Description	Default value
spawnSetFolder	Spawn Set Folder	Which folder to use under ./pixelmon/spawning/ for spawn sets.	default
useBetterSpawnerConfig	Use Better Spawner config	Whether or not to use the file under config/pixelmon for the Better Spawner.	False
useExternalJSONFilesDrops	Use external JSON files for drops	Load external configuration files used for drops from the "pixelmon/drops" folder. If set to true and the "pixelmon/drops" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesMoves	Use external JSON files for moves	Load external configuration files used for moves from the "pixelmon/moves" folder. If set to true and the "pixelmon/moves" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesNPCs	Use external JSON files for NPCs	Load external configuration files used for NPCs from the "pixelmon/npcs" folder. If set to true and the "pixelmon/npcs" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesQuests	Use external JSON files for quests	Load external configuration files used for quests from the "pixelmon/quests" folder. If set to true and the "pixelmon/quests" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesRules	Use external JSON files for rules	Load external configuration files used for battle rules from the "pixelmon/rules" folder. If set to true and the "pixelmon/rules" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesSpawning	Use external JSON files for spawning	Load external configuration files used for spawning from the "pixelmon/spawning" folder. If set to true and the "pixelmon/spawning" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesStats	Use external JSON files for stats	Load external configuration files used for stats from the "pixelmon/stats" folder. If set to true and the "pixelmon/stats" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False
useExternalJSONFilesStructures	Use external JSON files for structures	Load external configuration files used for structures from the "pixelmon/structures" folder. If set to true and the "pixelmon/structures" folder does not exist, Pixelmon will create the folder and dump the existing files there.	False

Move Skills

Settings for controlling External Moves.

Setting (.hocon)	Setting (in-game)	Description	Default value
allowDestructiveExternalMoves	Allow destructive Move Skills	Whether or not players are allowed to use the following Move Skills: Cut Dig Explode Light Fire Rock Smash Thunder Bolt	True
allowExternalMoves	Allow Move Skills	Whether or not players are able to use Move Skills.	True
forageChance	Forage success chance	Higher values for better chances of obtaining item with Forage.	0.30000001192092896

General

General settings for the world.

Setting (.hocon)	Setting (in-game)	Description	Default value
allowAnvilAutoreloading	Enable anvil auto-reloading	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
allowCaptureOutsideBattle	Allow capture outside battle	Whether or not players are allowed to throw Poké Balls and capture Pokémon outside of battle.	True
allowChisels	Allow placing of Chisels (Pokémon statues)	Whether or not players can place Chisels using a Chisel.	True
allowIllegalShinies	Allow Illegal Shinies	Whether shinies which aren't available in Pokémon are available here or not.	True
allowOvalCharmFromPokedex	Unlock Oval Charm at full regional Pokédex	Enables unlocking the Oval Charm upon completion of a regional Pokédex.	True
allowPlanting	Allow Apricorn planting	Whether or not Apricorns can be planted by players. This does not remove existing Apricorn trees or prevent natural Apricorn tree generation.	True
allowPokemonEditors	Allow Pokémon 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
allowPokemonNicknames	Allow Pokémon 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
allowRandomPokemonToBeLegendary	Allow Random Pokémon to be Legendary.	If enabled, Pokémon spawned from /pokegive or from any pokespec have the possibility of containing Legendary Pokémon.	True
allowShinyCharmFromPokedex	Allows Shiny Charm via Pokedex.	If enabled, unlocks the Shiny Charm upon Pokédex completion.	True
allowTMReuse	Allow TM reuse.	If enabled, TMs can be used an infinite amount of times without breaking. If disabled, TMs will break after being used once.	True
allowTRReuse	Allow TR reuse.	If enabled, TRs can be used an infinite amount of times without breaking. If disabled, TRs will break after being used once.	False
allowVanillaMobs	Enable 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
alwaysHaveDynamaxBand	Always have Dynamax band	Whether or not players will automatically have a Dynamax band.	False
alwaysHaveMegaRing	Always have Mega ring	Whether or not players will automatically have a Mega ring.	False
averageLureExpiryTicks	Average ticks for lure expiration.	How many ticks it will take for a lure to expire on average.	17920 (14 minutes and 56 seconds)
awardPhotos	Award photos to wild battle winners	Whether or not wild Pokémon will drop photos when defeated.	False
battleAIBoss	Boss Pokémon battle AI	The type of battle AI that boss Pokémon will use. Value Name Description 1 Random The Pokémon will use moves randomly. 2 Aggressive The Trainer will use the move that deals the most damage to the opponent, avoiding status moves. 3 Tactical The Trainer will know how to use status moves alongside offensive moves.	2 (Aggressive)
battleAITrainer	NPC Trainer battle AI	The type of battle AI that naturally spawning NPC Trainers will use. Value Name Description 1 Random The Trainer will use moves randomly. 2 Aggressive The Trainer will use the move that deals the most damage to the opponent, avoiding status moves. 3 Tactical The Trainer will know how to use status moves alongside offensive moves. 4 Advanced Along with knowing how to use moves like tactical AI, the Trainer will switch out Pokémon if advantageous.	3 (Tactical)
battleAIWild	Wild Pokémon battle AI	The type of battle AI that wild Pokémon will use. Value Name Description 1 Random The Pokémon will use moves randomly. 2 Aggressive The Pokémon will use the move that deals the most damage to the opponent, avoiding status moves. 3 Tactical The Pokémon will know how to use status moves alongside offensive moves.	1 (Random)
battleMusicVolume	Battle Music Volume	Volume of the music that is played during battles.	1
bedsHealPokemon	Beds heal Pokémon	Whether or not beds will fully heal Pokémon when slept in.	True
berryJuiceCrafting	Berry Juice crafting	Whether berry juices can be crafted in the infuser or not.	True
berryTreeGrowthMultiplier	Berry tree growth multiplier	Multiplier for the growth rate of Berry trees. A higher multiplier will make Berry trees grow (and die) faster. Can be between 0.1 and 1000.	1
bothGenDimensions	Both Gen Dimensions	Which dimensions use both Gen 7 and Gen 8 features. Overrides other options that would affect this otherwise.	-1, 0, 1, 72, 73
canPokemonBeHit	Allows Pokémon hitting	Whether or not out-of-battle wild Pokémon can be hurt by physical attacks.	False
catchingCharmMultiplier	Catching Charm Multiplier	Multiplier of the chance that a critical capture will occur when a Catching Charm is equipped.	1.1
chanceToGetSpecialBidoof	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
cloningMachineEnabled	Enable cloning machine	Whether or not cloning machines can be crafted and used. Disabling this setting prevents Mewtwo from being legitimately obtainable.	True
computerBoxes	Amount of PC boxes	The number of boxes a player has access to in the PC, up to a maximum of 256 per player.	30
dataSaveOnWorldSave	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
deleteUnwantedDrops	Deletes 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
despawnRadius	Despawn radius of Pokémon.	The minimum number of blocks away from the nearest player a Pokémon can be when despawned.	80
disabledNonPlayerPixelmonMovement	Disables not owned Pokémon movement.	Determines if non player owned pokemon's movement is disabled or not.	False
dynamaxSize	Dynamax size	Height of Dynamax and Gigantamax in blocks.	15
enableWildAggression	Enable aggressive wild Pokémon	Whether or not aggressive wild Pokémon initiate battles against players.	True
engagePlayerByPokeBall	Enable challenge by throwing Poké 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).	False
expCharmMultiplier	Exp. Charm Multiplier	Experience multiplier when an Exp. Charm is equipped.	1.5
growthScaleModifier	Growth size variation	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
lakeTrioMaxEnchants	Max gems from Lake Trio	Sets The number of times a Azelf, Mesprit and Uxie can enchant a ruby.	3
limitShopKeeperStackSize	Limit shopkeeper max purchase size to stack size	If set to False, this will be based on the remaining inventory of the player.	True
markCharmRolls	Mark Charm Rolls	Number of rolls for a wild Pokémon to gain a mark when a Mark Charm is equipped.	3
maxLevel	Maximum level	The maximum level that a Pokémon can be.	100
maximumPlants	Maximum plants	The maximum number of Apricorn trees and Berry trees that can be planted in a world chunk.	32
movePerTutor	Moves tutor teaches.	The amount of moves a Move Tutor will have.	20
multiplePhotosOfSamePokemon	Allow duplicate Pokémon photos	Whether a player can take multiple photos of a single Pokémon.	True
npcEditorOpOnly	Only OP's can use NPC Editor.	If set to true, must be opped to use the NPC Editor. If false, must be in Creative mode.	True
oldGenDimensions	Old Gen Dimensions	Which dimensions use Gen 7 features (eg. Mega Bosses). Any other dimension will use Gen 8 (eg. Max Raids).	[]
oreColors	Ore colours for the Ore Sense moveskill.	By editing the HEX colors noted after the Ore's ID, the ore will have a different color when using Ore Sense. Format is block;color(hex);patternNumber	"minecraft:iron_ore;E2C0AA;0", "minecraft:gold_ore;FCEE4B;0", "minecraft:redstone_ore;FF0000;0", "minecraft:emerald_ore;17DD62;1", "minecraft:diamond_ore;65F5E3;0", "minecraft:lapis_ore;1855BD;2", "minecraft:quartz_ore;EAE5DE;3", "pixelmon:amethyst_ore;9543A9;4", "pixelmon:sun_stone_ore;E57742;5", "pixelmon:silicon_ore;E2DFEE;0", "pixelmon:sapphire_ore;4A73E7;1", "pixelmon:ruby_ore;DD1C33;1", "pixelmon:fossil;443D32;6", "pixelmon:crystal_ore;AFEEEE;4", "pixelmon:bauxite_ore;D1B584;0", "pixelmon:dawn_dusk_ore;000000;7", "pixelmon:water_stone_ore;5D719F;8", "pixelmon:thunder_stone_ore;F0FF01;9", "pixelmon:leaf_stone_ore;7EA167;10", "pixelmon:fire_stone_ore;CC7132;11"
pokemonDropsEnabled	Enable Pokémon drops	Whether or not certain Pokémon can drop items upon defeat.	True
printErrors	Print more detailed 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
questEditorOpOnly	Quest Editor op only	If true, must be opped to use the Quest Editor. If false, must be in Creative mode.	True
relaxedBattleGimmickRules	N/A	Whether which battle gimmick can be used is determined purely by band chosen.	True
shrineEncounterMode	The Legendary bird shrine reuse settings.	Whether Legendary bird shrines can be used multiple times. 0 = Once 1 = Once per player 2 = Once per mc day 3 = Once per day 4 = Unlimited	0
spawnBirdShrines	Spawn bird shrines	Whether or not shrines can spawn naturally. If disabled, shrines that already exist can still be used.	True
spawnCelebiShrines	Spawn Celebi shrines	Whether or not Celebi shrines (Ilex Shrine) can spawn randomly in the world.	True
spawnStructures	Spawn Pixelmon structures in world	Whether or not Pixelmon structures can spawn naturally.	True
spawnersOpOnly	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
starterOnJoin	Starter list on join	Whether or not players will pick their starter Pokémon immediately upon entering a world.	True
superUniversalTMs	Super Universal TMs	Whether TMs, HMs, and TRs can be used regardless of generation if the Pokémon has it in their base stats somewhere.	False
systemTimeSyncInterval	Seconds between time syncs	How often Minecraft time will sync to real time (in seconds) if real time syncing is enabled.	30
tradersReusable	Traders are reusable	Whether or not traders can be used multiple times. If disabled, traders will disappear after completing their trade offers.	False
universalTMs	Universal TMs	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
useDropGUI	Use drop GUI	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
useSystemTimeForBerries	Use system time for berry growth.	Whether the system time is used for berry growth, meaning they will grow even when the game isn't running.	False
useSystemTimeForWorldTime	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
useUpdateEntityWithOptionalForceFix	Use updateEntityWithOptionalForce 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	Enable verbose logging	Keep this off unless you are diagnosing issues.	False
writeEntitiesToWorld	Save 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

Graphics

Graphics settings.

Setting (.hocon)	Setting (in-game)	Description	Default value
advancedBattleInformation	Advanced battle information	If true, show percentage of opponent HP remaining	True
drawHealthBars	Draw Pokémon health bars	Whether or not HP bars will be displayed above Pokémon.	False
emissiveTextures	Emissive Textures	Emissive textures add an additional effect that makes some Pokémon glow, but come with a significant performance penalty.	True
emissiveTexturesDistance	Distance to stop rendering emissive textures	The distance to stop rendering emissive textures at.	32
namePlateRange	Name plate distance	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 (Default)
onlyShowAttackEffectsToBattlers	Only show attack effects to battlers	If true, attack effects are only displayed to players participating in or spectating a battle.	True
playerControlCamera	Player-controlled battle camera	Whether or not the camera can be manually moved by the player during battles.	True
rangeToDisplayAttackAnimations	Range for attack animations.	The range (in blocks) at which battle effects should be displayed to players if they are not in the battle	40
renderDistanceWeight	Render distance weight	A number that is multiplied to the default render distance (64) to produce a final render distance.	2.0
renderWildLevels	Renders wild Pokémon levels.	Whether or not wild Pokémon should show their level above their head.	True
scalePokemonModels	Increase model size by 30%	If this option is enabled, Pokémon will be 30% larger than if the option was disabled.	True
showCurrentAttackTarget	Show current attack target	Whether or not a Pokémon's attack target (F key by default) is shown on the screen.	True
showWildNames	Show wild Pokémon names	Whether to show wild Pokémon names on their nameplates.	True
smoothAnimations	Enable smooth animations on all SMD models	Whether SMD models use smooth animations or not.	False
useBattleCamera	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
useSmoothShadingOnPokeBalls	Smooth shading on Poké Balls	Whether or not Poké Balls use SMD normal maps in their models, making them appear smoother.	True
useSmoothShadingOnPokemon	Smooth shading on Pokémon	Whether or not Pokémon use SMD normal maps in their models, making them appear smoother.	True

Healing

Settings that control how much healing should occur while walking about.

Setting (.hocon)	Setting (in-game)	Description	Default value
chanceToHealStatusPassively	Chance to heal status whilst walking.	Chance to passively heal status effects from a party Pokémon with each step.	0.004999999888241291
chanceToRevivePassively	Chance to revive Pokémon whilst walking.	Chance to passively revive a knocked out party Pokémon with each step.	0.0010000000474974513
passiveHealingMaxHealthPercentage	Max HP passive healing	Percentage of maximum health that the passive heal can go up to.	0.25
stepsToHealHealthPassively	Amount of steps to heal party Pokémon	Number of steps after which to heal 1 HP from a party Pokémon.	75
usePassiveHealer	Enables passive healing	Whether to passively heal party Pokémon over time or not.	True

OutsideEffects

Settings that control how much outside effects should occur while walking about.

Setting (.hocon)	Setting (in-game)	Description	Default value
poisonMaxDamage	Max Damage Poison does	The maximum amount of damage Poison can do outside of battle to a poisoned Pokémon.	5
stepsToApplyEffects	Amount of steps for effects to be applied	Amount of steps for effects such as Poison to be applied.	15
useOutsideEffects	Enables outside effects	Whether or not outside effects is enabled or disabled.	True

PixelUtilities

Settings for PixelUtilities features.

Setting (.hocon)	Setting (in-game)	Description	Default value
eventCoords	Event Poké Gift spawning coordinates	Locations where event Poké Gifts will spawn.	None
eventHasLegendaries	Allow Legendaries in event Poké Gifts	If enabled, it is possible for event Poké Gifts to contain Legendary Pokémon.	False
eventHasShinies	Enable event Poké Gift Shinies	Whether or not it is possible for event Poké Gifts to contain Shiny Pokémon	False
eventMaxPokemon	Event Poké Gift maximum Pokémon	The maximum number of Pokémon that can be contained inside an event Poké Gift. The event Poké Gift will contain a random amount of Pokémon between 1 and the specified value.	1
eventPokeGiftLoad	Enable Poké Gift events	Whether or not event Poké Gifts spawn.	False
eventShinyRate	Event Poké Gift Shiny rate (1/x)	The chance of an event Poké Gift containing a Shiny Pokémon with the formula 1/x.	1/10
eventTime	Event Poké Gift custom date (D/M)	If desired, a specified date for event Poké Gifts to spawn can be used for the option in the form day/month.	None
pokeGiftHaveEvents	Enable Poké Gift events	Whether or not Poké Gifts can be placed and opened.	True
pokeGiftReusable	Poké Gifts 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
scaleGrassBattles	Scale grass battle levels to player	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

PokéLoot

Settings for controlling PokeLoot chest spawns and behavior.

Setting (.hocon)	Setting (in-game)	Description	Default value
spawnGrotto	Spawn Hidden Grottos	Whether or not Hidden Grottos spawn naturally.	True
spawnHidden	Spawn invisible PokéLoot	Whether or not invisible PokéLoot chests spawn naturally.	True
spawnMode	PokéLoot spawn mode	The default setting for how PokéLoot chests act once looted. First Come, First Served (FCFS)-Chest disappears once looted by a player. Permanent, Limit 1 Drop (PL1D)-Chest doesn't disappear, but each individual player can only loot it once. Permanent, Unlimited Drops (PUD)-Chest doesn't disappear, can be looted infinitely by players. Timed Loot (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).	0 (First Come, First Served)
spawnNormal	Spawn normal Pokéloot	Whether or not visible PokéLoot chests spawn naturally.	True
spawnRate	PokéLoot spawn rate	The frequency at which PokéLoot chests spawn. Value Name Chunks/Chests 0 Minimal 64 1 Normal 32 2 More 18 3 Extreme 10	1 (Normal)
timedLootReuseHours	Reuse cooldown	How often players can loot PokéLoot chests that are set to have timed loot. This value is in hours. Duration Seconds 1 hour 3,600 1 day 86,400 1 week 604,800	86,400 seconds (1 day)

Pokérus

All sort of settings regarding Pokérus.

Setting (.hocon)	Setting (in-game)	Description	Default value
pkrsEnabled	Enable Pokerus	Whether or not the Pokérus is enabled. This blocks the growth, the spread and the spawning of the Pokérus.	True
pkrsInformPlayers	Inform players of Pokerus	Whether or not the player should be informed if their Pokémon got Pokérus.	True
pkrsSpawnRate	Pokerus spawn rate	Pokérus spawn rate (1/x). (0 to disable)	12288
pkrSpreadRate	Pokerus 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

Quests

Settings that alter how quests function.

Setting (.hocon)	Setting (in-game)	Description	Default value
questMaxRange	Quest max range	The maximum distance a player can get before a quest can be found on a new NPC if not taken.	500
questRandomNPCs	Random Quest NPCs	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 (.hocon)	Setting (in-game)	Description	Default value
denAdditionalSpawnChanceOnLiquid	Den on liquid spawn chance modifier	Modifier of the den spawn chance if the den is going to spawn on liquid.	0.5
denRespawnChance	Den respawn chance	Chance of a den respawning their boss when the den respawn time is hit.	0.25
denRespawnTime	Den respawn time	Time of day when dens attempt to respawn their boss.	100
denSpawnChancePerChunk	Den spawn chance per chunk	Chance of a den spawning per chunk.	0.029999999329447746
denStarDrops	Den star drops	Number of item drops for each star level in raids.	2, 4, 6, 8, 10
denStarWeights	Den star weights	Weights of each star level appearing in raids.	10, 8, 6, 4, 2
raidBlacklist	Raid blacklist	Species which can never appear in raids.	MissingNo
raidCatchHealthPercentage	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
raidDensBreakable	Dens breakable	Whether or not dens can be broken with repeat pickaxe hits.	True
raidGigantamaxFactorChances	Raid Gigantamax Factor rates	Gigantamax Factor rates per raid star level.	512, 512, 512, 256, 128
raidHAChances	Raid HA rates	HA rates per raid star level.	150, 125, 100, 75, 50
raidHaveLegendaries	Raids have legendaries	Whether raids can have legendaries.	True
raidHaveUltraBeasts	Raids have Ultra Beasts	Whether raids can have Ultra Beasts.	True
raidMasterBallBlock	Raid Master/Park Ball block	Star levels at which Master Balls/Park Balls cannot be used.	false, false, false, false, false
raidOnlyLeaderCanCatch	Raid leader only catch	Star levels at which only the leader of the raid has a catch attempt.	false, false, false, false, false
raidShinyChances	Raid shiny rates	Shiny rates per raid star level	4096, 4096, 2048, 1024, 1024

Riding

Settings that control Pokémon mounts.

Setting (.hocon)	Setting (in-game)	Description	Default value
allowRiding	Allows Riding of Pokémon	Allow players to ride Pokémon. If false, no Pokémon can be ridden.	True
enablePointToSteer	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
flyingSpeedLimit	Maximum Flying Speed	Sets the flying speed limit for a mounted Pokémon in the new flying system.	4
landMount	Allows land mounts.	If enabled, allows riding Pokémon mounts that do not have the ability to fly or surf.	True
requireHM	Need HM to ride	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
ridingSpeedMultiplier	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

Spawning

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

Setting (.hocon)	Setting (in-game)	Description	Default value
Gen1	Generation 1	Whether or not Generation 1 Pokémon (#1-#151) can spawn.	True
Gen2	Generation 2	Whether or not Generation 2 Pokémon (#152-#251) can spawn.	True
Gen3	Generation 3	Whether or not Generation 3 Pokémon (#252-#386) can spawn.	True
Gen4	Generation 4	Whether or not Generation 4 Pokémon (#387-#493) can spawn.	True
Gen5	Generation 5	Whether or not Generation 5 Pokémon (#494-#649) can spawn.	True
Gen6	Generation 6	Whether or not Generation 6 Pokémon (#650-#721) can spawn.	True
Gen7	Generation 7	Whether or not Generation 7 Pokémon (#722-#809) can spawn.	True
Gen8	Generation 8	Whether or not Generation 8 Pokémon (#810-#898) can spawn.	True
allowLegendarySpawn	Allow Legendaries to spawn	Whether or not Legendary Pokémon will spawn naturally. This only affects Pokémon that use the Legendary spawn rate.	True
bellInclusionRange	Range bells seek other bells	Range in blocks that Clear/Tidal Bells will seek out other bells.	10
bellSuccessChance	Chance that bells has a spawn	Chance that a bell, at dawn, will start to ring. 1 = 100%.	0.01
bossCandyChances	Boss Rare 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
bossLevelIncreases	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
bossRate	Spawn rate of Boss Pokémon	The rate of boss Pokémon in the wild (1/x) not including mega bosses.	256
bossSpawnChance	Boss spawn chance	Chance that a Mega Boss spawn attempt will succeed. 1 = 100%	0.30000001192092896
bossSpawnTicks	Boss spawn ticks	How often (on average) a boss Pokémon will attempt to spawn.	10000 (8 minutes, 20 seconds)
bossWeights	Boss weights	Relative spawn chances of each boss tier.	16, 12, 8, 4, 2, 1
bossesAlwaysMegaIfPossible	Bosses must mega if possible	Whether bosses that spawn must Mega Evolve if they can.	True
canTransformToDittoOnCatch	Transform into Ditto	Pokemon which can transform to Ditto.	Pidgey Rattata Gastly Zubat Mankey Yanma Hoothoot Sentret Zigzagoon Gulpin Whismur Taillow Remoraid Starly
caveMaxMultiplier	Cave max level multiplier	The max level multiplier when you're at a lower level in caves	4
despawnOnFleeOrLoss	Despawn on flee or loss	Whether or not wild Pokémon will despawn if the player flees from them or loses against them.	False
displayLegendaryGlobalMessage	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
distancePerLevel	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
doLegendaryRaidEvent	Display Raid Legendary global message	Displays server-wide announcement 'A Legendary has spawned in a Max Raid Den in a <name> biome' when a Legendary spawns in one.	True
entitiesPerPlayer	Maximum amount of NPC and/or Pokémon per player	The maximum number of entities (NPC or Pokémon) that can spawn per player. Lower for better performance.	45
gigantamaxFactorSpawnRate	Gigantamax Factor spawn rate	Chance of a wild Pokémon spawning with the Gigantamax Factor (1/rate). 0 disables Gigantamax Factor spawns.	512
hiddenAbilitySpawnRate	Hidden Ability spawn rate	The rarity of hidden Abilities on wild or spawned-in Pokémon, using the formula 1/x Pokémon. This setting does not affect breeding.	150 (1/150 Pokémon)
horizontalSliceRadius	Horizontal radius for random spawning	The horizontal radius of the areas randomly selected near the player to do spawning in. Lower for better performance but less reliable spawning.	10
horizontalTrackFactor	Amount of ticks for tracking spawner	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
ilexShrineSpawnRate	Ilex Shrine Spawn Rate	Chance per valid chunk to contain an Ilex Shrine.	0.005
injectIntoLootTables	Enables Pixelmon loot table modifier	Whether or not Pixelmon should modify Minecraft loot tables.	True
legendaryDespawnTicks	Legendary despawn ticks	Number of ticks until legendaries will despawn.	6000 (5 minutes)
legendarySpawnChance	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 (30%)
legendarySpawnTicks	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.	25,000 ticks (20 minutes and 50 seconds)
lootIgnoreList	Type of loot Pixelmon shouldn't modify	Which types of loot, such as "simple_dungeon", that Pixelmon should not modify.	None
lureFluteDuration	Black/White Flute duration	How long the effects of the Black/White Flute last for in seconds once used.	180
lureFluteLevelModifier	Black/White Flute level modifier	By how many levels the Black/White Flute can affect spawns by.	10
maxLevelByDistance	Maximum spawn level (by distance)	The maximum level that Pokémon can spawn at when the spawnLevelsByDistance option is enabled.	60
maximumDistanceFromCentre	Max distance for spawns	The maximum distance from the player that entities may spawn.	64
maximumSpawnedFlyingPokemon	Max Flying Pokémon per player	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
maximumSpawnedFlyingPokemonPerPlayer	Maximum Spawned Flying Pokémon	The maximum number of Flying Pokémon that can spawn per player. Lower for better performance.	45
maximumSpawnedPokemon	Maximum Pokémon that can be spawned in at once	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
MeltanSpawnChance	Meltan Spawn Chance	Chance for a Meltan to spawn when smelting a metal ore block. 1/x	3072
meltanTransformChance	Chance Meltan transforms to Ditto	Percentage chance for a Meltan to transform into Ditto on capture. 1 = 100%	0.25
minimumDistanceBetweenSpawns	Minimum distance for spawns	The minimum number of blocks between a spawned entity and an existing living entity.	15
minimumDistanceFromCentre	Minimum distance for spawning	The minimum distance from the player that entities may spawn. The lower this is, the closer entities will spawn to players.	18
replaceMCVillagers	Replace Minecraft villagers	Whether to replace Minecraft's villagers with chatting NPCs in villages.	True
shinySpawnRate	Shiny spawn rate (1/x)	The rarity of Shiny Pokémon, using the formula 1/x Pokémon.	4096 (1/4096 Pokémon)
spawnFrequency	Number of spawns per minute	The number of spawn passes made per minute. Decrease for better performance.	60
spawnGyms	Spawn Gyms	Whether Gyms can spawn naturally.	True
spawnLevelsByDistance	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
spawnLevelsCloserToPlayerLevels	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
spawnPokeMarts	Spawn shopkeepers	Whether Poké Marts can spawn in towns.	True
spawnSetFolder	Folder path for spawning files	Which folder to use under ./pixelmon/spawning/ for spawn sets.	default
spawnTicksPlayerMultiplier	Speeds up legendary and mega boss spawns	A multiplier that speeds up legendary and mega boss spawning based on player count. ticks = spawnTicks / (1 + (number of players - 1) * spawnTicksPlayerMultiplier)	0.009999999776482582
spawnZygardeCells	Spawn Zygarde Cells in the wild	Allow Zygarde Cells to spawn randomly in the world.	True
spawnsPerPass	Number of spawns in a single cycle per player	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
transformToDittoOnCatch	Chance for Pokémon to transform into Ditto	Chance for a wild Pokemon to turn into a Ditto on capture.	0.001
useRecentLevelMoves	Pokémon will spawn with most recent moves in their movepools	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
verticalSliceRadius	Vertical radius in blocks for spawning	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
verticalTrackFactor	Number of ticks that precede spawning vertically	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

Starters

Setting (.hocon)	Setting (in-game)	Description	Default value
level	Starter level	The initial level that Trainers' starter Pokémon will be at. This can be between levels 5 and 100.	5
shiny	Shiny starters	If enabled, Trainers' starter Pokémon will always be Shiny.	False
starterList	Starter list	The choices that players will have for their starter Pokémon. There can be a maximum of 24 choices. If a Pokémon has multiple forms, the form can be defined by placing the corresponding form index directly after the Pokémon's name (e.g., Unown10 for Unown K).	Bulbasaur Squirtle Charmander Chikorita Totodile Cyndaquil Treecko Mudkip Torchic Turtwig Piplup Chimchar Snivy Oshawott Tepig Chespin Fennekin Froakie Rowlet Litten Popplio Grookey Scorbunny Sobble
starterMarks	Starter Marks	Whether starter Pokémon get the Destiny mark or not.	True
useCustomStarters	Use custom starters	Whether the starter list should be loaded from this config.	False

Storage

Setting (.hocon)	Setting (in-game)	Description	Default value
asyncInterval	N/A	The interval in seconds that the async saver will save all queued data to disk.	60
useAsyncSaving	N/A	Activates off-main thread saving of party and computer data. (server only)	False

Legacy Options

Sounds

Setting (.hocon)	Setting (in-game)	Description	Default value
removeVanillaMusic	Remove vanilla music	Whether or not vanilla Minecraft music (not including music discs) can randomly play instead of Pixelmon music.	True