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:** ```toml # 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:** ```toml # 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:** ```toml # Used when mod detection fails # Should usually match apotheosisMultiplier fallbackMultiplier = 1.0 ``` *** ### Loot quality ```toml # Multiplier for item quality # Quality affects: # - Number of affixes on items # - Drop chance with luck # # Lower quality = simpler items qualityMultiplier = 1.0 ``` *** ### Rarity shifting ```toml # 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 ```toml # 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 ```toml # 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. ```ini # Example: nerf health bonuses specifically multiplier = 0.5 # Leave damage at default (uses global multiplier only) multiplier = 1.0 ``` *** ### Debug ```toml # 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 handle