Invest Talent

Description

Invests one or more ranks into a talent on the target player. Works both targeted (with a targeter) and no-target (on the caster).

Ranks are applied one at a time and the mechanic stops early when a rank cannot be invested (not enough points, unmet prerequisites, or the talent is already at MaxPoints). Returns SUCCESS if at least one rank was applied, otherwise CONDITION_FAILED.

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 invest 1
force f Bypass point-availability and prerequisite checks (still capped at MaxPoints) false

Examples

Give the target one rank of a talent:

GrantHeavyArmor:
  Skills:
  - investTalent{tree=WARRIOR;talent=HeavyArmor} @target

Force three ranks on the caster, ignoring costs and prerequisites:

AutoSpec:
  Skills:
  - investTalent{tree=WARRIOR;talent=Cleave;amount=3;force=true} @self

Aliases

  • talentInvest
  • upgradeTalent
Updated Aug 19, 2026