Divest Talent

Description

Removes one or more ranks from a talent on the target player, refunding the invested points. Works both targeted (with a targeter) and no-target (on the caster).

Unless force is set, the talent's tree must have TalentsForgettable enabled, otherwise the mechanic returns CONDITION_FAILED. Ranks are removed one at a time and it stops early when no further rank can be removed. Returns SUCCESS if at least one rank was removed.

Attributes

Attribute Aliases Description Default
talenttree tree, archetype The id of the talent tree (the archetype id for inline trees) required
talent t The id of the talent within the tree required
amount a The number of ranks to remove 1
force f Refund a rank even if the tree is not forgettable, bypassing prerequisite checks false

Examples

Refund one rank on the target:

ForgetHeavyArmor:
  Skills:
  - divestTalent{tree=WARRIOR;talent=HeavyArmor} @target

Force-remove all ranks from a non-forgettable tree:

WipeCleave:
  Skills:
  - divestTalent{tree=WARRIOR;talent=Cleave;amount=99;force=true} @self

Aliases

  • talentDivest
  • downgradeTalent
  • forgetTalent
Updated Aug 19, 2026