Configuration

Configuration

The settings live in config/worldbosses.json (server side). Every setting has a short explanation right above it in the file. After changes, run /worldbosses reload or restart the server. Delete the file to get the defaults back.

Times in ticks are 1/20 of a second. Damage and health: 2 = one heart.

Below are all general settings with their defaults. Boss settings are described in Boss settings; each boss page lists its own values.

versionCheck

World Bosses settings. Lines starting with // explain the setting below them. After changes, use /worldbosses reload or restart the server. Delete this file to get the defaults back. Times: "ticks" are 1/20 of a second. Damage and health: 2 = one heart. Tells joining players which World Bosses version the server runs.

Setting	Default	What it does
enabled	true	Send the server's version to players when they join.

debug

Extra output for testing boss fights. Leave off on a normal server.

Setting	Default	What it does
enabled	false	Debug mode: bosses print what they do, and the mace limits are switched off.
broadcastToPlayers	true	Show debug messages in the chat of players nearby.
logToConsole	true	Write debug messages to the server log.
broadcastRadius	96	Players within this many blocks get the debug messages.
showRootImpactResults	true	Sylvaron: report who was hit by his roots.

messages

Turn groups of chat messages on or off.

Setting	Default	What it does
validationMessages	true	Why a ritual cannot start (wrong dimension, boss already alive nearby, ...).
shrineMessages	true	Messages when using a shrine.
ritualCountdownMessages	true	The countdown while a ritual runs.
phaseMessages	true	Announcements when a boss enters a new phase.
raidScalingMessages	true	Notes when a boss gets stronger because more players joined.
rewardMessages	true	Messages about rewards after a kill.
raidCacheMessages	true	Messages when a raid cache is opened.
versionCheckMessages	true	The server version message on join.
locatorMessages	true	Results of the Shrine Locator and the Realm Compass.
worldGenerationMessages	false	Log each placed shrine in the chat. Only useful for testing.

worldGeneration

Where and how the boss shrines are placed in the world.

Setting	Default	What it does
enabled	true	Place shrines in the world at all.
checkIntervalTicks	80	How often (in ticks, 20 = 1 second) the mod looks for places to put new shrines near players.
playerChunkRadius	7	Look for shrine spots within this many chunks around each player (max 12).
shrineClearRadius	6	Blocks cleared around a shrine so it is not buried.
shrineClearHeight	9	How high above a shrine blocks are cleared.
stabilizeShrineTerrain	true	Search for flat ground and fill gaps under shrines.
shrineTerrainSearchRadius	8	How far to search for flat ground around the planned spot.
maxShrineTerrainHeightDifference	4	Most height difference allowed on the ground under a shrine.
buildShrineFoundations	true	Build a foundation under shrines that stand over a drop.
shrineFoundationDepth	10	How deep such a foundation may go.
fallbackShrineTerrainSearchRadius	32	Wider search if no flat ground was found close by.
fallbackMaxShrineTerrainHeightDifference	10	Height difference allowed during that wider search.
maxPlacementAttemptsPerRegion	4	How many spots are tried per region before giving up (1-16).
ignoreBiomeRulesForGeneratedShrines	true	Let bosses be summoned at generated shrines even outside their allowed biomes.
generateOverworldShrines	true	Place Overworld shrines.
generateNetherShrines	true	Place Nether shrines.
generateEndShrines	true	Place End shrines.
generatePrimordialNexusShrines	true	Place the Primordial Nexus shrines for Astrael.

worldGeneration › overworldShrine

Spacing of Overworld shrines.

Setting	Default	What it does
spacingChunks	34	About one shrine per square of this many chunks (16 blocks each). Higher = rarer.
salt	925813	Random seed for the placement. Change it to move all shrines of this type.

worldGeneration › netherShrine

Spacing of Nether shrines.

Setting	Default	What it does
spacingChunks	38	About one shrine per square of this many chunks (16 blocks each). Higher = rarer.
salt	492271	Random seed for the placement. Change it to move all shrines of this type.

worldGeneration › endShrine

Spacing of End shrines.

Setting	Default	What it does
spacingChunks	52	About one shrine per square of this many chunks (16 blocks each). Higher = rarer.
salt	823111	Random seed for the placement. Change it to move all shrines of this type.

worldGeneration › primordialNexusShrine

Spacing of Primordial Nexus shrines.

Setting	Default	What it does
spacingChunks	118	About one shrine per square of this many chunks (16 blocks each). Higher = rarer.
salt	1289971	Random seed for the placement. Change it to move all shrines of this type.

shrineAtmosphere

Particles and sounds around shrines.

Setting	Default	What it does
enabled	true	Particles and sounds around shrines.
scanIntervalTicks	20	How often shrines near players are updated (ticks).
scanHorizontalRadius	14	Shrines within this many blocks of a player get effects.
scanVerticalRadius	5	Same, but up and down.
particlesPerPulse	14	Particles per update.
ambientSounds	true	Play ambient shrine sounds.
soundChancePerPulse	14	A sound plays about once every this many updates.

bossVisuals

Extra particles around living bosses.

Setting	Default	What it does
enabled	true	Extra particles around living bosses.
particleIntervalTicks	10	How often particles are shown (ticks).
playerScanRadius	96	Only show them if a player is within this many blocks.
particlesPerPulse	4	Particles each time.
secondaryParticleChance	4	Second particle type about once every this many times.
enragePulse	true	Stronger particles when a boss is low on health.
enrageHealthPercent	0.34	Health share (0.34 = 34%) below which the stronger particles start.
enrageExtraParticles	4	Extra particles when low on health.

bossIntro

The effects when a boss appears.

Setting	Default	What it does
enabled	true	Show the entrance effects when a boss appears.
broadcastRadius	96	Players within this many blocks see the intro message.
particleMultiplier	1.0	More (above 1) or fewer (below 1) intro particles.
playSounds	true	Play the intro sounds.
playSecondaryParticles	true	Show the second intro particle type.

bossSelfHeal

Bosses slowly heal while they fight, faster the more players take part.

Setting	Default	What it does
enabled	true	Bosses heal while they fight.
baseHealPerSecond	1.0	Health healed per second.
healPerActivePlayerPerSecond	0.5	Extra healing per second for every player in the fight.
activeParticipantRadius	96	Players within this many blocks count as in the fight.
minActivePlayers	1	Heal at least as if this many players were fighting.
maxScaledPlayers	8	Count at most this many players.
requireCombatTarget	true	Only heal while the boss has someone to fight.
pauseWhenNoPlayersNearby	true	Stop healing when no player is near.
startDelaySeconds	10	Wait this long after the boss appears before it starts healing.
tickIntervalSeconds	2	Heal in steps every this many seconds.
maxHealPercentPerSecond	1.0	Never heal more than this percent of max health per second (0 = no limit).

bossCombatPressure

A damage aura that hits players who stay close to a boss.

Setting	Default	What it does
enabled	true	Damage aura around bosses.
tickIntervalSeconds	6	Seconds between two hits of the aura.
radius	10	Players within this many blocks are hit.
damage	1.5	Damage per hit (2 = one heart).
damagePerActivePlayer	0.35	Extra damage per player in the fight.
maxScaledPlayers	8	Count at most this many players.
effectDurationSeconds	4	How long the aura's effects last.
enableDebuffs	true	Apply the boss's effects (slowness, weakness, ...).
enableDamageOverTime	true	Deal the aura damage.
enableParticles	true	Show particles for the aura.
enableSounds	true	Play sounds for the aura.
particleMultiplier	1.0	More or fewer aura particles.
morvathLifeStealMultiplier	1.0	Morvath heals by this share of the aura damage he deals (0 = off).

bossScaling

Settings that apply to all bosses: global multipliers, arena rules, limits.

Setting	Default	What it does
enabled	true	Use the settings of this section.
globalHealthMultiplier	1.0	Multiplies the health of every boss.
globalDamageMultiplier	1.0	Multiplies the damage of every boss.
globalXpMultiplier	1.0	Multiplies the XP every boss drops.
extraRaidCaches	0	Extra raid caches each player gets per kill.
maxAliveBossesPerWorld	5	Most bosses that may be alive at once near a shrine (0 = no limit).
enableAntiCheese	true	Heal and pull back bosses whose fight leaves the arena (pillaring, luring away).
arenaRadius	64	Radius of the arena around the spawn point, in blocks.
bossLeashExtraRadius	32	The boss may go this far past the arena before it is pulled back.
outOfArenaHealPerSecond	1.0	Healing per second while all players are outside the arena.
bossOutsideArenaHealPerSecond	0.5	Healing per second while the boss itself is outside the arena.
teleportBossBackToArena	true	Teleport a boss back that stays outside the arena too long.
teleportBackAfterSeconds	20	How long outside the arena before it is teleported back.
warningIntervalSeconds	10	Seconds between two arena warnings to players.
activeBossSearchRadius	8192	Radius in which living bosses are counted for maxAliveBossesPerWorld.
maxBossLifetimeSeconds	86400	A boss disappears after this many seconds (86400 = 24 hours, 0 = never).
enableMaceDamageCap	true	Limit the damage of mace hits on bosses.
maxMaceDamage	18.0	Most damage a single mace hit can deal to a boss.
countCreativePlayersAsArenaParticipants	true	Players in creative mode count as fighters.
despawnWhenNoPlayersNearby	false	Remove a boss when nobody has been near it for a while.
despawnAfterNoPlayersSeconds	1800	How long with nobody near before it is removed.
warningMessages	true	Show arena warnings in the chat.
dropRewardsWhenNoEligiblePlayers	true	Drop the rewards on the ground if nobody qualifies for them.
allowAnyDimension	false	Shrine rituals work in every dimension, e.g. Nether and End bosses in the Overworld. Biome rules then only apply in the boss's home dimension.

loyalCompanionsCompatibility

Limits for pets from the Loyal Companions mod, so they cannot kill bosses on their own.

Setting	Default	What it does
enabled	true	Limit the damage pets deal to bosses.
maxCompanionDamagePercentOfBossMaxHealth	0.5	Pets may deal at most this share of a boss's max health in total (0.5 = 50%).
maxCompanionDamagePerHit	0.0	Most damage per pet hit (0 = no limit).
minimumCompanionDamagePerHit	1.0	Pet hits always deal at least this much.
recordCompanionOwnerAsParticipant	true	A pet's owner counts as fighter when the pet hits the boss.
debugDamageCaps	false	Log when a pet hit was reduced.

shrineLocator

The Shrine Locator Compass.

Setting	Default	What it does
locateRadiusBlocks	4096	How far the compass searches, in blocks.
includePredictedWorldgenCandidates	true	Also show spots where a shrine will be placed once the area is explored.
showShrineType	true	Name the shrine type in the result.
showCoordinates	true	Show the coordinates.
showDistance	true	Show the distance.
playSound	true	Play a sound when used.
spawnParticles	true	Show particles when used.
generatePredictedShrinesOnLocate	true	Build the found shrine right away if it only exists as a planned spot.

worldbreakerPortal

What the bosses drop to open the Worldbreaker portal.

Setting	Default	What it does
dustPerBossMin	2	Least Worldbreaker Dust per player from each of the six first bosses.
dustPerBossMax	4	Most Worldbreaker Dust per player.
sparksPerAstraelKill	1	Primordial Sparks per player from Astrael.

realmSpawning

Natural mob spawning in the Worldbreaker realm.

Setting	Default	What it does
monsterCap	50	Most hostile mobs at once in the realm per player area (vanilla uses 70).
stormSpiritSpawnChance	0.25	Share of the storm spirit spawn attempts that succeed (0.25 = one in four).
stormSpiritMaxNearby	3	No new storm spirits appear while this many are already within 48 blocks.
stormSpiritPortalSafeRadius	64	Storm spirits never spawn this close to a Worldbreaker portal (blocks).

recipes

Switch off recipes of the mod.

Setting	Default	What it does
shrineLocatorCompass	true	The Shrine Locator Compass can be crafted. Off also stops existing compasses from working. Takes effect after /worldbosses reload and /reload.
shrines	true	The Overworld, Nether and End shrines can be crafted. Off: only the shrines in the world can be used. Takes effect after /worldbosses reload and /reload.

codex

The Boss Codex book.

Setting	Default	What it does
giveOnFirstJoin	true	Give every player a Boss Codex when they join the world for the first time.

partyLinkCompatibility

Works together with the PartyLink mod: parties share boss rewards and hear about summoned bosses.

Setting	Default	What it does
enabled	true	Use the PartyLink mod when it is installed.
shareRewardsWithParty	true	Party members near a defeated boss get the rewards and advancement too, even if they never hit it.
partyRewardRadius	96	How close to the boss party members must be, in blocks.
announceSummonsToParty	true	Tell the party when a member summons a boss and ping the boss for them.

Boss settings

Each boss has its own section (sylvaron, aureon, … shadowWeaver) with the same basic settings:

Setting	What it does
maxHealth	Health. Values over 1024 work: the boss then takes less damage per hit instead.
attackDamage	Melee damage (2 = one heart).
armor	Armor points, like player armor.
followRange	How far the boss sees and follows players, in blocks.
movementSpeed	Walking speed (a player walks at about 0.1).
knockbackResistance	0 = normal knockback, 1 = none at all.
shrineCooldownSeconds	Seconds before the shrine can summon this boss again (0 = right away).
participantRewardRadius	Players within this many blocks when the boss dies get rewards.
xpReward	XP dropped when it dies.
ritualDurationSeconds	How long the summoning ritual takes.
enableVisionEffects	Allow blindness and darkness effects from this boss.

spawnRules – Where the boss may be summoned. allowedBiomes takes biome ids or biome tags like #minecraft:is_forest.

raidScaling – The boss gets stronger when more players fight it.

Setting	What it does
enabled	Scale health and damage with the number of players.
announceChanges	Tell players when the boss scales up.
onlyScaleUp	Never scale back down when players leave.
basePlayerCount	Players the base values are made for.
maxScaledPlayers	Scale for at most this many players.
activeParticipantTimeoutSeconds	A player stops counting after this long without hitting the boss.
activeParticipantRadius	Players within this many blocks can count.
healthPerExtraPlayerPercent	Extra health for every player above the base count, in percent.
damagePerExtraPlayerPercent	Extra damage for every player above the base count, in percent.

phases – The boss changes phase at certain health levels.

Setting	What it does
enabled	Use phases.
announcePhaseChanges	Announce a new phase in the chat.
phase2HealthPercent	Phase 2 starts below this much health (percent).
phase3HealthPercent	Phase 3 starts below this much health (percent).
phase1BossBarColor	Boss bar colour: PINK, BLUE, RED, GREEN, YELLOW, PURPLE or WHITE.
phase2BossBarColor	Boss bar colour in phase 2.
phase3BossBarColor	Boss bar colour in phase 3.
phase2Message	Chat message at the start of phase 2.
phase3Message	Chat message at the start of phase 3.
phase2CooldownMultiplier	Skill cooldowns in phase 2 are multiplied by this (0.8 = 20% faster).
phase3CooldownMultiplier	Skill cooldowns in phase 3 are multiplied by this.
phase2DamageMultiplier	Skill damage in phase 2 is multiplied by this.
phase3DamageMultiplier	Skill damage in phase 3 is multiplied by this.
phase2ParticleMultiplier	More particles in phase 2.
phase3ParticleMultiplier	More particles in phase 3.
phaseChangeParticles	Particles when the phase changes.
phaseBroadcastRadius	Players within this many blocks see the phase message.

Skills – every skill has its own section (for example sylvaron.sporeBurst). These fields appear in them:

Setting	What it does
blindnessDurationSeconds	Seconds of blindness.
chainVisualDensity	How dense the chain particles are.
coneAngleDegrees	Width of the cone in front of the boss, in degrees.
cooldownSeconds	Seconds before the skill can be used again.
damage	Damage per hit (2 = one heart).
damagePerTick	Damage each time it ticks.
darknessDurationSeconds	Seconds of darkness.
durationSeconds	How long it lasts.
enabled	Turn this on or off.
fireSeconds	Seconds players burn after a hit.
healAmount	Health the boss gets back.
hitRadius	Players this close to the impact are hit.
initialDelaySeconds	Seconds after the boss appears before it may use this skill.
innerSafeRadius	Safe space in the middle of the fire ring.
knockbackStrength	How hard players are thrown back.
levitationDurationSeconds	Seconds of levitation.
linkRingParticles	Particles per chain link.
linkRingRadius	Size of a chain link.
markersPerPlayer	Marked spots per player.
maxTravelSeconds	The projectile disappears after this long.
particleCount	Particles shown for it.
poisonAmplifier	Poison level (0 = level I).
poisonDurationSeconds	Seconds of poison.
prePullStrength	Pull while the skill is still winding up.
projectileSpeed	Speed of the projectile.
pullDuringDrain	Pull players while draining them.
pullDuringTelegraph	Already pull during the warning time.
pullPlayersToStormCenter	Pull players to the middle of the storm.
pullStrength	How hard players are pulled.
radius	Range of the skill, in blocks.
scatterRadius	How far the impacts spread around each player.
slownessAmplifier	Slowness level (0 = level I).
slownessDurationSeconds	Seconds of slowness.
spikesPerPlayer	Spikes per player.
tickIntervalSeconds	Seconds between two ticks of damage.
wallThickness	Thickness of the lightning wall.
warningDelayTicks	Warning time before the skill hits (20 ticks = 1 second).
weaknessDurationSeconds	Seconds of weakness.
witherDurationSeconds	Seconds of wither.

Raid cache loot

Each raid cache has a folder config/worldbosses/raid_caches/<cache>/:

• settings.json – display name and speed of the opening animation.
• common.json, uncommon.json, rare.json, epic.json, legendary.json – one file per rarity.

Setting	What it does
categoryWeight	Chance of this rarity compared to the others. Higher = more often.
enabled	Turn this on or off.
rewards	Possible rewards of this rarity.
rewards › item	Item id, e.g. "minecraft:diamond".
rewards › label	Name shown in the opening animation.
rewards › minCount	Least amount.
rewards › maxCount	Most amount.
rewards › xpBonus	XP given together with this reward.
rewards › weight	Chance compared to the other rewards in this list. Higher = more often.
rewards › enabled	Can be won.

The current default loot is listed on Raid Caches.