#Written after config migration; do not edit manually.
# Default: 0
# Range: > 0
config_schema_version = 0

["Master Toggles"]
	#Master control switches for major systems.
	#Disabling a master toggle will disable all related features.
	#Mana Unification Mode - Controls how Ars Nouveau and Iron's Spellbooks mana systems interact:
	#  iss_primary - Iron's Spellbooks mana is the single source (DEFAULT)
	#  ars_primary - Ars Nouveau mana is the single source
	#  hybrid - Both systems share a unified mana pool
	#  separate - Separate pools with dual-cost mechanics
	#  disabled - No mana integration at all
	#Runtime changes are applied on the server thread and synchronized to connected clients.
	mana_unification_mode = "iss_primary"
	#Master toggle for all mana unification features
	enable_mana_unification = true
	#Master toggle for the Resonance system (full mana bonuses)
	enable_resonance_system = true
	#Master toggle for unified cooldown system
	enable_cooldown_system = false
	#Master toggle for cross-mod progression system
	enable_progression_system = true
	#Master toggle for affinity/attunement system
	enable_affinity_system = true
	#Enable debug logging for troubleshooting
	debug_mode = false

["Mana Unification"]
	#Fine-tune how mana conversion and synchronization works.
	#These settings only apply when mana unification is enabled.
	#Conversion rate from Ars mana to Iron's mana (1.0 = 1:1)
	# Default: 1.0
	# Range: 0.01 ~ 10.0
	conversion_rate_ars_to_iron = 1.0
	#Conversion rate from Iron's mana to Ars mana (1.0 = 1:1)
	# Default: 1.0
	# Range: 0.01 ~ 10.0
	conversion_rate_iron_to_ars = 1.0
	#Which mana bar to display in HYBRID mode:
	#  irons - Show Iron's Spellbooks mana bar
	#  ars - Show Ars Nouveau mana bar
	#Only applies when mana_unification_mode is set to 'hybrid'
	hybrid_mana_bar = "irons"
	#Percentage of Ars mana cost in SEPARATE mode (0.5 = 50%)
	# Default: 0.5
	# Range: 0.0 ~ 1.0
	dual_cost_ars_percentage = 0.5
	#Percentage of ISS mana cost in SEPARATE mode (0.5 = 50%)
	# Default: 0.5
	# Range: 0.0 ~ 1.0
	dual_cost_iss_percentage = 0.5
	#Default maximum mana fallback when the native system returns no value.
	#Can be changed at runtime with /ans mana setdefault <value>
	#Applies to both Ars Nouveau and Iron's Spellbooks bridge fallbacks.
	# Default: 100.0
	# Range: 1.0 ~ 100000.0
	default_max_mana = 100.0
	#Include armor bonuses in unified mana calculations
	respect_armor_bonuses = true
	#Include enchantment bonuses in unified mana calculations
	respect_enchantments = true
	#How mana regen values are translated when crossing the Ars / Iron's boundary.
	#Iron's regen is a percentage-of-pool multiplier; Ars regen is absolute mana/sec.
	#Without conversion, an Ars enchantment like Mana Regen III applied to Iron's regen
	#will produce hundreds of mana/sec because the absolute value is misread as a percentage.
	#  EQUAL_EFFECT  - Convert by the target system's current max pool (DEFAULT, recommended).
	#                  Preserves equivalent mana/sec on both sides at any pool size.
	#  REFERENCE_POOL - Convert using a fixed reference pool (see cross_system_regen_reference_pool).
	#                   Predictable but ignores the wearer's actual pool size.
	#  DISABLED      - Do not translate cross-system regen at all. Mana Regen enchantments
	#                  on Ars only affect Ars; Iron's gear regen only affects Iron's.
	cross_system_regen_conversion = "EQUAL_EFFECT"
	#Global dampener applied to every cross-system regen translation.
	#Use to tone down or boost the strength of cross-mod regen bonuses without
	#disabling them entirely. 1.0 = full strength, 0.5 = half, 2.0 = double.
	# Default: 1.0
	# Range: 0.0 ~ 100.0
	cross_system_regen_multiplier = 1.0
	#Reference pool size used by REFERENCE_POOL conversion mode.
	#Has no effect when cross_system_regen_conversion is EQUAL_EFFECT or DISABLED.
	# Default: 100.0
	# Range: 1.0 ~ 100000.0
	cross_system_regen_reference_pool = 100.0

["Resonance System"]
	#Resonance grants bonuses when mana is at maximum.
	#Requires ENABLE_RESONANCE_SYSTEM master toggle.
	#Enable resonance bonuses for Ars Nouveau spells
	enable_ars_resonance = true
	#Enable resonance bonuses for Iron's Spellbooks spells
	enable_irons_resonance = true
	#Global multiplier for all resonance bonuses
	# Default: 1.0
	# Range: 0.0 ~ 10.0
	resonance_strength = 1.0
	#Mana fraction at or above which resonance applies (0.95 = 95% full).
	#The bonus itself still scales with how full the pool is; this only
	#gates whether it applies at all.
	#The default 0.95 matches the Forge variant. Set 0.0 to leave the gate open.
	#Existing saved values are preserved.
	# Default: 0.95
	# Range: 0.0 ~ 1.0
	resonance_threshold = 0.95
	#How long resonance keeps applying after the pool drops below
	#resonance_threshold, in ticks (20 = 1 second).
	#This is what makes a raised threshold playable: spending mana to cast
	#necessarily drops you below it, so without a linger the bonus would
	#switch off on the very cast that earned it.
	#Has no effect while resonance_threshold is 0.
	#Resolution is the recompute interval (40 ticks), so the effective
	#linger is this value give or take one interval.
	# Default: 100
	# Range: 0 ~ 1200
	resonance_duration = 100
	#Maximum damage multiplier from resonance
	# Default: 5.0
	# Range: 1.0 ~ 100.0
	max_damage_multiplier = 5.0

["Cooldown System"]
	#Unified cooldown system prevents spell spam across mods.
	#Requires ENABLE_COOLDOWN_SYSTEM master toggle.
	#Enable cross-mod cooldown sharing
	enable_unified_cooldowns = false
	#CRITICAL: Enable cross-mod cooldown interference (false = each mod has independent cooldowns)
	enable_cross_mod_cooldowns = false
	#Base category cooldown duration (ticks, 20 = 1 second)
	# Default: 100
	# Range: 0 ~ 10000
	cooldown_category_duration = 100
	#Multiplier for cross-mod cooldowns (0.5 = 50% of normal)
	# Default: 0.5
	# Range: 0.0 ~ 10.0
	cross_mod_cooldown_multiplier = 0.5

["Progression System"]
	#Cross-mod progression allows spell usage to grant XP in both systems.
	#Requires ENABLE_PROGRESSION_SYSTEM master toggle.
	#Allow Ars spells to grant ISS XP and vice versa
	enable_cross_mod_progression = true
	#Attribute bonus gained per cast in a school (audit F4 - was hardcoded 0.001).
	#0.001 = +0.1% per cast. The bonus is transient (derived from the persistent
	#cast count), so changing this immediately rescales every player's bonus.
	# Default: 0.001
	# Range: 0.0 ~ 0.1
	progression_bonus_per_cast = 0.001
	#Cap on the per-school progression attribute bonus (audit F4 - was hardcoded 0.25).
	#0.25 = +25% maximum, reached after bonus_cap / bonus_per_cast casts
	#(250 casts at defaults).
	# Default: 0.25
	# Range: 0.0 ~ 2.0
	progression_bonus_cap = 0.25

["Affinity System"]
	#Affinity system tracks spell school preferences and grants bonuses.
	#Requires ENABLE_AFFINITY_SYSTEM master toggle.
	#Enable affinity decay when not using a school. Default off for fresh installs (1.9.0).
	enable_affinity_decay = false
	#Rate of affinity decay per day (in-game)
	# Default: 0.01
	# Range: 0.0 ~ 1.0
	affinity_decay_rate = 0.01
	#Ticks between AffinityDecayHandler runs (20 = 1s, 1200 = 60s). Decay per run is prorated from AFFINITY_DECAY_RATE.
	# Default: 1200
	# Range: 20 ~ 24000
	affinity_decay_interval_ticks = 1200

["Curio Discount System"]
	#Mana cost discounts from Covenant of the Seven curios.
	#Ring of Virtue and Blasphemy curios can reduce Ars Nouveau spell costs.
	#Enable mana cost discounts from curios tagged #ars_n_spells:curio_spell_discount.
	enable_curio_discounts = true
	#Per-curio mana cost discount for items in #ars_n_spells:curio_spell_discount
	#(0.20 = each tagged curio multiplies cost by 0.80). Applies to both Ars and
	#Iron's Spellbooks casts.
	# Default: 0.2
	# Range: 0.0 ~ 1.0
	virtue_ring_discount = 0.2
	#Hard cap on the COMBINED tagged-curio discount across all worn curios
	#(0.50 = spells never cost less than 50% after curio discounts). Prevents
	#stacked discount curios from trivialising mana cost.
	# Default: 0.5
	# Range: 0.0 ~ 1.0
	max_total_curio_discount = 0.5
	#Read attribute modifiers from worn Curios for cross-system equipment bonuses.
	#Disable if another integration already mirrors those modifiers.
	read_curio_attribute_modifiers = true

["Scroll Cost System"]
	#Controls what an Iron's Spellbooks scroll costs to use.
	#Cost mode for Iron's Spellbooks scroll usage:
	#  full - Scrolls cost the same as casting the spell normally
	#  lp_only - Scrolls are free of mana cost but still consume LP if Cursed Ring equipped
	#  free - Scrolls have no resource cost (LP from Cursed Ring still applies)
	#Note: wearing the Cursed Ring (with enable_lp_system on) makes LP REPLACE mana,
	#exactly as it does for normal casting - a ring wearer is never charged both.
	#The LP half of this setting is inert on 1.21.1: Covenant of the Seven has no
	#1.21.1 release, so lp_only behaves as free until that integration returns.
	scroll_cost_mode = "full"

["Spell Scaling"]
	#Controls how spell power from Iron's attributes scales Ars spells.
	#Maximum total spell power multiplier from Iron's attributes.
	#Prevents stacking from exceeding this value. Set higher to allow more scaling.
	# Default: 3.0
	# Range: 1.0 ~ 10.0
	spell_power_cap = 3.0
	#Master switch for both directions of cross-mod spell damage scaling:
	#Iron's spell power scaling Ars spell damage, and Ars' Spell Damage Bonus
	#perk adding to Iron's spell damage.
	#This is independent of the mana-unification mode: both directions stay
	#active even when mana unification is DISABLED, because a player who earned
	#the stats on either side should keep them regardless of how mana is pooled.
	enable_cross_mod_combat_stats = true
	#Iron's -> Ars direction: scale Ars Nouveau spell damage by the caster's
	#Iron's spell power attributes (generic + the matching school), affinity and
	#resonance, capped by spell_power_cap.
	#Independent of the mana-unification mode; active even when mana
	#unification is DISABLED.
	enable_irons_power_for_ars_damage = true
	#Ars -> Iron's direction: add the caster's Ars Nouveau Spell Damage Bonus
	#perk value to Iron's spell damage as a flat addition, matching how Ars
	#itself applies that attribute. Not affected by spell_power_cap, which is a
	#multiplier cap and must not clamp a flat bonus.
	#Independent of the mana-unification mode; active even when mana
	#unification is DISABLED.
	enable_ars_damage_for_irons_damage = true
	#How a spell that resolves to more than one school picks the Iron's elemental
	#spell power attribute it scales with (dual-element and compound-element
	#addon glyphs, and recipes that chain effects from different schools):
	#  primary (default) - only the first-resolved school scales the spell, the same one
	#            affinity and progression credit
	#  max - the single strongest matching elemental attribute (DEFAULT)
	#  average - the mean of all matching elemental attributes
	#There is deliberately no 'sum' option: adding every matching bonus would
	#make a spell stronger purely for carrying more school labels, so an
	#all-element glyph would collect fire, ice, lightning and nature power at
	#once. Unknown values fall back to 'max'.
	multi_school_power_policy = "primary"

["Source Jar Synergy"]
	#Controls the passive mana regen bonus when near Ars Nouveau Source Jars.
	#Master kill switch for the Source Jar proximity regen synergy.
	#Set false to disable the periodic block scan entirely (zero per-tick cost).
	#This is the supported way to turn the feature off;
	#source_jar_synergy_multiplier keeps its 0.1 minimum. (ANS-CRIT-005 follow-up)
	enable_source_jar_synergy = true
	#Ticks between Source Jar proximity checks per player (20 = once per second).
	#Raise on busy servers to reduce scan cost.
	# Default: 20
	# Range: 1 ~ 200
	source_jar_scan_interval_ticks = 20
	#Horizontal scan radius in blocks around the player.
	#Any value up to the hard cap of 8 covers at most a 2x2 chunk area.
	#The scan never loads chunks - cycles near unloaded chunks are skipped and retried.
	# Default: 4
	# Range: 1 ~ 8
	source_jar_scan_radius = 4
	#Multiplier for Source Jar proximity regen bonus.
	#Higher values = stronger regen when standing near Source Jars.
	#Final bonus = CONVERSION_RATE_ARS_TO_IRON * this value per second.
	# Default: 5.0
	# Range: 0.01 ~ 2000.0
	source_jar_synergy_multiplier = 5.0

[Rituals]
	#Configuration for Ars 'n' Spells custom rituals.
	#Amount of mana added by the Ritual of Mana Infusion
	# Default: 500.0
	# Range: 1.0 ~ 10000.0
	ritual_mana_infusion_amount = 500.0
	#Radius in blocks for Mana Well ritual effect
	# Default: 8
	# Range: 1 ~ 64
	mana_well_range = 8
	#Mana per tick granted to players within Mana Well range
	# Default: 2.0
	# Range: 0.1 ~ 100.0
	mana_well_regen_rate = 2.0

["Cross-Cast Inscription"]
	#Controls spells cast from items inscribed via the Spell Transcription ritual.
	#The inscription mechanic itself lives in the datapack recipe under
	#data/ars_n_spells/recipes/apparatus/ -- pack authors can swap ingredients there.
	#Mana pricing policy: flat_legacy applies directional rates; equal_percent also applies target/source native maximum.
	#Server-owned. A quote captures the selected policy; reloading does not reprice a committed cast.
	conversion_policy = "flat_legacy"
	#Multiplier applied to the base mana cost of a spell cast from an inscribed item.
	#Represents the overhead of casting through a foreign mod's form. 1.0 = no overhead,
	#1.25 = 25% extra cost (default). Applied once, after base cost calculation and
	#before mana deduction. Routed through BridgeManager, so it composes with the
	#active mana unification mode and SEPARATE-mode dual-cost splitting.
	# Default: 1.25
	# Range: 0.5 ~ 5.0
	cross_cast_cost_multiplier = 1.25
	#Maximum sustained cross-cast/cycle requests per player per second. Server-owned; live reload.
	#Repeated request IDs are ignored independently for 60 seconds. Does not limit native casts.
	# Default: 10
	# Range: 1 ~ 20
	network_request_rate_per_second = 10
	#Immediate cross-cast/cycle request burst per player. Allows ordinary double clicks and latency bursts.
	# Default: 4
	# Range: 1 ~ 20
	network_request_burst = 4
	#Allow Ars Nouveau spells to be bound onto Iron's Spellbooks spellbooks, where
	#they appear as their own entries in Iron's native spell wheel and cast through
	#Ars 'n Spells' cross-cast pipeline. Disabling rejects new binds with a clear
	#message; spells already bound keep working. No effect without Iron's installed.
	allow_ars_spells_in_irons_spellbooks = true
	#Maximum number of Ars spells that may be bound onto a single Iron's spellbook.
	#-1 = no cap (default). Whatever the value, it is bounded at runtime by the
	#native-wheel proxy pool size (8): only that many
	#Ars entries can be shown as distinct entries in Iron's spell wheel per book.
	# Default: -1
	# Range: -1 ~ 64
	max_ars_cross_spells_per_irons_spellbook = -1

[Performance]
	#Performance optimization settings
	#Distance in blocks a player must move before re-scanning for Source Jars.
	#Higher values = less scanning but slower detection of jar changes.
	# Default: 4.0
	# Range: 1.0 ~ 32.0
	source_jar_cache_move_threshold = 4.0