← all kitsgenre kit

shooter

waves, bullet patterns, shops

Vertical shmups, bullet-hell bosses and twin-stick arenas, portrait-first. Content is data (data/shooter.json, data/{ships,weapons,emitters,enemies,stages}/*.json); the kit runs a stage in the current scene: ship + virtual stick + auto-fire, weapons/upgrades, scripted enemy waves, data-driven bullet emitters, ai-driven bosses with hp phases, pickups, score/chain/multiplier/graze, lives/bombs/continues, stage results, a between-stage shop, ship unlocks and saving. Thin layer: HP/i-frames/collisions/projectiles = combat, boss phases + arena AI = ai, arena waves + seeded rng = procgen, feel = juice, wallet/save/menus = core. Example: games/examples/kit-shooter (Starling Drift).

Setup

kits = ["shooter"]          # pulls core, progression, juice, combat, ai, procgen
orientation = "portrait"
-- scripts/shared/game.luau (session state; modules survive loadScene)
local S = require("@kit/shooter")
local C = S.setup({ core = { save = { key = "mygame", version = 1 }, theme = { primary = "#5b4bd6", accent = "#ffd34d", font = "bold" } } })
G.run = S.newRun({ ship = "starling" })                         -- lives, bombs, weapon, score, credits for one playthrough
loadScene("scenes/play.scene.json", { stage = G.run:nextStage() })
-- scripts/client/play.luau (attached to the play scene root)
S.play(G.run, sceneParams().stage, {
  onClear = function(res) S.ui.results(res, function() S.ui.shop(G.run, function() loadScene("scenes/play.scene.json", { stage = G.run:nextStage() }) end) end) end,
  onGameOver = function(res) S.ui.results(res, function() loadScene("scenes/title.scene.json") end, { nextLabel = "Title" }) end })

S.setup loads content once (cached), calls core.setup (currency = config.currency, default "credits"), registers the save section "shooter" and loads the save. One play scene is enough: S.play builds background, ship, HUD, everything.

Example game

Starling Drift running on the Dreamsy engine

Starling Drift

A pocket shmup through a neon nebula, with bullet-hell bosses and a hangar shop.

shootertop-down

Full reference on GitHub