Grant Skill Tree (Entity Action Type)

Grants a skill tree to the player this action runs on. The grant is stored on the player (it survives relogs), the tree’s tab appears in the skill screen, and its default_powers are applied immediately. Granting is what makes a tree with auto_grant: false reachable — from an origin, a power, an item action, or anything else that can run an entity action.

Type ID: apoli:grant_skill_tree

Granting a tree the player already has (or that has auto_grant: true) does nothing. Skills the player had purchased before a apoli:revoke_skill_tree come back when the tree is granted again.

Pufferfish’s Skills categories#

If skill_tree names an id that is not a loaded Apoli skill tree and Pufferfish’s Skills is installed, the id is looked up as a Skills category instead and that category is unlocked for the player. This is the same fall-through the apoli:modify_player_model power uses for Figura avatars: Apoli’s own registry wins, the other mod only gets ids Apoli does not know.

apoli:revoke_skill_tree locks the category again.

Fields#

Field	Type	Default	Description
skill_tree	Identifier	required	The id of the skill tree to grant.

Example#

The following action unlocks the Phantom skill tree example:phantom.

{
    "type": "apoli:grant_skill_tree",
    "skill_tree": "example:phantom"
}