Wiki

effect · deactivate_shine_on_focus

Definition

  • Supported scope:COUNTRY
  • Supported target:any

Description

Deactivate the shine effect on the focus with the given id. The current focus cannot have it's shine effect removed.

Note that tooltips are only shown in debug mode.

### Example:

deactivate_shine_on_focus = GER_prioritize_economic_growth

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 a focus in a nation's focus tree is completed, developers typically use a shine effect to draw player attention. Once the player has completed the focus or the scenario no longer requires highlighting, the command should be called in the corresponding completion_reward or event option to remove the effect, preventing continuous screen flicker from disrupting the user experience. For example, disabling the highlight on another focus after a German focus completes:

completion_reward = {
    # Focus completed, deactivate highlight on guidance focus
    deactivate_shine_on_focus = GER_prioritize_economic_growth
    add_political_power = 50
}

Synergy

  • [activate_shine_on_focus](/wiki/effect/activate_shine_on_focus): These two commands form a complementary pair of inverse operations. Typically, activate_shine_on_focus is used first to enable highlighting at a specific moment, then this command is used to disable it once conditions are met, forming a complete guidance flow.
  • [complete_national_focus](/wiki/effect/complete_national_focus): When a script triggers focus completion, pairing this command ensures that the focus's shine effect is cleared at the same logical moment of completion, keeping the interface clean.
  • [has_completed_focus](/wiki/trigger/has_completed_focus): Used as a prerequisite condition check to determine whether the target focus has been completed before deciding whether to execute deactivate_shine_on_focus, preventing premature removal of highlighting while the focus is still in progress.

Common Pitfalls

  1. Using on the currently active focus: The official documentation explicitly states that the shine effect cannot be removed from a focus that is currently being researched. Calling this command on the focus corresponding to current_focus will fail silently without error, leading newcomers to mistakenly believe other logic is broken.
  2. Forgetting to verify outside debug mode: The command's tooltip only displays in debug mode. When testing directly in regular gameplay, no visual feedback appears, making it easy to misjudge whether the command executed. Develop the habit of launching the game with -debug to test scripts properly.