Progression Tree Builder

Overview

The Progression Tree Builder system consists of the following main components:

• Progression Tree — Scriptable Object containing all skills
• Progression Skill — Scriptable Object defining individual skills
• Tree Manager — MonoBehaviour managing runtime state
• Skill Instruction Manager — MonoBehaviour coordinating scene-based instructions
• Skill Instructions — MonoBehaviour for per-skill scene-specific behavior
• UI Controller — MonoBehaviour coordinating the display
• Skill Node Renderer — Sub-controller for node creation and positioning
• Connection Renderer — Sub-controller for visual connection lines
• Tree Navigation Controller — Sub-controller for multi-tree navigation
• Latest Mode Layout Controller — Specialized controller for roguelike progression
• Latest Mode Detail Panel — Individual skill panel in Latest mode
• IProgressionTreeReference — Interface for flexible tree references
• ProgressionTreeReference — Wrapper class for tree asset references

The main object that defines a complete skill tree.

Properties

Defines a single skill or ability.

Properties

Manages the runtime state of all Progression Trees.

Properties

Methods

UnlockSkill(tree, skill) → bool
UpgradeSkill(tree, skill) → bool
GetSkillRank(tree, skill) → int
IsSkillUnlocked(tree, skill) → bool
GetAvailablePoints(tree) → int
RefreshLatestPool(tree, count) → void
GetCurrentLatestPool(tree) → List<ProgressionSkill>
RespecTree(tree) → bool

Central manager for all scene-based skill instructions. Automatically finds and executes SkillInstructions components when skills are triggered. Add this component to your ProgressionTreeManager GameObject.

Properties

Methods

FindAllSkillInstructions() → void
GetSkillInstructions(skillId) → SkillInstructions
HasInstructions(skillId) → bool
ExecuteOnUnlocked(skillId, args) → void
ExecuteOnActivated(skillId, args) → void
ExecuteOnUpgrade(skillId, args) → void
RegisterSkill(skill) → void

Scene-based instruction component that executes Game Creator Instructions for a specific skill. Supports GameObject drag & drop references and scene-specific behavior. Each skill can have multiple SkillInstructions components across different scenes.

Properties

Methods

GetSkillID() → string
GetSkillName() → string
GetSkill() → ProgressionSkill
ExecuteOnUnlocked(args) → Task
ExecuteOnActivated(args) → Task
ExecuteOnUpgrade(args) → Task
HasAnyInstructions() → bool
HasSkillAssigned() → bool

Controls the entire UI display and user interaction.

Properties

Methods

OpenTree(tree) → void
CloseTree() → void
SwitchToTree(tree) → void
SelectSkill(skill) → void
RefreshUI() → void

Specialized controller for roguelike-style Latest mode with N detail panels side-by-side.

Properties

Methods

Initialize() → void
DisplayLatestPool(tree, skills) → void
RefreshDisplay() → void
AreAllNodesMaxed() → bool
ClearPanels() → void

Wrapper component for individual skill detail panels in Latest mode. Each panel shows full skill information and has its own unlock/upgrade button.

Properties

Methods

Initialize(tree, skill) → void
RefreshDisplay() → void

Layout Modes

Skill Types

Stat Modifier Types

Code Examples

Unlock Skill Programmatically

// Get reference to Manager
var manager = ProgressionTreeManager.Instance;

// Unlock skill
bool success = manager.UnlockSkill(myTree, mySkill);

if (success)
{
    Debug.Log("Skill unlocked!");
}

Refresh Latest Pool

// Refresh pool with 3 new skills
manager.RefreshLatestPool(myTree, 3);

// Get current pool
var currentPool = manager.GetCurrentLatestPool(myTree);
Debug.Log($"Pool size: {currentPool.Count}");

Listen to Skill Events

// Subscribe to unlock events
manager.OnSkillUnlocked.AddListener((tree, skill) =>
{
    Debug.Log($"Unlocked: {skill.skillName}");
});

// Subscribe to upgrade events
manager.OnSkillUpgraded.AddListener((tree, skill, newRank) =>
{
    Debug.Log($"{skill.skillName} now rank {newRank}");
});