
Apotheosis Balance Configurator
Configure Apotheosis balance through simple config file - no JSON editing required!
About this Mod
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 |
The mod gives you full control. The datapack is a ready-made solution if that's all you need.
Available Versions
How to Install Apotheosis Balance Configurator on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Apotheosis Balance Configurator". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Apotheosis Balance Configurator server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Apotheosis Balance Configurator compatible with forge and neoforge?
Apotheosis Balance Configurator officially supports forge, neoforge for Minecraft 1.21.1, 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Apotheosis Balance Configurator – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Apotheosis Balance Configurator consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Apotheosis Balance Configurator with just one click on your server.