Wiki

effect · add_mio_funds_gain_factor

Definition

  • Supported scope:INDUSTRIAL_ORG
  • Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

Add to the factor applied when gaining funds in the military industrial organization in scope.
This changes the base value. Modifiers will still apply over it.
Value can be negative to reduce assign cost but final value cannot be negative (capped at 0, no error raised)
ex:
mio:my_mio = {
  add_mio_funds_gain_factor = 0.2
  add_mio_funds_gain_factor = -0.1
  add_mio_funds_gain_factor = var:my_number_var
}

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

When you want to continuously boost a Military Industrial Organization's fund acquisition efficiency through specific MIO traits, unlocks, or event rewards, you can use this effect. For example, after a player completes a research milestone for a particular MIO, grant it a permanent fund gain bonus so that subsequent fund accumulation proceeds faster, accelerating the unlock of additional traits.

mio:my_arms_company = {
    add_mio_funds_gain_factor = 0.15
}

Synergy

  • [add_mio_funds](/wiki/effect/add_mio_funds): Injects a one-time lump sum of funds. When combined with add_mio_funds_gain_factor, it creates a dual-acceleration pattern of "instant + sustained" growth, commonly used in reward events.
  • [set_mio_funds_gain_factor](/wiki/effect/set_mio_funds_gain_factor): Resets the gain factor to an absolute value. When you need to zero out the factor first and then layer new values via add_mio_funds_gain_factor, using both together enables precise control.
  • [has_mio_size](/wiki/trigger/has_mio_size): Functions as a prerequisite check to ensure that only MIOs reaching a certain size threshold can trigger this effect, preventing excessively strong fund rewards from being applied to undersized organizations.
  • [is_mio_trait_completed](/wiki/trigger/is_mio_trait_completed): Often serves as a conditional gate, stacking the gain factor only when a specific trait has been completed, ensuring that game progression pacing is not disrupted prematurely.

Common Pitfalls

  1. Mistakenly using negative values to completely zero out: Beginners often assume that passing a sufficiently large negative number will zero the fund gain factor or even reverse it, but in reality the final value is automatically clamped to 0, preventing any negative fund loss. To achieve precise zeroing, use set_mio_funds_gain_factor instead.
  2. Calling within the wrong scope: This effect must be executed within the INDUSTRIAL_ORG scope. Placing it directly in a country scope effect block will not execute and will not produce an error, causing the value to silently disappear—an extremely difficult issue to debug.