
You want more Pokémon, less spawn work, faster healing or a higher level cap, and all of it sits in one config file. The official wiki page about it was last edited on 1 February 2026, seven months before Cobblemon 1.8. Below are the main.json settings and their defaults, read from the Cobblemon 1.8.4 source code (Minecraft 1.21.1, Fabric and NeoForge, 27 October 2026), plus the ways a config quietly resets itself.
Quick answer: The Cobblemon config is config/cobblemon/main.json in your server folder, or in your game or launcher instance folder in singleplayer. Cobblemon writes it on the first start with every setting at its default. Edit the value, save the file, then run /cobblemonconfig reload (permission level 2) or restart. For more Pokémon, raise pokemonPerChunk (default 1.0) or lower ticksBetweenSpawnAttempts (default 20.0). For less spawn work, keep spawningZoneDiameter (8) and spawningZoneHeight (16) small. Keep a copy before you edit: if the file is not valid JSON, Cobblemon loads the defaults and writes them over your file.
Where Is the Cobblemon Config File?
Cobblemon uses a fixed path relative to the folder the game or server runs from: config/cobblemon/main.json. On a dedicated server that is the server's root folder, next to mods and server.properties. In singleplayer it is your game folder (.minecraft, or the instance folder of a launcher such as Modrinth App or CurseForge), not the world save, so one file covers every world in that instance.
Two more files appear only when you switch them on in main.json:
| File | Created when | What it holds |
|---|---|---|
config/cobblemon/main.json | First start | 117 settings plus lastSavedVersion |
config/cobblemon/starters.json | exportStarterConfig is true | The starter list (the tooltip says starter.json, the code writes starters.json) |
config/cobblemon/spawning/best-spawner-config.json | exportSpawnConfig is true | Spawn bucket weights. World spawns: common 94.0, uncommon 5.0, rare 0.5, ultra-rare 0.2, boss 0.3, plus separate fishing, Poké Snack and habitat buckets |
On a Space-Node Cobblemon server you reach these files over SFTP, the same way you upload mods.
How to Change Cobblemon Settings Without Breaking Them
- Copy the file first:
cp config/cobblemon/main.json config/cobblemon/main.json.bak - Change only the value after the colon. Key names are case-sensitive and must stay exactly as Cobblemon wrote them.
- Check that the file is still valid JSON:
python3 -m json.tool config/cobblemon/main.json > /dev/null && echo valid. With SFTP only, download the file and run the same check on your own computer. - Run
/cobblemonconfig reloadin the console or as an operator (permission level 2, or the nodecobblemon.command.cobblemonconfig.reload), or restart the server.
A reload re-reads main.json, writes it straight back, reloads the spawn bucket file and the despawn rules, and sends the synced settings (level cap, friendship cap, name and level labels and a few more) to everyone online. Not everything follows: each player's spawner copies pokemonPerChunk and ticksBetweenSpawnAttempts when it is created, so players already online can keep the old values, and storageFormat is read only at server start. If in doubt, restart.
Why the in-game settings screen hides most options
/cobblemonconfig without reload opens a settings screen. On a dedicated server it hides every server setting, and its Done button saves to the player's own main.json on their computer. In singleplayer, and for the host of a LAN world, it shows everything. Use it for your own world; for a server, edit the server's file.
Spawn and Performance Settings
Every spawn setting is server-side. Text in quotes is Cobblemon's own tooltip. Those tooltips are the only performance guidance the developers give, and we have not benchmarked any of these values ourselves.
| Key | Default | What it does |
|---|---|---|
enableSpawning | true | Natural Pokémon spawning on or off |
worldSpawningBlocklist | [] | Worlds, as namespaced IDs, where Cobblemon spawns nothing (added in 1.8.0) |
pokemonPerChunk | 1.0 | "The amount of Pokémon allowed within a Chunk when spawning" |
pokeSnackPokemonPerChunk | 2.0 | The same cap for Poké Snack spawns |
ticksBetweenSpawnAttempts | 20.0 | Ticks between spawn attempts, per player |
maximumSpawnsPerPass | 8 | Most spawns in one attempt. "If the spawning zone dimensions are small, this option does very little" |
spawningZoneDiameter / spawningZoneHeight | 8 / 16 | Size of a spawn zone. Large values give "more reliably frequent spawning at the cost of performance" |
minimumSpawningZoneDistanceFromPlayer / maximumSpawningZoneDistanceFromPlayer | 16.0 / 64.0 | Nearest and farthest a spawn zone can be from the player, in blocks |
minimumDistanceBetweenEntities | 8.0 | Blocks kept between a new spawn and existing entities, against clustering |
maxNearbyBlocksHorizontalRange / maxNearbyBlocksVerticalRange | 4 / 2 | How far "nearby block" spawn conditions look. "Lowering this value can slightly improve performance" |
maxVerticalSpace | 8 | Head room checked above a spawn spot; keep it at least as large as the biggest height condition in your spawn files |
maxVerticalCorrectionBlocks | 64 | How far a spawn spot may shift up or down on bumpy terrain; raising it has "a very small, negative impact on performance" |
minimumLevelRangeMax | 10 | Level treated as the party's highest when the party is empty or very weak |
savePokemonToWorld | true | Saves wild Pokémon with the chunk so they exist after a reload |
despawnerNearDistance / despawnerFarDistance | 32.0 / 96.0 | Despawn distances in blocks, explained below |
despawnerMinAgeTicks / despawnerMaxAgeTicks | 600 / 3600 | Despawn ages in ticks: 30 seconds and 3 minutes |
Two sums make this concrete. At the normal 20 ticks per second, the default 20.0 means one spawn attempt per player per second, the first one 100 ticks (5 seconds) after a player's spawner starts. Ten players online means ten attempts a second, since every player has their own spawner; 10.0 doubles that.
Each attempt works in a box of diameter by height by diameter blocks, centred on your height and 16 to 64 blocks away from you. At the defaults that is 8 × 16 × 8 = 1,024 blocks. A diameter of 16 makes it 16 × 16 × 16 = 4,096 blocks, four times as many blocks per attempt: the cost the tooltip warns about.
How the despawner decides
The despawn rule in the code looks at the distance to the nearest player and the Pokémon's age:
- Younger than
despawnerMinAgeTicks(600 ticks): never despawns. - Closer than
despawnerNearDistance(32 blocks) to any player: never despawns. - Older than
despawnerMaxAgeTicks(3600 ticks), or farther thandespawnerFarDistance(96 blocks): can despawn. - In between, the age at which it may despawn shrinks with distance. Pokémon the game marks as busy, and Pokémon riding as a passenger, are skipped.
Example: a wild Pokémon 64 blocks from the nearest player is halfway from 32 to 96, so half the distance is still to go. The code multiplies that 0.5 by the gap between the two ages (3600 minus 600 is 3,000 ticks) and gets 1,500 ticks. That Pokémon can despawn once it is older than 75 seconds. Lower despawnerMaxAgeTicks or despawnerFarDistance and wild Pokémon clear out sooner; raise them and more stay around your players.
Progression and Balance Settings
| Key | Default | What it does |
|---|---|---|
experienceMultiplier | 2.0 | Extra multiplier in the experience formula |
experienceShareMultiplier | 0.5 | Share of experience for a Pokémon holding an Exp. Share |
luckyEggMultiplier | 1.5 | Experience multiplier for a Pokémon holding a Lucky Egg |
awardExperienceToFaintedPokemon | false | Fainted Pokémon still earn experience for foes they helped defeat (1.8.0) |
awardExperienceOnBattleLoss | false | Experience for defeated foes even after a lost or forfeited battle (1.8.0) |
maxPokemonLevel | 100 | Level cap, allowed range 1 to 1000 |
maxPokemonFriendship | 255 | Friendship cap, 0 to 1000 |
shinyRate | 8192.0 | Shiny chance as 1 in x, 0 turns wild shinies off. Details in our shiny odds guide |
teraTypeRate | 20.0 | Chance, as 1 in x, of a Tera type that differs from the Pokémon's own typing |
infiniteTmUses | false | TMs are not used up when teaching moves (1.8.0) |
unlockAllMoveDexMovesByDefault | false | Makes every TM and level-up move available in the TM Machine and the Pokédex Move Dex from the start |
infiniteRideStamina | false | Rideable Pokémon never run out of stamina |
predationChance | 0.05 | "Chance of Pokémon predating the enemy" |
playerDamagePokemon | true | Players can attack Pokémon like normal mobs |
Special encounter odds sit in the same file, all as 1 in x: fossilMachineShinyChance 100, fossilMachineAlphaChance 20, honeySlatherShinyChance 4000, honeySlatherAlphaChance 100, and for Data Monitor Pokémon monitorShinyRate 200 and monitorAlphaRate 40. Battle turn speed is not in main.json: it comes from the Cobblemon Battle Extras add-on, see how to change server turn speed.
Healing, Storage, Pasture and Battle Distance Settings
| Key | Default | What it does |
|---|---|---|
secondsToChargeHealingMachine | 900.0 | Seconds for a Healing Machine to charge fully (15 minutes) |
maxHealerCharge | 6.0 | Charges a Healing Machine holds; one charge equals a Max Revive plus PP |
infiniteHealerCharge | false | Healing Machines never run dry |
defaultFaintTimer | 300 | Seconds before a fainted Pokémon revives |
healTimer / healPercent | 60 / 0.05 | Seconds between natural HP restores, and how much each one restores |
passiveStatuses | for example "cobblemon:burn": "180-300" | Range of seconds before a status such as burn clears |
storageFormat | "nbt" | nbt, json or mongodb. Read at server start; with nbt or json the data sits in the world's pokemon folder |
pokemonSaveIntervalSeconds | 30 | Seconds between saves of party and PC data, 1 to 120 |
defaultBoxCount | 40 | PC boxes, 1 to 1000 |
preventCompletePartyDeposit | false | Stops players from putting their last party Pokémon in the PC |
defaultPasturedPokemonLimit | 16 | Pokémon per Pasture block |
pastureMaxWanderDistance | 32 | Blocks a pastured Pokémon may walk from its block |
pastureMaxPerChunk | 4.0 | Pastured Pokémon sent out per chunk |
battleWildMaxDistance / battlePvPMaxDistance | 12.0 / 32.0 | Maximum distance for wild and PvP battles |
battleSpectateMaxDistance / tradeMaxDistance | 64.0 / 12.0 | Maximum distance to spectate and to trade |
defaultFleeDistance | 32.0 | How far a player must get away to flee a wild battle; -1 means no fleeing |
Treat a storageFormat change as a migration and try it on a copy of the world first. For pastures in practice, see the Pasture block guide.
Settings That Belong to Each Player
Cobblemon tags 23 settings as client settings: the labels above Pokémon, shinyNoticeParticlesDistance, an armor list for shoulder-mounted Pokémon, battle and menu animations, a Pokédex filter, the riding camera and controls, and the debug keys. These are what a player sees in the settings screen on a server, saved to that player's own file.
Two work the other way round. The server sends displayEntityLevelLabel and displayEntityNameLabel to every player on join and after each reload, and the label code reads the server's values. To hide levels or names above Pokémon for everyone, set them to false in the server's file. displayNameForUnknownPokemon, which shows names of species you have not registered yet, is read from each player's own file; a bug report asking for server control was closed as "Working As Intended".
What Changed in 1.8, and What the Wiki Misses
Between 1.7.3 and 1.8.4, 23 settings were added, among them worldSpawningBlocklist, the experience award options, predationChance, the TM options, the fossil, honey and Data Monitor odds, size scaling and five type gem growth keys. Two client riding keys were removed: invertRoll and rightingDelay. Of the 117 settings in 1.8.4, 56 are not on the wiki's Config page under their current name. The wiki still shows five old names, and the code accepts one more old spelling:
| Old name | Name in 1.8.4 | Does the old name still load? |
|---|---|---|
worldSliceDiameter | spawningZoneDiameter | Yes |
worldSliceHeight | spawningZoneHeight | Yes |
minimumSliceDistanceFromPlayer | minimumSpawningZoneDistanceFromPlayer | Yes |
maximumSliceDistanceFromPlayer | maximumSpawningZoneDistanceFromPlayer | Yes |
BattlePvPMaxDistance | battlePvPMaxDistance | Yes |
chargeGainedPerTick | secondsToChargeHealingMachine | No, it is ignored |
Old names marked Yes are read and saved back under the new name. chargeGainedPerTick has no such link, so a custom value is lost. To convert it: seconds = maxHealerCharge ÷ charge per tick ÷ 20. The wiki's old default of 0.000333333 per tick gives 6 ÷ 0.000333333 ÷ 20 ≈ 900 seconds, the same as the new default.
Updating Cobblemon keeps your values, with three exceptions in the code:
- Four keys return to their default when your file was saved by an older version than the one named in the code:
ambientPokemonCryTicks(1.4.0) anddefaultBoxCount,maxRootsInAreaandbigRootPropagationChance(1.7.0). From 1.7.x to 1.8.4, nothing resets. - A new default does not reach your file:
pastureMaxWanderDistancewas 64 in 1.7.3 and is 32 in 1.8.4, and a file saved by 1.7 keeps 64. - With
exportSpawnConfigon and"replaceWithNewVersion": true, a newer bundled bucket file replaces yours. 1.7.3 bundled version 1 (abucketslist), 1.8.4 bundles version 2 (worldBuckets,fishingBuckets,pokeSnackBuckets,activatedHabitatBuckets), so custom 1.7 weights are lost on the update.
Why Did My Cobblemon Config Reset?
| What you see | Cause in the code | Fix |
|---|---|---|
| Every value is back to default and the log says "Failed to load the config! Using default config until the following has been addressed:" | The file was not valid JSON, or a value had the wrong type, such as text where a number belongs. Cobblemon then saves the defaults over your file right away, so the broken version is gone | Restore your .bak, fix it, check it with the JSON command above, reload |
| One setting does nothing and its line disappears | The key was misspelled. Unknown keys are skipped and dropped on the next save, and the real key keeps its default | Copy key names from the file Cobblemon wrote |
| A number changed by itself | It was outside its range and was clamped: maxPokemonLevel 1 to 1000, maxPokemonFriendship 0 to 1000, defaultBoxCount 1 to 1000, pokemonSaveIntervalSeconds 1 to 120, maxVerticalCorrectionBlocks 1 to 200, minimumLevelRangeMax 1 to 1000, maxDynamaxLevel 0 to 10. A save interval of 300 becomes 120 | Pick a value inside the range |
| Custom bucket weights are gone | A newer bundled bucket file replaced yours, or yours failed to load ("Unable to load external Best Spawner configuration") and was overwritten | Enter them again in the version 2 layout |
Example: What Cobbleverse Changes
Cobbleverse 1.7.42 (21 July 2026) is still the newest version of that modpack on Modrinth on 4 November 2026. It runs Cobblemon 1.7.3 and ships its own main.json, which shows how a large pack tunes the file:
| Key | Cobblemon 1.8.4 default | Cobbleverse 1.7.42 | The sum |
|---|---|---|---|
ticksBetweenSpawnAttempts | 20.0 | 10.0 | 20 ticks per second ÷ 10 = 2 attempts per player per second instead of 1 |
maximumSpawnsPerPass | 8 | 1 | At most 1 spawn per attempt instead of 8 |
shinyRate | 8192.0 | 2048.0 | 8192 ÷ 2048 = 4 times the default shiny odds |
secondsToChargeHealingMachine | 900.0 | 300.0 | A full charge in 5 minutes instead of 15 |
defaultBoxCount | 40 | 60 | 20 more PC boxes |
minimumLevelRangeMax | 10 | 5 | Lower wild levels around empty or weak parties |
battleWildMaxDistance / tradeMaxDistance | 12.0 | 18.0 | 1.5 times the reach |
playerDamagePokemon | true | false | Players cannot hit Pokémon |
Its bucket file uses the old version 1 layout (88.5 common, 10 uncommon, 1.2 rare, 0.3 ultra-rare). Since its main.json was saved by 1.7.3, a server built on it that moves to Cobblemon 1.8.4 keeps its 60 boxes, gains the 23 new settings at their defaults and gets the 1.8.4 bucket file in place of the pack's. Our Cobblemon 1.8.4 server guide covers the pack's own update.
FAQ
Where is the Cobblemon config file?
At config/cobblemon/main.json in the server's root folder or, in singleplayer, in your game or launcher instance folder. It is not in the world folder, so in singleplayer one file covers all your worlds.
How do I make more Pokémon spawn in Cobblemon?
Raise pokemonPerChunk above 1.0, or lower ticksBetweenSpawnAttempts below 20.0. A larger spawn zone also spawns more reliably, at a performance cost by the developers' own description. Restart afterwards so every player's spawner picks up the change.
How do I reduce Cobblemon lag with the config?
Keep the spawn zone at 8 by 16 or smaller, keep the two nearby-block ranges low, and let wild Pokémon despawn sooner with a lower despawnerMaxAgeTicks or despawnerFarDistance. Profile with spark first, and see the Cobblemon server optimization guide for causes outside the config.
Does /cobblemonconfig reload apply everything?
No. Player spawners keep the per-chunk cap and spawn interval they started with, and storageFormat is only read at server start. Restart when in doubt.
Why did my Cobblemon config reset?
Usually a JSON error: Cobblemon falls back to the defaults and writes them over your file. A misspelled key, a value outside its range, the version reset of four keys or a replaced bucket file are the other causes, each covered above.
Why does the /cobblemonconfig screen not change my server?
On a dedicated server the screen hides all server settings and saves to the main.json on your own computer. Only the server's file changes the server.
Sources
All opened on 4 November 2026:
- Cobblemon source at tag 1.8.4 on GitLab: CobblemonConfig.kt (keys, defaults, ranges, client or server tags), Cobblemon.kt (path, load, save, reload, version resets), CobblemonConfigCommand.kt, CobblemonPermissions.kt, CobblemonConfigScreen.kt, CobblemonConfigVariableList.kt, ServerSettingsPacketHandler.kt, PokemonRenderer.kt, PlayerSpawner.kt, BasicSpawner.kt, BestSpawner.kt, BestSpawnerConfig.kt, best-spawner-config.json, CobblemonAgingDespawner.kt, BurnStatus.kt, en_us.json (tooltip texts) and CHANGELOG.md
- Cobblemon source at tag 1.7.3: CobblemonConfig.kt and best-spawner-config.json; the 1.8.0 changelog; the tag list
- Cobblemon issue tracker: "displayNameForUnknownPokemon" not synced from server to client, labelled Working As Intended
- Official Cobblemon wiki: Config and its page history
- Cobblemon on Modrinth: project page and versions (1.8.4 for Fabric and NeoForge, Minecraft 1.21.1, 27 October 2026)
- Cobbleverse on Modrinth: project page and version 1.7.42 (pack files
config/cobblemon/main.json,config/cobblemon/spawning/best-spawner-config.jsonand the mod list)