Apotheosis Balance Configurator

Apotheosis Balance Configurator

Balance Apotheosis through a config file, no JSON editing required. Apotheosis too strong for your server? Want to cut all damage by half? This mod lets you scale all Apotheosis values from a single TOML config, with optional per-attribute tuning on top.

_Works with Apotheotic Additions._

***

What does this mod do?

Multiplies Apotheosis values

The mod multiplies all numerical values in the Apotheosis Adventure module:

• Gem bonuses (damage, attack speed, armor, health, etc.)
• Weapon and armor affixes (all attribute modifiers)
• Enchantments and effects (levels, duration)
• Loot quality (number of affixes on items)
• Loot rarity (shift min/max rarity tiers)
• Effect affixes (Catalyzing, Cleaving, Enlightened, Executing, Festive, Psychic, Spectral Shot, Thunderstruck)
• Special bonuses (Bloody Arrow, Leech Block, Mage Slayer, etc.)

Per-attribute control

A separate attributes.cfg file gives you individual multipliers for every registered attribute in the game. Need to nerf health but leave damage alone? Just set a different multiplier for that attribute.

Final Value = Base Value x Global Multiplier x Attribute Multiplier

Server-client sync

In multiplayer, the server config overrides client settings when a player joins. Everyone plays with the same balance, no manual syncing needed. When a player disconnects, their local config comes back.

Runtime changes via mixins

Changes apply automatically without editing hundreds of JSON files. Tooltips update too.

***

How it works

New Value = Old Value x Multiplier

Examples:

• Gem gives +10 damage, multiplier = 0.5 -> result: +5 damage
• Gem gives +100% attack speed, multiplier = 0.2 -> result: +20% attack speed
• Global multiplier 0.5 + attribute multiplier 0.8 on a +10 base -> result: +4

***

Configuration

Main config: config/apotheosisbalancer-common.toml

Multipliers

Base Apotheosis multiplier:

# Multiplier for all base Apotheosis values
# 1.0 = no change (default)
# 0.5 = reduce all by 50%
# 0.2 = reduce all by 80% (hardcore balance)
# 2.0 = double all values (easy mode)
apotheosisMultiplier = 1.0

Apotheotic Additions multiplier:

# Separate multiplier for the ApotheoticAdditions addon
# This addon adds powerful rarities: Relic, Heirloom, Esoteric
# Recommended: 0.6-0.7 for balance
additionsMultiplier = 1.0

Fallback multiplier:

# Used when mod detection fails
# Should usually match apotheosisMultiplier
fallbackMultiplier = 1.0

***

Loot quality

# Multiplier for item quality
# Quality affects:
#   - Number of affixes on items
#   - Drop chance with luck
#
# Lower quality = simpler items
qualityMultiplier = 1.0

***

Rarity shifting

# Shift minimum rarity for all loot drops
# Positive = increase rarity, Negative = decrease rarity
# Won't cross Apotheosis/ApotheoticAdditions namespace boundaries
#
# Examples:
#   0 = no change
#  -1 = decrease by 1 level (rare -> uncommon)
#  -2 = decrease by 2 levels (mythic -> rare)
#  +1 = increase by 1 level (common -> uncommon)
minRarityOffset = 0

# Shift maximum rarity for all loot drops
# Works the same as minRarityOffset
maxRarityOffset = 0

***

Toggle bonus types

# Enable/disable balancing for specific bonus categories
enableAttributeBalance = true      # attack speed, damage, armor, health, etc.
enableEnchantmentBalance = true    # enchantment levels from gems
enablePotionBalance = true         # potion duration, amplifier, cooldown
enableSpecialBalance = true        # bloody arrow, leech block, durability, etc.

***

Rounding modes

# Rounding mode for enchantment levels:
#   STANDARD          - standard rounding (1.5 -> 2, 1.4 -> 1)
#   CEIL_IF_ABOVE_ONE - if >= 1.0, round up to at least 2 (1.05 -> 2)
#   ALWAYS_CEIL       - always round up (1.1 -> 2)
#   ALWAYS_FLOOR      - always round down (1.9 -> 1)
# Minimum enchantment level: 1
enchantmentRounding = "ALWAYS_CEIL"

# Rounding mode for potion effect amplifiers
# Same modes as above
# Minimum amplifier: 0 (Strength I = amplifier 0)
potionRounding = "ALWAYS_CEIL"

Note: enchantments have a minimum level of 1, but potion amplifiers start at 0.

***

Per-attribute config: config/attributes.cfg

This file is auto-generated with every registered attribute in the game. Each attribute gets its own multiplier that stacks on top of the global one.

# Example: nerf health bonuses specifically
[minecraft:generic.max_health]
multiplier = 0.5

# Leave damage at default (uses global multiplier only)
[minecraft:generic.attack_damage]
multiplier = 1.0

***

Debug

# Enable detailed logging to console
# WARNING: creates a lot of log messages
enableDebugLogging = false

# Show detailed caller information (requires enableDebugLogging = true)
showCallerInfo = false

***

What's covered

The mod handles all Apotheosis bonus types:

• Regular attributes
• Multi-attributes (Royalty gem)
• Enchantments
• Potion effects
• Damage reduction
• Durability
• All stats
• Mage Slayer
• Drop transformation
• Bloody Arrow
• Leech Block
• Effect affixes (8 types)

Gems, affixes, loot quality, per-attribute tuning. If Apotheosis Adventure module touches it, this mod can scale it.

***

Alternative: Diminished Apotheosis datapack

Don't want a mod? The Diminished Apotheosis datapack has a fixed 80%/60% reduction.

| Feature | This mod | Datapack | | --- | --- | --- | | Custom % | Any via config | Fixed 80%/60% | | Separate multipliers | Per-mod | Manual editing | | Per-attribute control | Yes | No | | Server sync | Automatic | N/A | | Rarity shifting | Yes | No | | Toggle bonuses | Yes | Delete files | | Ease of use | Single config | Drop-in |