Progression Instances
Progression instances are individual progression tracks that can be assigned to characters. Each instance references a leveling entry for its XP curve and defines rewards that trigger at specific levels.
Creating a Progression Instance Entry
Open the Spark Editor, go to Progression > Progression Instances and click Create New.
Each progression instance defines:
Display Name
Name for this progression track (e.g., "Character Level", "Crafting Skill", "Fishing").
Leveling Template
Reference to a Leveling entry that defines the XP curve for this progression.
Allow Runtime Assignment
Whether this progression can be assigned to characters during gameplay (default: true).
Default Unlocked
If enabled, this progression is automatically unlocked for all characters on initialization (default: false).
Level Up Rewards
List of rewards that trigger at specific levels (see below).
Level Up Rewards
Each level up reward fires triggers when the character reaches certain levels. Add as many rewards as needed.
Reward Type
When this reward triggers. See reward types below.
Description
Player-readable description of the reward.
Triggers
List of trigger entries to execute when the reward conditions are met.
Reward Types
Any Level
Triggers on every level up.
None.
Specific Level
Triggers when the character reaches a specific level.
Required Level — the target level.
Every X Levels
Triggers every N levels (e.g., every 5 levels).
Level Interval — how often (default: 5). Skip Level One — exclude level 1 from the interval. Starting Level — the base for interval calculation.
Max Level
Triggers when the character reaches the level cap.
None.
Example: To grant a talent point every 5 levels starting from level 5, set Reward Type to "Every X Levels", Level Interval to 5, and Skip Level One to true.
Setting Up a Progression Entity
To give a character progression tracking, add a ProgressionEntity component in the Inspector.
Is Persistent
Save and load progression data across sessions (default: false).
Auto Save On Change
Automatically save when XP or level changes (default: true). Requires Is Persistent.
Load On Start
Load saved progression data on Start (default: true). Requires Is Persistent.
Spark Entity
Reference to the SparkEntity. Required for persistence.
Progressions marked as Default Unlocked are automatically created when the entity initializes. Other progressions must be unlocked through triggers or gameplay logic.
Progression-Related Triggers
Gain Experience
Grants XP to a specific progression instance. Configure the progression instance entry, XP amount, and optional delay.
Progression-Related Requirements
Progression Level
Checks if a progression instance has reached a specific level. Configure the target progression, comparison type (equal, greater than, less than, etc.), and target level.
Last updated
Was this helpful?
