Apotheosis Balance Configurator

Apotheosis Balance Configurator

Configure Apotheosis balance through simple config file - no JSON editing required!

by
15.0K Downloads
forgeneoforgeutility
Rent Server with this Mod

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

Apotheosis Balance Configurator 2.0.0release
MC 1.21.1neoforge
May 25, 2026
Apotheosis Balance Configurator 1.1.6release
MC 1.20.1forge
May 25, 2026
Apotheosis Balance Configurator 1.1.5release
MC 1.20.1forge
February 8, 2026
Apotheosis Balance Configurator 1.1.3release
MC 1.20.1forge
December 5, 2025
Apotheosis Balance Configurator 1.0.0release
MC 1.20.1forge
October 29, 2025

How to Install Apotheosis Balance Configurator on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).

3

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

forgeneoforge

Minecraft Versions

1.21.1, 1.20.1

Server-side

Required

Recommended 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.

Rent Modded Server

Install Apotheosis Balance Configurator with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
LicenseRef-All-Rights-Reserved
Server-side
Required

Supported Versions

1.21.11.20.1