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 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.

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

Breeding

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
allowRanchCrafting	Allow ranch crafting	Whether or not ranch blocks can be crafted.	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
allowRandomSpawnedEggsToBeLegendary	/pokegiveegg can give Legendaries	Whether or not Eggs spawned with a gift box or the random Egg feature of /pokegiveEgg have a chance of hatching Legendary Pokémon.	False
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)
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
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

Database

These settings deal with saving Pixelmon data (e.g., Pokémon in players' parties and PC) to an external database.

Setting (.hocon)	Setting (in-game)	Description	Default value
connectionString	Connection string	The URL that specifies the location of the database that Pixelmon data will be saved to. Can be either an H2 database or a MySQL database (jdbc:type://hostname:port/dbname?user=username&password=password).	jdbc:h2://
saveToExternalDatabase	Use above database for saving	Whether or not to save Pixelmon data to the external database specified in the "Connection string" setting.	False

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 moves

Setting (.hocon)	Setting (in-game)	Description	Default value
allowExternalMoves	Allow external moves	Whether or not players are able to use their Pokémon's external moves.	True

General

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
allowEventMoveTutors	Allow event move tutors to spawn	Whether or not event move tutors spawn naturally.	False
allowGemCrafting	Allow Gem crafting	Whether or not Gems can be crafted.	True
allowPayDayMoney	Allow Pay Day money	Whether or not Pay Day will award PokéDollars to the player.	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
allowPvPExperience	Enable PvP exp.	Whether or not Pokémon can gain experience when battling other players.	True
allowRareCandyCrafting	Enable Rare Candy crafting	Whether or not players are allowed to craft Rare Candies.	True
allowRiding	Allow Pokémon to be ridden	Whether or not players can mount Pokémon.	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.	False
allowTrainerExperience	Enable Trainer exp.	Whether or not NPC Trainers' Pokémon award experience upon defeat.	True
allowVanillaMobs	Enable vanilla mobs	Whether or not regular Minecraft mobs like cows and zombies can spawn naturally. 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
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)
bedsHealPokemon	Beds heal Pokémon	Whether or not beds will fully heal Pokémon when slept in.	True
cloningMachineEnabled	Enable cloning machine	Whether or not cloning machines can be crafted and used. Disabling this setting prevents Mewtwo from being legitimately obtainable.	True
chunkSpawnRadius	Pokémon chunk spawn distance	The chunk radius around a player where Pokémon can spawn.	8
computerBoxes	Amount of PC boxes	The number of boxes a player has access to in the PC, up to a maximum of 256.	16
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
enablePointToSteer	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
enablePokedexWikiWebsiteOpen	Allow Pokédex to open wiki	If disabled, all methods of opening up the Pixelmon/Minecraft wikis from within Pixelmon are disabled.	True
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
expModifier	Experience modifier	Pokémon experience gain in battle will be multiplied by this number.	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)
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
maxLevel	Maximum level	The maximum level that a Pokémon can be.	100
multiplePhotosOfSamePokemon	Allow duplicate Pokémon photos	Whether a player can take multiple photos of a single Pokémon.	True
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)
needHMToRide	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
npcRarity	NPC rarity	How commonly NPC Trainers and move tutors spawn naturally. This can be a value between 0 and 200, where 0 disables natural NPC spawning and 200 is the maximum possible spawn rate.	50
pickupRate	Pickup rate	The rate (1/x) that Pickup will collect special drops at.	10
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.	False
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
reusableBirdShrines	Allow bird shrine reuse	Whether or not shrines can be used multiple times. Players will still have to acquired a new charged orb each time to use the shrine.	False
scalePokémonModels	Increase model size by 30%	If this option is enabled, Pokémon will be 30% larger than if the option was disabled.	True
showWildNames	Show wild Pokémon names	If enabled, text labeling wild Pokémon's names will be displayed outside of battle.	False
spawnBirdShrines	Spawn bird shrines	Whether or not shrines can spawn naturally. If disabled, shrines that already exist can still be used.	True
spawnGemShrines	Spawn Gem shrines	Whether or not Gem structures can spawn naturally. Enabling this setting also allows the use of the /halloween command.	False
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
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
useCustomTabList	Use custom tab list	If enabled, a different GUI will be used when viewing the list of online players.	True
useExternalJSONFiles	Use external JSON files	If enabled, the NPC, special drop, and structure JSON files can be edited in the "pixelmon" folder in the Minecraft directory. If these directories do not already exist, they will be created after enabling this option.	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
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

Setting (.hocon)	Setting (in-game)	Description	Default value
drawHealthBars	Draw Pokémon health bars	Whether or not HP bars will be displayed above Pokémon.	False
lowResTextures	Potato mode	Whether or not Pokémon and Poké Balls use low-resolution (256 × 256) textures instead of normal (512 × 512) textures, making them appear less detailed.	False
playerControlCamera	Player-controlled battle camera	Whether or not the camera can be manually moved by the player during battles.	True
renderDistanceWeight	Render distance weight	A number that is multiplied to the default render distance (64) to produce a final render distance.	2
showCurrentAttackTarget	Show current attack target	Whether or not a Pokémon's attack target ('F' key by default) is shown on the screen.	True
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
useOriginalPokemonTexturesForStatues	Statues use original textures	Whether or not statues (spawned with the /pokespawn command) use the actual Pokémon textures and colors. If disabled, statues are always gray.	False
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

PixelUtilities

Setting (.hocon)	Setting (in-game)	Description	Default value
blocksHaveLegendaries	Allow Legendaries from blocks	Whether Pixelmon Grass can contain Legendary Pokémon.	False
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

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)
timedLootReuseSeconds	Reuse cooldown	How often players can loot PokéLoot chests that are set to have timed loot. This value is in seconds. Duration Seconds 1 hour 3,600 1 day 86,400 1 week 604,800	86,400 seconds (1 day)

Sounds

Setting (.hocon)	Setting (in-game)	Description	Default value
maxMusicDelay	Maximum music delay	The maximum number of ticks that can pass before another music track will play after the previous one finishes.	24000 (20 minutes)
minMusicDelay	Minimum music delay	The minimum number of ticks that can pass before another music track will play after the previous one finishes.	12000 (10 minutes)
removeVanillaMusic	Remove vanilla music	Whether or not vanilla Minecraft music (not including music discs) can randomly play instead of Pixelmon music..	True

Spawning

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
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
bossSpawnRate	Boss spawn rate (1/x)	The rarity of boss Pokémon, using the formula 1/x Pokémon.	250 (1/250 Pokémon)
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
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)
increaseVillageSpawnRate	Increase village spawn rate	Whether to make towns spawn more often than they do in vanilla Minecraft.	True
legendaryRepeatSpawnTicks	Legendary repeat spawn ticks	The minimum amount of ticks that must pass before a particular Legendary Pokémon species can spawn again after previously spawning.	96,000 ticks (80 minutes)
legendarySpawnChance	Legendary spawn chance	The chance of a Legendary Pokémon spawn attempt succeeding (0-1). The frequency of this spawn attempt is defined by the "legendarySpawnTicks" setting.	0.3 (30%)
legendarySpawnTicks	Legendary spawn ticks	How often (in ticks) a Legendary Pokémon attempts to spawn. The chance of this attempt succeeding is defined by the "legendarySpawnChance" setting.	3,000 ticks (2 minutes and 30 seconds)
maxFlyingPokemon	Max flying Pokémon	The maximum number of naturally spawning air persistent spawns) that can exist at once.	2
maxLandPokemon	Max land Pokémon	The maximum number of naturally spawning land Pokémon + air Pokémon that can exist at once.	40
maxLevelByDistance	Maximum spawn level (by distance)	The maximum level that Pokémon can spawn at when the spawnLevelsByDistance option is enabled.	60
maxSpawnsPerTick	Max Pokémon spawns per tick	The maximum number of Pokémon that can spawn naturally per tick.	100
maxUndergroundPokemon	Max underground Pokémon	The maximum number of naturally spawning underground Pokémon that can exist at once.	20
maxWaterPokemon	Max water Pokémon	The maximum number of naturally spawning water Pokémon that can exist at once.	20
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.	8192 (1/8192 Pokémon)
spawnDimensions	Dimensions to spawn in	Dimensions (by number) that Pokémon will spawn naturally in. If there are no dimensions in the setting, no Pokémon will spawn naturally. This setting does not affect Pixelmon spawners. Value Dimension 0 Overworld -1 Nether 1 End	0 (Overworld)
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
spawnPokeMarts	Spawn shopkeepers	Whether Poké Marts can spawn in towns.	True
spawnTickRate	Spawn ticks	The rate (in ticks) that Pokémon spawning will be ticked at.	60 (3 seconds)

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 15 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