ProgressionSystem: add base functions and global progression

This commit is contained in:
Van
2026-07-01 21:12:14 +03:00
parent c0fe6c683e
commit 6c10201fa9
5 changed files with 159 additions and 0 deletions

View File

@@ -0,0 +1,89 @@
local assert = assert
local require = Mod.getInfo('smc__core__progression_system').require
---@type ProgressionSystem.Age
local Age = require('ProgressionSystem.Age')
---@type ProgressionSystem.Milestone
local Milestone = require('ProgressionSystem.Milestone')
---The zeroth century, from which progression begins.
---
---It is not registered through the usual mechanism,
---but is integrated directly into the progression system.
local zeroAge = Age:new('zero', {})
zeroAge.id = 0
---@class ProgressionSystem
---@field agesByName table<ProgressionSystem.Age.Name, ProgressionSystem.Age>
---@field agesByID table<integer, ProgressionSystem.Age>
---
---The age ID currently reached by players in global progression.
---@field serverAge integer
local ProgressionSystem = {
agesByName = { ['zero'] = zeroAge, },
agesByID = { [0] = zeroAge },
serverAge = 0,
}
---@param ageName ProgressionSystem.Age.Name
---@param def ProgressionSystem.AgeDef
function ProgressionSystem:registerAge(ageName, def)
assert(self.agesByName[ageName] == nil)
local age = Age:new(ageName, def)
self.agesByName[ageName] = age
age.id = #self.agesByID + 1
self.agesByID[age.id] = age
end
---@param ageName ProgressionSystem.Age.Name
---@return ProgressionSystem.Age
function ProgressionSystem:getAgeByName(ageName)
assert(self.agesByName[ageName] ~= nil)
return self.agesByName[ageName]
end
---@param id integer
---@return ProgressionSystem.Age
function ProgressionSystem:getAgeByID(id)
assert(self.agesByName[id] ~= nil)
return self.agesByName[id]
end
---@param ageName ProgressionSystem.Age.Name
---@param milestoneName string
---@param def ProgressionSystem.MilestoneDef
function ProgressionSystem:registerMilestone(ageName, milestoneName, def)
local age = self:getAgeByName(ageName)
local milestone = Milestone:new(milestoneName, def)
age:addMilestone(milestoneName, milestone)
end
---@param ageName ProgressionSystem.Age.Name
---@param milestoneName string
---@return ProgressionSystem.Milestone
function ProgressionSystem:getMilestoneByName(ageName, milestoneName)
local age = self:getAgeByName(ageName)
return age:getMilestoneByName(milestoneName)
end
---@param ageID integer
function ProgressionSystem:setServerAge(ageID)
assert(ageID <= #self.agesByID)
self.serverAge = ageID
end
---@return integer
function ProgressionSystem:getServerAge()
return self.serverAge
end
return ProgressionSystem

View File

@@ -0,0 +1,48 @@
local assert = assert
local tableInsert = table.insert
---@alias ProgressionSystem.Age.Name
---| 'zero'
---| ''
---@class ProgressionSystem.Age : Class
---@field name ProgressionSystem.Age.Name
---@field id integer
---
---@field milestonesByName ProgressionSystem.Milestone[]
---@field milestonesList ProgressionSystem.Milestone[]
local Age = Class:extend({
milestonesByName = {},
milestonesList = {},
})
---@class ProgressionSystem.AgeDef
---@param name ProgressionSystem.Age.Name
---@param def ProgressionSystem.AgeDef
function Age:new(name, def)
local instance = self:getInstance({})
instance.name = name
return instance
end
---@param milestoneName string
---@param milestone ProgressionSystem.Milestone
function Age:addMilestone(milestoneName, milestone)
assert(self.milestonesByName[milestoneName] == nil)
self.milestonesByName[milestoneName] = milestone
tableInsert(self.milestonesList, milestone)
end
---@param milestoneName string
---@return ProgressionSystem.Milestone
function Age:getMilestoneByName(milestoneName)
assert(self.milestonesByName[milestoneName] ~= nil)
return self.milestonesByName[milestoneName]
end
return Age

View File

@@ -0,0 +1,16 @@
---@class ProgressionSystem.Milestone : Class
---@field name string
local Milestone = Class:extend()
---@class ProgressionSystem.MilestoneDef
---@param name string
---@param def ProgressionSystem.MilestoneDef
function Milestone:new(name, def)
local instance = self:getInstance({})
instance.name = name
return instance
end
return Milestone