Wiki

effect · add_research_slot

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Adds a research slot (negative values subtracts)

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

add_research_slot is commonly used to grant players/AI additional research slots as rewards from focus trees, event options, or achievement triggers. It is a core mechanic for enhancing a nation's technological development capacity. For example, awarding an extra research slot upon completion of a focus tree centered on industrialization:

focus = {
    id = industrial_expansion
    ...
    completion_reward = {
        add_research_slot = 1
    }
}

Synergy

  • [amount_research_slots](/wiki/trigger/amount_research_slots) — Check the current number of research slots in trigger conditions to prevent stacking too many slots and breaking game balance. For instance, restrict the reward to trigger only when slot count falls below a certain threshold.
  • [add_tech_bonus](/wiki/effect/add_tech_bonus) — Pair this with research speed bonuses so newly acquired slots can be utilized immediately and efficiently. This combination is common in "tech superpower" style focus rewards.
  • [add_ideas](/wiki/effect/add_ideas) — Award alongside an advisor or national spirit containing research bonuses to ensure slot benefits and research efficiency improvements scale together, enhancing the overall reward package.
  • [add_political_power](/wiki/effect/add_political_power) — Research slots are typically high-value rewards, so distributing them together with political power helps balance the attractiveness of focus tree paths.

Common Pitfalls

  1. Forgetting that negative values reduce slots: Passing a negative number will subtract research slots. If mistakenly written as negative in punishment events or puppet conditions, the target nation loses slots directly, making it hard to catch during testing. Always verify the sign direction.
  2. Failing to cap maximum slot limits: The game itself has no hard UI cap on research slot quantity. If this effect is placed in mod events or decisions that trigger repeatedly without [amount_research_slots](/wiki/trigger/amount_research_slots) as a gating condition, slots can stack infinitely and severely break game balance.