effect · `add_mastery_bonus`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Get a bonus to doctrine mastery gain for a certain duration.

	You can use flexible filters to have this effect apply to all tracks that match the specified
	folder, grand doctrine, subdoctrine or specific track. If a certain filter is not present, it will be counted as a pass.
	For example, you can add mastery to all active tracks in all folders by not specifying any filters at all.

	### Examples
	```
	GER = {
		add_mastery_bonus = {
			bonus = 0.1							# Bonus factor, e.g. 0.1 = +10%
			days = 90							# Number of days to apply the daily mastery gain for
			name = [loc]                        # Loc key - will be used in descriptions to show the source of the mastery gain

			# FILTERS:
			folder = land						# Optional - will filter by tracks in the specified folder
			grand_doctrine = mobile_warfare		# Optional - will filter by tracks in folders with the specified grand doctrine
			sub_doctrine = mobile_infantry		# Optional - will filter by tracks with the specified subdoctrine
			track = infantry					# Optional - will filter by tracks of the specified type
			index = 1							# Optional - will filter by the track index within the folder (0-indexed).
		}
	}
	```

实战 · 配合 · 坑

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

实战用法

add_mastery_bonus 适合在国策、决策或事件中为玩家提供阶段性的学说精通加速 buff，例如完成某条研究国策后让特定兵种的精通获取速度提升一段时间。借助精细的过滤器，可以只针对某一文件夹、大学说或子学说下的赛道施加加成，避免影响到无关的学说路线。

focus = {
    id = GER_blitzkrieg_doctrine
    # ...
    completion_reward = {
        GER = {
            add_mastery_bonus = {
                bonus = 0.15
                days = 180
                name = GER_blitzkrieg_focus_bonus
                folder = land
                grand_doctrine = mobile_warfare
            }
        }
    }
}

配合关系

[add_daily_mastery](/wiki/effect/add_daily_mastery)：直接增加每日精通值的永久性调整，与 add_mastery_bonus 的限时 buff 形成"短期冲刺"与"长期增益"的互补搭配。
[add_mastery](/wiki/effect/add_mastery)：直接一次性增加精通量，可与 add_mastery_bonus 组合使用，实现"即时跳一段 + 接下来一段时间加速"的双重奖励。
[has_completed_track](/wiki/trigger/has_completed_track)：用于判断某条精通赛道是否已完成，配合 add_mastery_bonus 可设计"完成前置赛道才触发加速"的条件逻辑。
[has_any_grand_doctrine](/wiki/trigger/has_any_grand_doctrine)：判断国家是否持有特定大学说，保证只在持有对应学说时才施加加成，防止效果错位。

常见坑

过滤器全缺时影响范围过广：若不指定任何过滤字段（folder、grand_doctrine、sub_doctrine、track、index），该加成会作用于所有活跃赛道，在玩家同时走多条学说路线时可能造成意外的强力加速，需要根据设计意图至少添加一个过滤条件加以约束。
days 与实际游戏时间的直觉误差：days 是游戏内天数而非现实时间，新手常低估一场战役的时长，导致 buff 在关键阶段已提前过期；建议结合实际战役节奏估算天数，或用事件/决策链来手动移除/刷新该加成。

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_mastery_bonus is ideal for providing players with phased doctrine mastery acceleration buffs through focuses, decisions, or events—for example, granting a specific unit type faster mastery progression for a period after completing a research focus. With fine-grained filters, you can apply bonuses to only specific folders, grand doctrines, or sub-doctrine tracks, avoiding unintended impact on unrelated doctrine paths.

focus = {
    id = GER_blitzkrieg_doctrine
    # ...
    completion_reward = {
        GER = {
            add_mastery_bonus = {
                bonus = 0.15
                days = 180
                name = GER_blitzkrieg_focus_bonus
                folder = land
                grand_doctrine = mobile_warfare
            }
        }
    }
}

Synergy

[add_daily_mastery](/wiki/effect/add_daily_mastery): A permanent adjustment that directly increases daily mastery gain, complementing add_mastery_bonus's time-limited buff with a "short-term sprint" paired with "long-term growth" dynamic.
[add_mastery](/wiki/effect/add_mastery): Grants an immediate one-time mastery boost; can be combined with add_mastery_bonus to deliver a dual reward of "instant jump forward + accelerated progression over the following period."
[has_completed_track](/wiki/trigger/has_completed_track): Checks whether a specific mastery track is complete; pairs with add_mastery_bonus to design conditional logic such as "trigger acceleration only after completing prerequisite tracks."
[has_any_grand_doctrine](/wiki/trigger/has_any_grand_doctrine): Verifies whether a nation holds a specific grand doctrine, ensuring the bonus only applies when the corresponding doctrine is active and preventing misaligned effects.

Common Pitfalls

Overly broad effect scope when all filters are omitted: If no filter fields (folder, grand_doctrine, sub_doctrine, track, index) are specified, the bonus applies to all active tracks, potentially causing unexpectedly powerful acceleration when players pursue multiple doctrine lines simultaneously. It is strongly recommended to apply at least one filter constraint aligned with your design intent.
Intuitive gap between days and actual gameplay time: days represents in-game days, not real-world time; newcomers often underestimate campaign duration, causing the buff to expire prematurely at critical moments. Calculate the day value based on actual campaign pacing, or use event/decision chains to manually remove or refresh the bonus as needed.

effect · add_mastery_bonus