Player Configuration

Configuration

WandererZ uses Cloth Config and integrates with Mod Menu. Since v1.6.0 a single WandererZ entry in Mod Menu opens a small chooser screen with buttons for each merged system:

• WandererZ — opens the original WandererZ config (WandererzConfig, saved as config/wandererz.json)
• Jobs — opens the Jobs config (JobsAddonConfig, saved as config/jobsaddon.json)
• Rpg Difficulty — opens the RPG Difficulty config (RpgDifficultyConfig, saved as config/rpgdifficulty.json)
• Tiered — opens the Tiered config (TieredConfig, saved as config/tiered.json)
• Party — opens the Party config (PartyAddonConfig, saved as config/partyaddon.json)
• Food Spoilage — opens the Food Spoilage config (SpoiledZConfig, saved as config/spoiledz.json)

This chooser exists because Mod Menu can only register one config screen per mod id, and merging the mods meant all six config screens now live under the single wandererz id.

Notable WandererZ options

• XP gain rates per activity (mining, combat, farming, fishing, brewing, etc.)
• Per-skill point effect scaling (health, strength, agility, defense, stamina, luck, archery, trade, smithing, mining, farming, alchemy)
• Max level / max skill points
• Hard mode (reset-on-death behavior)

Notable Jobs options

Option	Default	Meaning
employedJobs	2	How many jobs a player can hold at once
jobChangeTime	24000	Ticks before you can change jobs again
resetCurrentJobXP	true	Reset current job XP on death
jobMaxLevel	100	Max level per job
jobXPBaseCost / jobXPCostMultiplicator / jobXPExponent / jobXPMaxCost	100 / 0.5 / 2 / 0	XP curve: base + multiplicator * level^exponent (capped at jobXPMaxCost if non-zero)
<job>XP (e.g. minerXP, farmerXP, ...)	varies	Default XP granted per job-related action
xpMultiplicator	3	Vanilla XP granted per job level, times job level
levelZXPMultiplicator	3	WandererZ XP granted per job level, times job level
moneyMultiplicator	20	Numismatic Overhaul currency granted per job level (if installed)
allowMaxLvlProgress	false	Allow continuing to earn job XP past max level

All config files live in your instance's config/ folder and can also be hand-edited while the server/client is stopped.

See Jobs for how these options affect gameplay.

Notable RPG Difficulty options

Option	Default	Meaning
increasingDistance / distanceFactor	300 / 0.1	Mob factor increases 10% per 300 blocks from spawn
increasingTime / timeFactor	60 / 0.05	Mob factor increases 5% per 60 minutes survived
heightDistance / heightFactor	30 / 0.1	Mob factor increases 10% per 30 blocks above/below sea level
maxFactorHealth / maxFactorDamage / maxFactorProtection	3.0 / 3.0 / 1.5	Maximum multipliers for each attribute
allowRandomValues / randomChance / randomFactor	false / 10% / 10%	Optional random swing on the final factor
extraXp / maxXPFactor	true / 2.0	Grant bonus vanilla XP scaled by the health multiplier, capped at 2x
dropMoreLoot / moreLootChance / maxLootChance	false / 0.02 / 0.7	Extra loot table rolls, chance scales with mob level/multiplier
levelFactor / playerRadius	0.0 / 100	Only applies when WandererZ/PlayerEx is loaded — scales mobs by nearby players' level instead of/alongside distance-time-height
allowSpecialZombie / bigZombieChance / speedZombieChance	true / 10% / 10%	Chance to spawn oversized or speed-variant zombies
dynamicBossModification / dynamicBossModificator / bossMaxFactor	true / 0.3 / 3.0	Each nearby player further scales boss (incl. Wither/Ender Dragon) attributes
excludedEntity	the_bumblezone:cosmic_crystal_entity	Entities excluded from all scaling

See RPG Difficulty for how these options affect gameplay.

Notable Tiered options

Option	Default	Meaning
wandererzReforgeModifier	0.01	Reforge odds improvement per Smithing skill point (always active now that Tiered is bundled)
enableReforgingTab	true	Show the dedicated inventory Reforging tab in addition to anvil-based reforging
tooltipBorders	true	Render a colored border around tiered item tooltips matching the tier's color
Per-tier weight/chance options	varies	Control how common each of the six tiers (common/uncommon/rare/epic/legendary/unique) is when rolled

See Tiered for how these options affect gameplay.

Notable Party options

Option	Default	Meaning
groupSize	7	Maximum number of players allowed in one group
distributeVanillaXP	true	Share vanilla XP picked up by a group member with nearby members
distributeLevelZXP	true	Share WandererZ player XP picked up by a group member with nearby members
invitationTime	1200	Ticks a group invitation stays valid before expiring
groupXpBonus	0.05	Bonus XP multiplier per additional group member
fullGroupBonus	0.5	Extra bonus multiplier when the group is at max size
showGroupHud / hudMaxWidth / hudOpacity / hudPosX / hudPosY	true / 55 / 0.75 / 0 / 0	Client-only group HUD appearance/position

See Party for how these options affect gameplay.

Notable Food Spoilage options

Option	Default	Meaning
seasonSpoilage	4	Number of seasons that pass before a tracked food item is 100% spoiled
freshCrafting	false	Reset an item's spoilage timer back to zero when crafted with fresh ingredients
effectChance	35	Percent chance of a negative status effect when eating spoiled food
effectDuration	400	Duration (in ticks) of that negative status effect

See Food Spoilage for how these options affect gameplay.