LevelProgression

Manages experience curves, multi-level increments, and stat scaling per level.

Constructor

new LevelProgression(configopt)

Parameters:
NameTypeAttributesDescription
configObject<optional>
Properties
NameTypeAttributesDefaultDescription
levelnumber<optional>
1
experiencenumber<optional>
0
baseExperiencenumber<optional>
100
growthRatenumber<optional>
1.5
maxLevelnumber<optional>
100
statGainsObject<optional>

Stat increases per level

baseStatsObject<optional>

Initial stats at level 1

Classes

LevelProgression

Methods

(static) fromJSON(data) → {LevelProgression}

Restore from serialized state.

Parameters:
NameTypeDescription
dataObject
Returns:
Type: 
LevelProgression

applyToTarget(target)

Apply calculated stats to a Combatant or Stats component.

Parameters:
NameTypeDescription
targetObject

experienceToNextLevel(levelopt) → {number}

Calculate experience needed to advance from given level to next.

Parameters:
NameTypeAttributesDefaultDescription
levelnumber<optional>
this.level
Returns:
Type: 
number

getCalculatedStats() → {Object}

Get computed total stats for the current level.

Returns:
Type: 
Object

grantExperience(amount) → {Array}

Grant experience, potentially climbing multiple levels in one call.

Parameters:
NameTypeDescription
amountnumber
Returns:

Array of level numbers reached

Type: 
Array

onProgression(listener) → {function}

Add a listener for progression events (level-up, exp-gained).

Parameters:
NameTypeDescription
listenerfunction
Returns:

Unsubscribe function

Type: 
function

toJSON() → {Object}

Create snapshot for serialization.

Returns:
Type: 
Object