← all kitsgenre kit

platformer

levels, power-ups, bosses

Side-scrolling platformers (Mario/Celeste-style) built from ASCII tile levels + JSON content. The kit owns the controller (accel/decel, variable jump, coyote time, jump buffer, wall slide/jump, dash, double jump, ladders), level features (one-way/moving/falling platforms, springs, hazards, breakables, secret walls), enemies and bosses from data, stomp + projectile combat, checkpoints/respawn, collectibles, goal, camera (look-ahead, room locks), parallax, HUD, a world map with unlock rules, and save. A level scene needs ~3 lines of Luau.

Collision is the kit's own deterministic box-vs-tile code (not physics): player/enemies are Node2D/Sprite2D, never Body2D; tile behaviour comes from tileset tags (read via map:tileDef).

Built on core (content registry, save section "platformer") and juice (shake, particles, sfx); both are enabled automatically. Progress lives in the core save: core.save.load()/save() include it, and the kit emits level_completed {level, time, coins, first, newBest} / ability_unlocked {ability} on core.events for quests/achievements.

Setup

kits = ["platformer"]          # core + juice come with it
orientation = "landscape"

Content is read from the package (data/enemies/*.json, data/bosses/*.json, data/world.json) on first use; no setup call is needed.

-- scripts/shared/game.luau (module, shared by every scene)
local kit = require("@kit/platformer")
return kit

-- scripts/client/level.luau (attached to each level's TileMap2D)
local kit = require("../shared/game")
music.play("level")
local level = kit.level.start({ map = script.entity, art = ART, sounds = SOUNDS, anims = { idle = "idle", run = "run", jump = "jump", fall = "fall" } })
level.events:on("gem", function(i) print("gem", i) end)

-- scripts/client/map.luau (attached to the world map scene root)
kit.worldmap.start({ art = { node = "asset:node", node_done = "asset:node_done", node_locked = "asset:node_locked", cursor = "asset:hero" } })

Example game

Mossling running on the Dreamsy engine

Mossling

A tiny moss sprite hops through Greenhollow: five levels, hidden gems and a toad boss.

platformerside

Full reference on GitHub