← all kitsfoundation kit

progression

quests, skills, achievements

Numbers that make a game last: XP/level curves, stat scaling + modifiers, skill/unlock trees, prestige layers, daily streak rewards, milestones, difficulty curves, and headless balance simulations. Standalone; with the core kit enabled it binds automatically (condition/effect kinds, events, save section "progression").

Setup

kits = ["core", "progression"]   # kit.json: no deps (binds to core when enabled)
local prog = require("@kit/progression")
local level = prog.leveler({ name = "player", curve = { kind = "quadratic", base = 15, linear = 25, maxLevel = 30 } })
local skills = prog.tree({ points = 1 })              -- defs from data/skills/*.json (core content kind "skills")
level:onLevelUp(function(L, gained) skills:addPoints(gained) end)

Named objects (leveler, tree, layer, streak, milestoneSet — or prog.register(name, obj)) are saved in the core save under "progression" and reachable from content via track/tree/layer/set. Create them in the same place you call core.setup (session script / shared module), before core.save.load().

Full reference on GitHub