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
}

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

当你希望通过特定 MIO 特性解锁或事件奖励来持续提升该军工组织的资金获取效率时，可以使用此 effect。例如，当玩家为某军工组织完成一项研究里程碑后，给予其一个永久的资金增益加成，使后续每轮资金积累更快，加速解锁更多特性。

mio:my_arms_company = {
    add_mio_funds_gain_factor = 0.15
}

配合关系

[add_mio_funds](/wiki/effect/add_mio_funds)：直接注入一次性资金，与 add_mio_funds_gain_factor 的长期增益形成"即时 + 持续"的双重资金加速组合，常用于奖励事件。
[set_mio_funds_gain_factor](/wiki/effect/set_mio_funds_gain_factor)：用于将增益因子重置到一个绝对值，当你需要先归零再由 add_mio_funds_gain_factor 叠加新值时，两者配合可实现精确控制。
[has_mio_size](/wiki/trigger/has_mio_size)：作为前置条件检查，确保只有达到一定规模的军工组织才能触发本 effect，避免在组织规模过小时给予过强的资金收益。
[is_mio_trait_completed](/wiki/trigger/is_mio_trait_completed)：常作为条件门槛，仅当某特性已完成时才叠加增益因子，保证游戏进程节奏不被提前打破。

常见坑

误将负值用于彻底清零：新手容易认为传入足够大的负数可以把资金增益归零乃至反转，但实际上最终值会被自动截断至 0，无法造成负向资金损失；若需精确归零，应改用 set_mio_funds_gain_factor。
在错误的 scope 下调用：此 effect 必须在 INDUSTRIAL_ORG scope 内执行，直接写在 country scope 的 effect 块中不会生效也不会报错，导致数值静默丢失，调试时极难察觉。

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

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

effect · add_mio_funds_gain_factor