← all kitsfoundation kit

core

events, saves, menus

Foundation systems for any game and for every genre kit: event bus, state machines, content registry, flags, wallet, inventories, conditions/effects, quests, dialog trees, achievements, save/load, pause, timers/cooldowns, and touch-first menus. Data-driven: content lives in data/<kind>/*.json.

Setup

kits = ["core"]            # + "progression", "juice" as needed
local core = require("@kit/core")     -- submodules also work: require("@kit/core/inventory")
core.setup({
  currencies = { gold = { name = "Gold", icon = "asset:coin", start = 0, max = 99999 } },
  bag = { slots = 20, categorySlots = { key = 5 } },
  theme = { primary = "#4f8a5b", accent = "#ffd166", background = "#22333b", text = "#f7f3e9", font = "rounded" },
  save = { key = "mygame", version = 1, migrate = function(d, from) return d end },
  autoload = false, autosave = 10,              -- autoload: load the save now; autosave: seconds
})

Call core.setup once from a session script (unattached scripts/client/*.luau) or a shared module's init(); the kit is a module, so all state survives loadScene.

Full reference on GitHub