← all kitsgenre kit

story

branching scenes, clues

Visual novels, point-and-click adventures and mysteries. Scripts are plain text an LLM can read and write (data/story/*.story.txt), parsed by the kit into a headless VM; a portrait reading UI renders it. Flags, items, quests, saves and menus come from core (story variables ARE core flags; inventory IS core.bag), feel from juice. Example: games/examples/kit-story (2 chapters, 3 characters, boathouse room, deduction board, 2 endings).

Setup

kits = ["story"]              # core + juice enabled automatically
-- scripts/shared/game.luau (call init() once; guard it — scenes may reload)
local Core = require("@kit/core")
local Story = require("@kit/story")
Core.setup({ theme = { primary = "#2f7f86", accent = "#ffd36b", background = "#1c1a2b", text = "#f5efe2", font = "rounded" },
             save = { key = "mygame", version = 1 } })     -- items from data/items/*.json
Story.setup()                                               -- reads data/story/** via data.list/data.read
-- scripts/client/main.luau (attached to the scene root)
local UI = require("@kit/story/ui")
UI.title(Story, { title = "Lanternlight", subtitle = "…", background = "harbor", music = "tide",
                  onStart = function(slot) Story.play({ resume = slot }) end })   -- slot nil = new game, "auto" = continue

Example game

Lanternlight running on the Dreamsy engine

Lanternlight

The lighthouse went dark the night you arrived. Read the clues, decide who you trust.

storyflat

Full reference on GitHub