Config

The pixelmon.cfg 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, a reduced version of the config file can be edited by selecting the wrench icon in the lower-right corner of the screen, while the full config file can be accessed at Roaming->.pixelmon->Profile name->config.

The pixelmon.cfg file itself can be opened with a text editor such as Notepad or TextEdit. These settings can only be changed when the target world is not online; changing them 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.

Config setting	Description	Default value
AFK activation time length	The amount of time (in seconds) that a player can be unresponsive in battle before the AFK handler takes control.	90 seconds
AFK activation turn time	The amount of time that the AFK handler takes to make a move.	15 seconds
AFK handler active	Whether or not the AFK handler is enabled.	False

Breeding

Config setting	Description	Default value
Allow crafting and placing of ranch blocks	Whether or not ranch blocks can be crafted and used.	True
Allow crafting of ranch blocks	Whether or not ranch blocks can be crafted.	True
Allow placing of ranch blocks	Whether or not ranch blocks can be placed in the world.	True
Allow ranch expansion	Whether or not ranch upgrades exist.	True
Allow random breeding Eggs to have a chance to be a Legendary	Whether or not Eggs made from two Ditto breeding together have a chance of hatching Legendary Pokémon.	False
Allow random spawned Eggs to have a chance to be a Legendary	Whether or not Eggs spawned with the random Egg feature of /pokegiveEgg have a chance of hatching Legendary Pokémon.	False
Number of 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
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 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
World ticks till breeding level increased	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)

Database

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

Config setting	Description	Default value
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://
Save to external database	Whether or not to save Pixelmon data to the external database specified in the "Connection string" setting.	False

Elevator

Config setting	Description	Default value
Search range	The maximum distance that two elevators can link together at.	10

External moves

Config setting	Description	Default value
Allows the use of external moves	Whether or not players are able to use their Pokémon's external moves.	True

General

Config setting	Description	Default value
Allow capturing outside of battle	Whether or not players are allowed to throw Poké Balls and capture Pokémon outside of battle.	True
Allow crafting of Rare Candy	Whether or not players are allowed to craft Rare Candies.	True
Allow Gem boss drop	Whether or not Gems are dropped by boss Pokémon and found with Pickup.	False
Allow Gems to be crafted	Whether or not Gems can be crafted.	True
Allow PVP experience	Whether or not Pokémon can gain experience when battling other players.	True
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
Allow ranch upgrade boss drop	Whether or not boss Pokémon can drop ranch upgrades.	True
Allow riding	Whether or not players can mount Pokémon.	True
Allow structures to spawn	Whether or not structures (Pokémon Centers and shrines) can spawn naturally.	True
Allow Trainer experience	Whether or not NPC Trainers' Pokémon award experience upon defeat.	True
Allow 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
Allow Pokémon nicknames	Whether or not the player can nickname owned Pokémon. This setting is client-side.	True
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
Allow 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.	False
Allows the Pokédex and Pokédex ability to open wiki pages	If disabled, all methods of opening up the Pixelmon/Minecraft wikis from within Pixelmon are disabled.	True
Bird shrines are reusable	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
Cloning machines enabled	Whether or not cloning machines can be crafted and used. Disabling this setting prevents Mewtwo from being legitimately obtainable.	True
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
Force-ended 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)
Give a starter on join	Whether or not players will pick their starter Pokémon immediately upon entering a world.	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
Have HM to ride	Whether or not a Pokémon has to know either Fly or Surf to be ridden. Most land mounts become unusable if this setting is enabled.	False
Let bosses drop Isi's hourglass	Whether or not boss Pokémon drop Isi's Silver Hourglass and Isi's Golden Hourglass.	True
Must be opped to use spawners	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
Nameplate visible range modifier	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)
Poké Ball engage	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
Pokémon drops enabled	Whether or not certain Pokémon can drop items upon defeat.	True
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.	False
Remove Minecraft music	Whether or not vanilla Minecraft music (not including music discs) can randomly play instead of Pixelmon music. This option is currently always enabled regardless of what it is set to in the config file.	True
Return held items in PVP	If enabled, consumable held items used up during player vs. player battles will be restored when the battle ends.	True
Scale models up	If this option is enabled, Pokémon will be 30% larger than if the option was disabled.	True
Spawn bird shrines	Whether or not shrines can spawn naturally. If disabled, shrines that already exist can still be used.	True
Spawn Gem shrines	Whether or not Gem structures can spawn naturally. Enabling this setting also allows the use of the /halloween command.	False
Spin battle camera	Whether or not the camera rotates around the Pokémon combatants during battles. This setting is client-side.	True
System time sync interval	How often Minecraft time will sync to real time (in seconds) if real time syncing is enabled.	30
The amount of computer boxes	The number of boxes a player has access to in the PC, up to a maximum of 256.	16
Traders are reusable	Whether or not traders can be used multiple times. If disabled, traders will disappear after completing their trade offers.	False
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
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
Use the custom tab list	If enabled, a different GUI will be used when viewing the list of online players.	True
Wild Pokémon initiate battles	Whether or not aggressive wild Pokémon initiate battles against players.	True
Wild Pokémon can try and flee from battles	Whether or not Pokémon may attempt to flee from battle. The chance of attempting to flee is increased when the wild Pokémon is lower-leveled than the player's Pokémon or low on health. This setting unintentionally affects NPC Trainers as well.	False
Write entities to world save	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

Config setting	Description	Default value
Enable smooth shading for Poké Balls	Whether or not Poké Balls use SMD normal maps in their models, making them appear smoother.	True
Enable smooth shading for Pokémon	Whether or not Pokémon use SMD normal maps in their models, making them appear smoother.	True
Render distance weight	A number that is multiplied to the default render distance (64) to produce a final render distance.	2
Show current attack target	Whether or not a Pokémon's attack target ('F' key by default) is shown on the screen.	True
Use low-res textures	Whether or not Pokémon and Poké Balls use low-resolution (256 × 256) textures, making them appear less detailed.	False
Use original Pokémon textures for statues	Whether or not statues (spawned with the /pokespawn command) use the actual Pokémon textures and colors. If disabled, statues are always gray.	False

IDs

These are entity IDs for certain aspects of Pixelmon. These should not be modified without ample knowledge of how entity IDs work.

Config setting	Default value
Camera ID	202
Pixelmon ID	200
Poké Ball ID	201
Trainer ID	199

PixelUtilities

Config setting	Description	Default value
Are 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
Custom event Poke Gift time	If desired, a specified date for event Poké Gifts to spawn can be used for the option in the form day/month.	None
Event Poké Gift Shiny rate	The chance of an event Poké Gift containing a Shiny Pokémon with the formula 1/x.	1/10
Event Poké Gift coords	Locations where event Poké Gifts will spawn.	None
Event Poké Gift has Legendaries	If enabled, it is possible for event Poké Gifts to contain Legendary Pokémon.	False
Event Poké Gift has Shinies	Whether or not it is possible for event Poké Gifts to contain Shiny Pokémon	False
Max event Poké Gift 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
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
Event Poké Gift load	Whether or not event Poké Gifts spawn.	False
Have events	Whether or not Poké Gifts can be placed and opened.	True

PokéLoot

Config setting	Description	Default value
Chest 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)
Default 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)
Hidden Grotto - enabled	Whether or not Hidden Grottos spawn naturally.	True
Hidden PokéChest - enabled	Whether or not invisible PokéLoot chests spawn naturally.	True
Normal PokéChest - enabled	Whether or not visible PokéLoot chests spawn naturally.	True
Timed loot	How often players can loot PokéLoot chests that are set to have timed loot. This value is in seconds. Duration Seconds 1 hour 3600 1 day 86400 1 week 604800	86400 seconds (1 day)

Spawning

Config setting	Description	Default value
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
Despawn on flee or loss	Whether or not wild Pokémon will despawn if the player flees from them or loses against them.	False
Dimensions Pokémon will spawn in	Dimensions (by number) that Pokémon will spawn naturally in. Multiple or no dimensions are both acceptable. This setting does not affect Pixelmon spawners. Value Dimension 0 Overworld -1 Nether 1 End	0 (Overworld)
Display global message on Legendary spawn	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
Gen1	Whether or not Generation 1 Pokémon (#1-#151) can spawn.	True
Gen2	Whether or not Generation 2 Pokémon (#152-#251) can spawn.	True
Gen3	Whether or not Generation 3 Pokémon (#252-#386) can spawn.	True
Gen4	Whether or not Generation 4 Pokémon (#387-#493) can spawn.	True
Gen5	Whether or not Generation 5 Pokémon (#494-#649) can spawn.	True
Gen6	Whether or not Generation 6 Pokémon (#650-#721) can spawn. This option is currently useless as no Generation 6 Pokémon will be implemented until Generation 7 is released.	True
Legendary spawn rate	How often Legendary Pokémon spawn (affects natural spawns only). This number follows the formula of 1/x Pokémon.	22000 (1/22000 Pokémon)
Max number of air Pokémon	The maximum number of naturally spawning air persistent spawns) that can exist at once.	2
Max number of land Pokémon	The maximum number of naturally spawning land Pokémon + air Pokémon that can exist at once.	40
Max number of underground Pokémon	The maximum number of naturally spawning underground Pokémon that can exist at once.	20
Max number of water Pokémon	The maximum number of naturally spawning water Pokémon that can exist at once.	20
Shiny spawn rate	The rarity of Shiny Pokémon, using the formula 1/x Pokémon.	8192 (1/8192 Pokémon)
Spawn boss rate	The rarity of boss Pokémon, using the formula 1/x Pokémon.	250 (1/250 Pokémon)
Spawn hidden Ability 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)

Sounds

Config setting	Description	Default value
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)
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)

Starters

Config setting	Description	Default value
Level	The initial level that Trainers' starter Pokémon will be at. This can be between levels 5 and 100.	5
Shiny	If enabled, Trainers' starter Pokémon will always be Shiny.	False
1 - First choice	A choice for Trainers' starter Pokémon.	Bulbasaur
2 - Second choice	A choice for Trainers' starter Pokémon.	Squirtle
3 - Third choice	A choice for Trainers' starter Pokémon.	Charmander
4 - Fourth choice	A choice for Trainers' starter Pokémon.	Chikorita
5 - Fifth choice	A choice for Trainers' starter Pokémon.	Totodile
6 - Sixth choice	A choice for Trainers' starter Pokémon.	Cyndaquil
7 - Seventh choice	A choice for Trainers' starter Pokémon.	Treecko
8 - Eighth choice	A choice for Trainers' starter Pokémon.	Mudkip
9 - Ninth choice	A choice for Trainers' starter Pokémon.	Torchic
10 - Tenth choice	A choice for Trainers' starter Pokémon.	Turtwig
11 - Eleventh choice	A choice for Trainers' starter Pokémon.	Piplup
12 - Twelfth choice	A choice for Trainers' starter Pokémon.	Chimchar
13 - Thirteenth choice	A choice for Trainers' starter Pokémon.	Snivy
14 - Fourteenth choice	A choice for Trainers' starter Pokémon.	Oshawott
15 - Fifteenth choice	A choice for Trainers' starter Pokémon.	Tepig