Wiki

effect · add_to_tech_sharing_group

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Adds country to technology sharing group of specified name.
Example: add_to_tech_sharing_group = commonwealth_research

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_to_tech_sharing_group is commonly used in mods to establish custom tech-sharing alliances—for example, allowing players to join a regional research circle upon completing a focus, or automatically sharing tech when forming a faction. Typical scenarios include Commonwealth members sharing research, or Axis-aligned nations joining exclusive research groups.

# Upon focus completion, add this nation to the "pacific_co_prosperity" tech sharing group
focus = {
    id = JOIN_COPROSPERITY_RESEARCH
    ...
    completion_reward = {
        add_to_tech_sharing_group = pacific_co_prosperity
        add_research_slot = 1
    }
}

Synergy

  • [add_to_faction](/wiki/effect/add_to_faction) — Typically triggered simultaneously with faction membership, allowing new members to both join the military alliance and enter the tech-sharing circle in a logically consistent manner.
  • [add_research_slot](/wiki/effect/add_research_slot) — Joining a tech-sharing group often comes with research slot bonuses, reinforcing the design intention that "alliance membership yields research benefits."
  • [add_ideas](/wiki/effect/add_ideas) — Can be paired with adding a national spirit representing a "joint research agreement," so players see persistent effect notifications in the UI when joining the sharing group.
  • [has_completed_focus](/wiki/trigger/has_completed_focus) — Serves as a prerequisite condition to ensure only nations that have completed a specific focus trigger this effect, preventing premature entry.

Common Pitfalls

  1. Group name mismatch breaks sharing: The string passed to add_to_tech_sharing_group must match exactly (case-sensitive) with the group name used by other nations. A single underscore or letter difference will place two nations in separate groups, rendering sharing completely ineffective with no error message—making it extremely difficult to debug.
  2. Mistaking it for a reversible operation: This effect only adds nations to groups; there is no corresponding remove_from_tech_sharing_group command. If you need to implement "leaving a sharing group" logic, you must work around it through other mechanisms (such as removing the idea that triggers the sharing). Attempting a direct reverse operation will have no effect.