Skip to main content

MxtProgression: Progression Levels

A spirit beast's level and a technique's use the same ledger, and the only difference is the owner - the owner id is the key of the level record: a technique writes its own id, a spirit beast writes the id of its own creature profile. The readers work on either side, while setLevel is a server operation.

MethodParametersReturn valueDescription
level(entity, owner)Entity, owner IDString or nullThe recorded level ID; null when it never advanced (it may still stand on the entry level, which is what current answers).
current(entity, owner)Entity, owner IDString or nullThe level in force: the record, or the owner's entry level. null when the entity does not hold that owner at all.
next(entity, owner)Entity, owner IDString or nullThe level after the current one; null at the highest level or when the entity does not hold that owner.
mastery(entity, owner)Entity, owner ID{have, required, resource} or nullHow far the next level still is: the current value of mastery_resource, the amount that level asks for and the resource id. null when there is no next level, the owner names no mastery_resource, or the formula cannot be evaluated.
setLevel(entity, owner, level)LivingEntity, owner ID, level ID{changed, failure}Goes through the same service as /contract level: it checks that the level is on its chain, writes the record, rebuilds what it grants and publishes one mxt:progression_level signal. It ignores that level's own mastery and condition.

The failure vocabulary: UNKNOWN_OWNER (the body does not hold that owner, or its definition has no chain), FOREIGN_LEVEL (that level is not on its chain), SAME_LEVEL (it already stands on that level), UNKNOWN_LEVEL (that id is not in the registry) and SERVER_ONLY (called on a client).

// kubejs/server_scripts/mxt_progression.js
// A spirit beast: the owner is the id of its own profile, and writing a level grants that level's abilities on the spot.
const current = MxtProgression.current(beast, 'mxt_test:probe_beast')
const growth = MxtProgression.mastery(beast, 'mxt_test:probe_beast')   // {have, required, resource}
const advanced = MxtProgression.setLevel(beast, 'mxt_test:probe_beast', 'mxt_test:beast_3')
if (!advanced.changed) {
  console.warn(`promotion refused: ${advanced.failure}`)
}
// A technique goes through the same entry point, with the technique id as the owner.
const sword = MxtProgression.level(player, 'mxt_test:sword_manual')