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
• Progression Tree Viewport — Optional pan/zoom controller for the runtime UI
• 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
GetBlockReason(tree, skill) → string
CanAffordTreeUnlock(tree) → bool
CanAffordTreeRespec(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
GetBlockReason(skill) → string
FocusOnSkill(skill) → void

Specialized controller for roguelike-style Latest mode with N detail panels side-by-side. Handles weighted random skill selection and pool refresh mechanics.

Properties

Methods

RefreshPool(count) → void
GetCurrentPool() → List<ProgressionSkill>
SelectSkillFromPool(index) → void

Individual skill panel used in Latest mode. Displays skill details and handles unlock interaction.

Properties

Methods

SetSkill(skill) → void
UpdateState() → void
OnUnlockClicked() → void

Optional pan & zoom controller for the runtime tree UI. Add it to the Scroll View's Viewport GameObject to get clamped mouse-wheel zoom and a pinch-friendly API for touch. Without this component the UI behaves exactly as before.

Properties

Methods

Pinch(delta) → void
FocusOn(node) → void
ResetView() → void

Layout Modes

Skill Types

Stat Modifiers

Shared Point Pools (Point Pool ID)

Every ProgressionTree has an optional Point Pool ID field (empty by default). Set the same non-empty ID on two or more trees to have them share one available/earned skill point bank via ProgressionTreeManager instead of each tree keeping its own — for example a "Class Points" pool spent across three specialization trees.

• Empty (default) = the tree's own ID is used as the key, i.e. every tree keeps its own pool — unchanged behaviour.
• Same non-empty ID on several trees = awarding, spending, unlocking and upgrading skills all read/write the same bank.
• Only the point bank is shared. Each tree's own unlock state, Max Skill Points limit and skill ranks stay per tree.
• Locking a tree resets its pool to 0, unless another tree that is still unlocked shares the same pool — in that case the shared bank is left untouched for that other tree.

Game Creator 2 Integration

Everything below appears in the normal Game Creator pickers under the Progression Tree category: 12 Instructions, 8 Conditions and 1 Property.

Instructions (12)

Conditions (8)

Property (1)

Code Examples

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

// Unlock a skill
bool success = manager.UnlockSkill(myTree, mySkill);
if (success)
{
    Debug.Log("Skill unlocked!");
}

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

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

// 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}");
});

UI Widgets (Optional)

Optional UI components that enhance user experience by providing real-time progression feedback. All widgets use interface-based architecture for easy customization.

public interface IProgressionNotificationSystem : IProgressionUIWidget
{
    void ShowNotification(NotificationType type, string title, string message, Sprite icon = null);
    void SetQueueSize(int size);
    void ClearAll();
}

public interface IProgressionPointsDisplay : IProgressionUIWidget
{
    void UpdatePoints(ProgressionTree tree, int availablePoints);
    void SetTrackedTree(ProgressionTree tree);
    void SetClickable(bool clickable);
}

public interface ISkillUnlockAnimation : IProgressionUIWidget
{
    void PlayUnlockAnimation(ProgressionSkill skill, int rank);
    void SetAutoDismiss(bool auto, float duration = 3f);
    bool IsPlaying();
}

public interface IProgressionUIWidget
{
    // Called when widget should initialize
    void Initialize(ProgressionTreeManager manager);
    
    // Called when widget should clean up
    void Cleanup();
    
    // Check if widget is active
    bool IsActive { get; }
    
    // Enable/disable widget
    void SetActive(bool active);
}