trigger · compare_autonomy_progress_ratio

Hands-On Usage

compare_autonomy_progress_ratio is commonly found in the available / trigger blocks of autonomy-related events or decisions, used to determine whether the overlord's transfer or recovery of autonomy progress to a subject reaches a certain threshold ratio, thereby triggering script logic for automatic autonomy tier upgrades/downgrades. For example, in a colonial independence movement mod, you can check from the overlord's perspective whether autonomy progress exceeds 50%, then decide whether to unlock certain diplomatic options:

# Check from overlord scope whether autonomy progress ratio exceeds 50%
available = {
    compare_autonomy_progress_ratio > 0.5
}

Synergy

• [has_autonomy_state](/wiki/trigger/has_autonomy_state) — First use this trigger to confirm the current autonomy tier (e.g., autonomy_dominion), then use compare_autonomy_progress_ratio to precisely evaluate progress, avoiding false positives on non-autonomy relationships.
• [compare_autonomy_state](/wiki/trigger/compare_autonomy_state) — Combining both allows simultaneous constraints on autonomy tier range and progress ratio, ideal for multi-stage autonomy evolution condition chains.
• [add_autonomy_score](/wiki/effect/add_autonomy_score) — Once conditions are met, pair with this effect to directly modify autonomy score, implementing a complete logic loop for "progress reaches threshold then advance autonomy tier".
• [add_autonomy_ratio](/wiki/effect/add_autonomy_ratio) — Same as above; when needing to adjust autonomy progress by ratio rather than fixed value, combine with this trigger to maintain logical consistency.

Common Pitfalls

1. Incorrect or missing comparison operator — This trigger syntax requires the comparison operator and value directly after the command name (compare_autonomy_progress_ratio > 0.5); beginners often mistakenly write it as the curly brace block form = { value > 0.5 }, causing parse errors or conditions that never fire.
2. Usage under non-autonomy country scopes — This trigger only has meaning for countries with autonomy relationships; if used on ordinary independent nations without an overlord, the return behavior of the progress ratio is undefined. It's recommended to first use [has_autonomy_state](/wiki/trigger/has_autonomy_state) as a precondition check, confirming an autonomy relationship exists before evaluating this condition.