Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

{{#seo:
 |title=Config
 |title_mode=replace
 |keywords=config, pixelmon, minecraft mod
 |description=This page covers the Config file of Pixelmon.
}}
<languages/>
The Pixelmon config file, <code>pixelmon.hocon</code>, 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 <code>config</code> 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 <code>config</code> folder.

The config file can be edited inside ''Minecraft'' by pressing a certain hotkey (<code>P</code> 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 {{tt|AFK|Away From Keyboard}} 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.
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>afkActivateSeconds</code>
|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
|-
|<code>afkHandlerTurnSeconds</code>
|AFK turn seconds
|The amount of time that the AFK handler takes to make a move.
|15 seconds
|-
|<code>enableAFKHandler</code>
|AFK handler enabled
|Whether or not the AFK handler is enabled.
|<code>False</code>
|}

===[[Breeding]]===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>allowBreeding</code>
|Allow breeding
|Whether or not [[ranch blocks]] can be crafted and used.
|<code>True</code>
|-
|<code>allowDittoDittoBreeding</code>
|Allow Ditto-Ditto breeding
|Whether or not two [[Ditto]] can [[breed]] together to produce [[Eggs]] with random Pokémon inside them.
|<code>True</code>
|-
|<code>allowRanchExpansion</code>
|Enable ranch expansion
|Whether or not [[ranch upgrades]] exist.
|<code>True</code>
|-
|<code>allowRandomBreedingEggsToBeLegendary</code>
|Ditto-Ditto can contain Legendaries
|Whether or not [[Eggs]] made from two [[Ditto]] [[breeding]] together have a chance of hatching [[Legendary Pokémon]].
|<code>False</code>
|-
|<code>breedingTicks</code>
|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)
|-
|<code>maxCumulativePokemonInRanch</code>
|Maximum cumulative Pokemon In ranch blocks
|Maximum Pokemon a player can have in all ranches across the world. Max of 0 is unlimited.
|0
|-
|<code>numBreedingStages</code>
|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
|-
|<code>stepsPerEggCycle</code>
|Steps per Egg cycle
|[https://bulbapedia.bulbagarden.net/wiki/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
|-
|<code>useBreedingEnvironment</code>
|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!"
|<code>True</code>
|}

===[[Elevator]]===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>elevatorSearchRange</code>
|Search range (up/down)
|The maximum distance that two elevators can link together at.
|10
|}

===[[Move Skills]]===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>allowDestructiveExternalMoves</code>
|Allow destructive Move Skills
|Whether or not players are allowed to use the following [[Move Skills]]:
*{{e|Cut|Cut (external move)}}
*{{e|Dig|Dig (external move)}}
*{{e|Explode}}
*{{e|Light Fire}}
*{{e|Rock Smash|Rock Smash (external move)}}
*{{e|Thunder Bolt}}
|<code>True</code>
|-
|<code>allowExternalMoves</code>
|Allow Move Skills
|Whether or not players are able to use [[Move Skills]].
|<code>True</code>
|}

===General===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>allowAnvilAutoreloading</code>
|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.
|<code>False</code>
|-
|<code>allowCaptureOutsideBattle</code>
|Allow capture outside battle
|Whether or not players are allowed to throw [[Poké Balls]] and capture Pokémon outside of battle.
|<code>True</code>
|-
|<code>allowChisels</code>
|Allow placing of Chisels (Pokémon statues)
|Whether or not players can place Chisels using a [[Chisel]].
|<code>True</code>
|-
|<code>allowPayDayMoney</code>
|Allow Pay Day money
|Whether or not [[Pay Day]] will award [[PokéDollars]] to the player.
|<code>True</code>
|-
|<code>allowPlanting</code>
|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.
|<code>True</code>
|-
|<code>allowPokemonEditors</code>
|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.
|<code>True</code>
|-
|<code>allowPokemonNicknames</code>
|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.
|<code>True</code>
|-
|<code>allowPvPExperience</code>
|Enable PvP exp.
|Whether or not Pokémon can gain experience when battling other players.
|<code>True</code>
|-
|<code>allowRandomPokemonToBeLegendary</code>
|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.
|<code>True</code>
|-
|<code>allowShinyCharmFromPokedex</code>
|Allows Shiny Charm via Pokedex.
|If enabled, unlocks the [[Shiny Charm]] upon Pokédex completion.
|<code>True</code>
|-
|<code>allowTMReuse</code>
|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.
|<code>False</code>
|-
|<code>allowTrainerExperience</code>
|Enable Trainer exp.
|Whether or not [[NPC Trainers]]' Pokémon award experience upon defeat.
|<code>True</code>
|-
|<code>allowVanillaMobs</code>
|Enable vanilla mobs
|Whether or not regular ''Minecraft'' mobs like {{mc|Cow|cows}} and zombies can spawn naturally. {{mc|monster_spawner|Monster spawners}} containing {{mc|zombie|zombies}}, {{mc|skeleton|skeletons}}, or {{mc|spider|spiders}} will be converted into monsters spawners that spawn {{mc|pig|pigs}} if this setting is disabled. Other monster spawners (including ones that spawn hostile mobs like {{mc|Blaze|Blazes}}, {{mc|Cave_Spider|cave spiders}}, or {{mc|Silverfish|silverfish}}) will not be affected, nor will {{mc|Spawn_Egg|spawn eggs}}. The {{mc|Ender_dragon|Ender dragon}} also spawns naturally regardless of this setting.
|<code>False</code>
|-
|<code>alwaysHaveMegaRing</code>
|Allow automatic [[Mega Bracelet]].
|Whether or not players will automatically have a Mega ring.
|<code>False</code>
|-
|<code>averageLureExpiryTicks</code>
|Average ticks for lure expiration.
|How many ticks it will take for a lure to expire on average.
|17920 (14 minutes and 56 seconds)
|-
|<code>awardPhotos</code>
|Award photos to wild battle winners
|Whether or not wild Pokémon will [[drop]] [[photos]] when defeated.
|<code>False</code>
|-
|<code>battleAIBoss</code>
|Boss Pokémon battle AI
|The type of battle AI that [[boss Pokémon]] will use.
{| class="wikitable"
|-
!Value
!Name
!Description
|-
|style="text-align:center"|1
|style="text-align:center"|Random
|style="text-align:center"|The Pokémon will use moves randomly.
|-
|style="text-align:center"|2
|style="text-align:center"|Aggressive
|style="text-align:center"|The Trainer will use the move that deals the most damage to the opponent, avoiding status moves.
|-
|style="text-align:center"|3
|style="text-align:center"|Tactical
|style="text-align:center"|The Trainer will know how to use status moves alongside offensive moves.
|}
|2 (Aggressive)
|-
|<code>battleAITrainer</code>
|NPC Trainer battle AI
|The type of battle AI that naturally spawning [[NPC Trainers]] will use.
{| class="wikitable"
|-
!Value
!Name
!Description
|-
|style="text-align:center"|1
|style="text-align:center"|Random
|style="text-align:center"|The Trainer will use moves randomly.
|-
|style="text-align:center"|2
|style="text-align:center"|Aggressive
|style="text-align:center"|The Trainer will use the move that deals the most damage to the opponent, avoiding status moves.
|-
|style="text-align:center"|3
|style="text-align:center"|Tactical
|style="text-align:center"|The Trainer will know how to use status moves alongside offensive moves.
|-
|style="text-align:center"|4
|style="text-align:center"|Advanced
|style="text-align:center"|Along with knowing how to use moves like tactical AI, the Trainer will switch out Pokémon if advantageous.
|}
|3 (Tactical)
|-
|<code>battleAIWild</code>
|Wild Pokémon battle AI
|The type of battle AI that wild Pokémon will use.
{| class="wikitable"
|-
!Value
!Name
!Description
|-
|style="text-align:center"|1
|style="text-align:center"|Random
|style="text-align:center"|The Pokémon will use moves randomly.
|-
|style="text-align:center"|2
|style="text-align:center"|Aggressive
|style="text-align:center"|The Pokémon will use the move that deals the most damage to the opponent, avoiding status moves.
|-
|style="text-align:center"|3
|style="text-align:center"|Tactical
|style="text-align:center"|The Pokémon will know how to use status moves alongside offensive moves.
|}
|1 (Random)
|-
|<code>bedsHealPokemon</code>
|Beds heal Pokémon
|Whether or not {{mc|bed|beds}} will fully heal Pokémon when slept in.
|<code>True</code>
|-
|<code>berryTreeGrowthMultiplier</code>
|Berry tree growth multiplier
|Multiplier for the growth rate of [[Berry trees]]. A higher multiplier will make Berry trees grow (and die) faster.
|1
|-
|<code>canPokemonBeHit</code>
|Allows Pokémon hitting
|Whether or not out-of-battle wild Pokémon can be hurt by physical attacks.
|<code>False</code>
|-
|<code>chanceToGetSpecialBidoof</code>
|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
|-
|<code>cloningMachineEnabled</code>
|Enable cloning machine
|Whether or not [[cloning machines]] can be crafted and used. Disabling this setting prevents [[Mewtwo]] from being legitimately obtainable.
|<code>True</code>
|-
|<code>computerBoxes</code>
|Amount of PC boxes
|The number of boxes a player has access to in the [[PC]], up to a maximum of 256.
|30
|-
|<code>dataSaveOnWorldSave</code>
|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.
|<code>True</code>
|-
|<code>deleteUnwantedDrops</code>
|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.
|<code>False</code>
|-
|<code>despawnRadius</code>
|Despawn radius of Pokémon.
|The minimum number of blocks away from the nearest player a Pokémon can be when despawned.
|80
|-
|<code>disabledNonPlayerPixelmonMovement</code>
|Disables not owned Pokémon movement.
|Determines if non player owned pokemon's movement is disabled or not.
|<code>False</code>
|-
|<code>enableWildAggression</code>
|Enable aggressive wild Pokémon
|Whether or not aggressive wild Pokémon initiate battles against players.
|<code>True</code>
|-
|<code>engagePlayerByPokeBall</code>
|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).
|<code>False</code>
|-
|<code>expModifier</code>
|Experience modifier
|Pokémon experience gain in battle will be multiplied by this number.
|1
|-
|<code>forceEndBattleResult</code>
|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 <code>PlayerBattleEndedAbnormalEvent</code>.
|0 (determine winner based on Pokémon remaining)
|-
|<code>growthScaleModifier</code>
|Growth size variation
|How much [[growth (stat)|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
|-
|<code>lakeTrioMaxEnchants</code>
|Max gems from Lake Trio
|Sets The number of times a Azelf, Mesprit and Uxie can enchant a ruby.
|3
|-
|<code>maxLevel</code>
|Maximum level
|The maximum level that a Pokémon can be.
|100
|-
|<code>maximumPlants</code>
|Maximum plants
|The maximum number of [[Apricorn trees]] and [[Berry trees]] that can be planted in a world chunk.
|32
|-
|<code>movePerTutor</code>
|Moves tutor teaches.
|The amount of moves a [[Move Tutor]] will have.
|20
|-
|<code>multiplePhotosOfSamePokemon</code>
|Allow duplicate Pokémon photos
|Whether a player can take multiple [[photos]] of a single Pokémon.
|<code>True</code>
|-
|<code>npcEditorOpOnly</code>
|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.
|<code>True</code>
|-
|<code>pixelmon.config.oreColors.comment</code>
|Ore colour Ore Sense
|By editing the HEX colors noted after the Ore's ID the ore will have a different color when using Ore Sense.
|
 "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"
|-
|<code>pickupRate</code>
|Pickup rate
|The rate ({{frac|''x''}}) that [[Pickup]] will collect [[special drops]] at.
|10
|-
|<code>pokemonDropsEnabled</code>
|Enable Pokémon drops
|Whether or not certain Pokémon can [[drop]] items upon defeat.
|<code>True</code>
|-
|<code>printErrors</code>
|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.
|<code>False</code>
|-
|<code>returnHeldItems</code>
|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.
|<code>True</code>
|-
|<code>reusableBirdShrines</code>
|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.
|<code>False</code>
|-
|<code>spawnBirdShrines</code>
|Spawn bird shrines
|Whether or not [[shrines]] can spawn naturally. If disabled, shrines that already exist can still be used.
|<code>True</code>
|-
|<code>spawnStructures</code>
|Spawn Pixelmon structures in world
|Whether or not Pixelmon structures can spawn naturally.
|<code>True</code>
|-
|<code>spawnersOpOnly</code>
|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.
|<code>True</code>
|-
|<code>starterOnJoin</code>
|Starter list on join
|Whether or not players will pick their [[starter Pokémon]] immediately upon entering a world.
|<code>True</code>
|-
|<code>systemTimeSyncInterval</code>
|Seconds between time syncs
|How often Minecraft time will sync to real time (in seconds) if real time syncing is enabled.
|30
|-
|<code>tradersReusable</code>
|Traders are reusable
|Whether or not [[traders]] can be used multiple times. If disabled, traders will disappear after completing their trade offers.
|<code>False</code>
|-
|<code>useDropGUI</code>
|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.
|<code>True</code>
|-
|<code>useExternalJSONFiles</code>
|Use external JSON files
|If enabled, Pixelmon's [[external JSON files]] can be edited in the <code>pixelmon</code> folder in the ''Minecraft'' directory. If these directories do not already exist, they will be created after enabling this option.
|<code>False</code>
|-
|<code>useSystemTimeForBerries</code>
|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.
|<code>False</code>
|-
|<code>useSystemTimeForWorldTime</code>
|Use system time for world time
|Whether or not ''Minecraft'' time will sync to real time (as defined by the server's system time).
|<code>False</code>
|-
|<code>writeEntitiesToWorld</code>
|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.
|<code>False</code>
|}

===Graphics===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>drawHealthBars</code>
|Draw Pokémon health bars
|Whether or not HP bars will be displayed above Pokémon.
|<code>False</code>
|-
|<code>namePlateRange</code>
|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)
|-
|<code>playerControlCamera</code>
|Player-controlled battle camera
|Whether or not the camera can be manually moved by the player during battles.
|<code>True</code>
|-
|<code>rangeToDisplayAttackAnimations</code>
|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
|-
|<code>renderDistanceWeight</code>
|Render distance weight
|A number that is multiplied to the default render distance (64) to produce a final render distance.
|2
|-
|<code>renderWildLevels</code>
|Renders wild Pokémon levels.
|Whether or not wild Pokémon should show their level above their head.
|<code>True</code>
|-
|<code>scalePokemonModels</code>
|Increase model size by 30%
|If this option is enabled, Pokémon will be 30% larger than if the option was disabled.
|<code>True</code>
|-
|<code>showCurrentAttackTarget</code>
|Show current attack target
|Whether or not a Pokémon's attack target (<code>F</code> key by default) is shown on the screen.
|<code>True</code>
|-
|<code>useBattleCamera</code>
|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.
|<code>True</code>
|-
|<code>useSmoothShadingOnPokeBalls</code>
|Smooth shading on Poké Balls
|Whether or not [[Poké Balls]] use {{tt|SMD|Studio Model Data}} normal maps in their models, making them appear smoother.
|<code>True</code>
|-
|<code>useSmoothShadingOnPokemon</code>
|Smooth shading on Pokémon
|Whether or not Pokémon use {{tt|SMD|Studio Model Data}} normal maps in their models, making them appear smoother.
|<code>True</code>
|}

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

===OutsideEffects===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>poisonMaxDamage</code>
|Max Damage Poison does
|The maximum amount of damage Poison can do outside of battle to a poisoned Pokémon.
|5
|-
|<code>stepsToApplyEffects</code>
|Amount of steps for effects to be applied
|Amount of steps for effects such as Poison to be applied.
|15
|-
|<code>useOutsideEffects</code>
|Enables outside effects
|Whether or not outside effects is enabled or disabled.
|<code>True</code>
|}

===PixelUtilities===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>eventCoords</code>
|Event Poké Gift spawning coordinates
|Locations where [[event Poké Gifts]] will spawn.
|None
|-
|<code>eventHasLegendaries</code>
|Allow Legendaries in event Poké Gifts
|If enabled, it is possible for [[event Poké Gifts]] to contain [[Legendary Pokémon]].
|<code>False</code>
|-
|<code>eventHasShinies</code>
|Enable event Poké Gift Shinies
|Whether or not it is possible for [[event Poké Gifts]] to contain [[Shiny Pokémon]]
|<code>False</code>
|-
|<code>eventMaxPokemon</code>
|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
|-
|<code>eventPokeGiftLoad</code>
|Enable Poké Gift events
|Whether or not [[event Poké Gifts]] spawn.
|<code>False</code>
|-
|<code>eventShinyRate</code>
|Event Poké Gift Shiny rate (1/x)
|The chance of an [[event Poké Gift]] containing a [[Shiny Pokémon]] with the formula {{frac|''x''}}.
|{{frac|10}}
|-
|<code>eventTime</code>
|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
|-
|<code>pokeGiftHaveEvents</code>
|Enable Poké Gift events
|Whether or not [[Poké Gifts]] can be placed and opened.
|<code>True</code>
|-
|<code>pokeGiftReusable</code>
|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.
|<code>False</code>
|-
|<code>scaleGrassBattles</code>
|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.
|<code>False</code>
|}

===PokéLoot===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>spawnGrotto</code>
|Spawn Hidden Grottos
|Whether or not [[Hidden Grottos]] spawn naturally.
|<code>True</code>
|-
|<code>spawnHidden</code>
|Spawn invisible PokéLoot
|Whether or not invisible [[PokéLoot chests]] spawn naturally.
|<code>True</code>
|-
|<code>spawnMode</code>
|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)
|-
|<code>spawnNormal</code>
|Spawn normal Pokéloot
|Whether or not visible [[PokéLoot chests]] spawn naturally.
|<code>True</code>
|-
|<code>spawnRate</code>
|PokéLoot spawn rate
|The frequency at which [[PokéLoot chests]] spawn.
{| class="wikitable"
|-
!Value
!Name
!{{frac|Chunks|Chests}}
|-
|style="text-align:center"|0
|style="text-align:center"|Minimal
|style="text-align:center"|64
|-
|style="text-align:center"|1
|style="text-align:center"|Normal
|style="text-align:center"|32
|-
|style="text-align:center"|2
|style="text-align:center"|More
|style="text-align:center"|18
|-
|style="text-align:center"|3
|style="text-align:center"|Extreme
|style="text-align:center"|10
|}
|1 (Normal)
|-
|<code>timedLootReuseHours</code>
|Reuse cooldown
|How often players can loot [[PokéLoot chests]] that are set to have timed loot. This value is in hours.
{| class="wikitable"
|-
!Duration
!Seconds
|-
|style="text-align:center"|1 hour
|style="text-align:center"|3,600
|-
|style="text-align:center"|1 day
|style="text-align:center"|86,400
|-
|style="text-align:center"|1 week
|style="text-align:center"|604,800
|}
|86,400 seconds (1 day)
|}

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

===Riding===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>allowRiding</code>
|Allows Riding of Pokémon
|Allow players to ride Pokémon. If false, no Pokémon can be ridden.
|<code>True</code>
|-
|<code>enablePointToSteer</code>
|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.
|<code>True</code>
|-
|<code>landMount</code>
|Allows land mounts.
|If enabled, allows riding Pokémon mounts that do not have the ability to fly or surf.
|<code>True</code>
|-
|<code>requireHM</code>
|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.
|<code>False</code>
|-
|<code>ridingSpeedMultiplier</code>
|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===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>Gen1</code>
|Generation 1
|Whether or not Generation 1 Pokémon ([[Bulbasaur|#1]]-[[Mew|#151]]) can spawn.
|<code>True</code>
|-
|<code>Gen2</code>
|Generation 2
|Whether or not Generation 2 Pokémon ([[Chikorita|#152]]-[[Celebi|#251]]) can spawn.
|<code>True</code>
|-
|<code>Gen3</code>
|Generation 3
|Whether or not Generation 3 Pokémon ([[Treecko|#252]]-[[Deoxys|#386]]) can spawn.
|<code>True</code>
|-
|<code>Gen4</code>
|Generation 4
|Whether or not Generation 4 Pokémon ([[Turtwig|#387]]-#493) can spawn.
|<code>True</code>
|-
|<code>Gen5</code>
|Generation 5
|Whether or not Generation 5 Pokémon (#494-#649) can spawn.
|<code>True</code>
|-
|<code>Gen6</code>
|Generation 6
|Whether or not Generation 6 Pokémon ([[Chespin|#650]]-#721) can spawn.
|<code>True</code>
|-
|<code>Gen7</code>
|Generation 7
|Whether or not Generation 7 Pokémon (#722-#807) can spawn.
|<code>True</code>
|-
|<code>allowLegendarySpawn</code>
|Allow Legendaries to spawn
|Whether or not [[Legendary Pokémon]] will spawn naturally. This only affects Pokémon that use the Legendary spawn rate.
|<code>True</code>
|-
|<code>bellInclusionRange</code>
|Range bells seek other bells
|Range in blocks that Clear/Tidal Bells will seek out other bells.
|10
|-
|<code>bellSuccessChance</code>
|Chance that bells has a spawn
|Chance that a bell, at dawn, will start to ring. 1 = 100%.
|0.01
|-
|<code>bossRate</code>
|Spawn rate of Boss Pokémon
|The rate of [[boss Pokémon]] in the wild (1/x) not including mega bosses.
|256
|-
|<code>BossSpawnChance</code>
|Mega Boss spawn chance
|Chance that a Mega Boss spawn attempt will succeed. 1 = 100%
|0.30000001192092896
|-
|<code>bossSpawnTicks</code>
|Boss spawn ticks
|How often (on average) a [[boss Pokémon]] will attempt to spawn.
|1200 (1 minute)
|-
|<code>canTransformToDittoOnCatch</code>
|Transform into Ditto
|Pokemon which can transform to [[Ditto]].
|
*{{p|Pidgey}}
*{{p|Rattata}}
*{{p|Gastly}}
*{{p|Zubat}}
*{{p|Mankey}}
*{{p|Yanma}}
*{{p|Hoothoot}}
*{{p|Sentret}}
*{{p|Zigzagoon}}
*{{p|Gulpin}}
*{{p|Whismur}}
*{{p|Taillow}}
*{{p|Remoraid}}
*{{p|Starly}}
|-
|<code>despawnOnFleeOrLoss</code>
|Despawn on flee or loss
|Whether or not wild Pokémon will despawn if the player flees from them or loses against them.
|<code>False</code>
|-
|<code>displayLegendaryGlobalMessage</code>
|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.
|<code>True</code>
|-
|<code>distancePerLevel</code>
|Distance per level
|If the <code>spawnLevelsByDistance</code> 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
|-
|<code>entitiesPerPlayer</code>
|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
|-
|<code>hiddenAbilitySpawnRate</code>
|Hidden Ability spawn rate
|The rarity of hidden [[Abilities]] on wild or spawned-in Pokémon, using the formula {{frac|''x''}} Pokémon. This setting does not affect [[breeding]].
|150 ({{frac|150}} Pokémon)
|-
|<code>horizontalSliceRadius</code>
|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
|-
|<code>horizontalTrackFactor</code>
|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
|-
|<code>injectIntoLootTables</code>
|Enables Pixelmon loot table modifier
|Whether or not Pixelmon should modify Minecraft loot tables.
|<code>True</code>
|-
|<code>legendarySpawnChance</code>
|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 <code>legendarySpawnTicks</code> setting.
|0.3 (30%)
|-
|<code>legendarySpawnTicks</code>
|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 <code>legendarySpawnChance</code> setting.
|3,000 ticks (2 minutes and 30 seconds)
|-
|<code>lootIgnoreList</code>
|Type of loot Pixelmon shouldn't modify
|Maximum level Pokémon will spawn at when Spawn Levels By Distance enabled.
|None
|-
|<code>maxLevelByDistance</code>
|Maximum spawn level (by distance)
|The maximum level that Pokémon can spawn at when the spawnLevelsByDistance option is enabled.
|60
|-
|<code>maximumDistanceFromCentre</code>
|Max distance for spawns
|The maximum distance from the player that entities may spawn.
|64
|-
|<code>maximumSpawnedPokemon</code>
|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
|-
|<code>MeltanSpawnChance</code>
|Meltan Spawn Chance
|Chance for a Meltan to spawn when smelting a metal ore block. 1/x
|8192
|-
|<code>meltanTransformChance</code>
|Chance Meltan transforms to Ditto
|Percentage chance for a [[Meltan]] to transform into [[Ditto]] on capture. 1 = 100%
|0.6
|-
|<code>minimumDistanceBetweenSpawns</code>
|Minimum distance for spawns
|The minimum number of blocks between a spawned entity and an existing living entity.
|15
|-
|<code>minimumDistanceFromCentre</code>
|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
|-
|<code>replaceMCVillagers</code>
|Replace Minecraft villagers
|Whether to replace ''Minecraft's'' {{mc|villagers}} with [[chatting NPCs]] in {{mc|villages}}.
|<code>True</code>
|-
|<code>shinySpawnRate</code>
|Shiny spawn rate (1/x)
|The rarity of [[Shiny Pokémon]], using the formula {{frac|''x''}} Pokémon.
|4096 ({{frac|4096}} Pokémon)
|-
|<code>spawnFrequency</code>
|Number of spawns per minute
|The number of spawn passes made per minute. Decrease for better performance.
|60
|-
|<code>spawnGyms</code>
|Spawn Gyms
|Whether [[Gyms]] can spawn naturally.
|<code>True</code>
|-
|<code>spawnLevelsByDistance</code>
|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.
|<code>False</code>
|-
|<code>spawnLevelsCloserToPlayerLevels</code>
|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. 
|<code>True</code>
|-
|<code>spawnPokeMarts</code>
|Spawn shopkeepers
|Whether [[Poké Marts]] can spawn in [[towns]].
|<code>True</code>
|-
|<code>spawnSetFolder</code>
|Folder path for spawning files
|Which folder to use under ./pixelmon/spawning/ for spawn sets.
|<code>default</code>
|-
|<code>spawnTicksPlayerMultiplier</code>
|Speeds up legendary and mega boss spawns
|A multiplier that speeds up legendary and mega boss spawning based on player count. ticks = <code>spawnTicks</code> / (1 + (number of players - 1) * <code>spawnTicksPlayerMultiplier</code>)
|0.009999999776482582
|-
|<code>spawnUltraSpaceEndCities</code>
|Enable for End City Spawns in Ultra Space
|If enabled, End Cities should be generated in new [[Ultra Space]] chunks.
|<code>True</code>
|-
|<code>spawnUltraSpaceExtraLoots</code>
|More Pokéloot in Ultra Space
|If enabled, more [[Pokéloot]] chests should be generated in new [[Ultra Space]] chunks.
|<code>True</code>
|-
|<code>spawnUltraSpaceExtraOres</code>
|More ores in Ultra Space
|If enabled, more ores should be generated in new [[Ultra Space]] chunks.
|<code>True</code>
|-
|<code>spawnUltraSpaceExtraPlants</code>
|More Apricorns/Berries in Ultra Space
|If enabled, more plants ([[apricorns]], [[berries]]) should be generated in new [[Ultra Space]] chunks.
|<code>True</code>
|-
|<code>spawnUltraSpaceExtraShrines</code>
|More shrines in Ultra Space
|If enabled, more [[Shrines]] should be generated in new [[Ultra Space]] chunks.
|<code>True</code>
|-
|<code>spawnUltraSpaceNetherForts<code>
|Enables spawning of Nether Forts in Ultra Space
|If enabled, Nether Forts should be generated in new [[Ultra Space]] chunks.
|<code>True</code>
|-
|<code>spawnsPerPass</code>
|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 <code>5</code> are very unlikely to make a noticeable difference.
|<code>2</code>
|-
|<code>transformToDittoOnCatch</code>
|Chance for Pokémon to transform into Ditto
|Chance for a wild Pokemon to turn into a [[Ditto]] on capture.
|5.0E-5
|-
|<code>useBetterSpawnerConfig</code>
|Enables BetterSpawnerConfig
|If enabled, the BetterSpawnerConfig's config will be generated under config/pixelmon.
|<code>False</code>
|-
|<code>useRecentLevelMoves</code>
|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.
|<code>False</code>
|-
|<code>verticalSliceRadius</code>
|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.
|<code>25</code>
|-
|<code>verticalTrackFactor</code>
|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.
|<code>0</code>
|}

===Starters===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>level</code>
|Starter level
|The initial level that Trainers' [[starter Pokémon]] will be at. This can be between levels 5 and 100.
|5
|-
|<code>shiny</code>
|Shiny starters
|If enabled, Trainers' [[starter Pokémon]] will always be [[Shiny]].
|<code>False</code>
|-
|<code>starterList</code>
|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., <code>Unown10</code> for [[Unown]] K).
|
*{{p|Bulbasaur}}
*{{p|Squirtle}}
*{{p|Charmander}}
*{{p|Chikorita}}
*{{p|Totodile}}
*{{p|Cyndaquil}}
*{{p|Treecko}}
*{{p|Mudkip}}
*{{p|Torchic}}
*{{p|Turtwig}}
*{{p|Piplup}}
*{{p|Chimchar}}
*{{p|Snivy}}
*{{p|Oshawott}}
*{{p|Tepig}}
*{{p|Chespin}}
*{{p|Fennekin}}
*{{p|Froakie}}
*{{p|Rowlet}}
*{{p|Litten}}
*{{p|Popplio}}
*{{p|Grookey}}
*{{p|Scorbunny}}
*{{p|Sobble}}
|}

===Storage===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>asyncInterval</code>
|N/A
|The interval in seconds that the async saver will save all queued data to disk.
|<code>60</code>
|-
|<code>useAsyncSaving</code>
|N/A
|Activates off-main thread saving of party and computer data. (server only)
|<code>false</code>
|}

===UltraSpace===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>ultraSpace</code>
|Enables Ultra Space
|Whether the [[Ultra Space]] Dimension is activated or not.
|<code>True</code>
|-
|<code>ultraSpaceBossModifier<code>
|Modifies boss rarity in Ultra Space
|Modifies the rarity of bosses in the [[Ultra Space]] Dimension (<code>bossRate</code> * <code>ultraSpaceBossModifier</code>).
|0.5
|-
|<code>ultraSpaceColourblindMode</code>
|Enables Colourblind mode in Ultra Space
|If enabled, [[Ultra Space]] fog will be in colourblind mode.
|<code>False</code>
|-
|<code>ultraSpaceDimId</code>
|Ultra Space's Dimension ID
|The dimension ID [[Ultra Space]] will utilize. If smaller than 2, defaults to ID 72.
|0
|-
|<code>ultraSpaceHiddenAbilityModifier</code>
|Modifies rarity for Hidden Abilities in Ultra Space
|Modifies the rarity of hidden abilities in the [[Ultra Space]] Dimension (<code>hiddenAbilitySpawnRate</code> * <code>ultraSpaceHiddenAbilityModifier</code>).
|0.5
|-
|<code>ultraSpaceShinyModifier</code>
|Modifies rarity for Shinies in Ultra Space
|Modifies the rarity of shiny Pokemon in the Ultra Space Dimension (<code>shinyRate</code> * <code>ultraSpaceShinyModifier</code>).
|0.5
|}

==Legacy Options==
===Sounds===
{|class="wikitable sortable collapsible"
! Setting (<code>.hocon</code>)
! Setting (in-game)
! class="unsortable" | Description
! class="unsortable" | Default value
|-
|<code>removeVanillaMusic</code>
|Remove vanilla music
|Whether or not vanilla ''Minecraft'' music (not including music discs) can randomly play instead of Pixelmon music.
|<code>True</code>
|}