Pixel Ledges: 2D Platformer Kit with Sprites, Tilemaps, Wall Jumps and Dash
README.md
pickups
Paints every gem look and checkpoint look of the twoDKit as pixel-art sprite sheets and saves them to art/fx/ as nearest-filtered textures with sprite-shader materials. Level2D draws its o gems from gems (setting gemLook) and its C checkpoints from checkpoints (setting checkpointStyle). Run it again whenever the art code or the look lists change.
local Pickups = require("twoDKit.artgen.pickups")
Pickups.generate() -- saves art/fx/gems and art/fx/checkpoints (+ materials)
local gems = Pickups.gemSheet() -- canvases only, for previews
local cps = Pickups.checkpointSheet()
The row layout is data in twoDKit.catalog: Catalog.gemLooks[id] and Catalog.checkpointLooks[id] give each look's row (its idle loop), and row + 1 holds its collect burst (gems) or its reached loop (checkpoints). The lists Catalog.gemLookList and Catalog.checkpointLookList give the order, and gemLookLabels / checkpointLookLabels the names to show.
gems: 128x192, 16x16 frames, 8 columns
Identity: twoDKit.art.fx.gems.
| Look | Rows | Idle | Burst (6 frames) |
|---|---|---|---|
crystal | 0, 1 | 6 frames, the faceted cyan and violet gem of art/fx/fx (copied, so the default is unchanged) | crystal shards |
coin | 2, 3 | 8 frames, a gold coin spinning through edge-on | gold glints |
star | 4, 5 | 8 frames, a pink star with eyes that wobbles and twinkles | pink sparkles |
cherry | 6, 7 | 8 frames, two cherries swinging on their stems, leaf fluttering | juice drops that fall |
orb | 8, 9 | 8 frames, a blue soul flame with a white core and eyes, embers drifting up | wisps that rise |
battery | 10, 11 | 8 frames, a power cell charging up, sparks when full | electric sparks |
checkpoints: 128x320, 16x32 frames, 8 columns
Identity: twoDKit.art.fx.checkpoints. The ground is the bottom pixel row.
| Look | Rows | Idle | Reached |
|---|---|---|---|
flag | 0, 1 | 4 frames, grey flag hanging low (copied from art/fx/checkpoint) | 8 frames, red and gold flag waving at the top |
lantern | 2, 3 | 8 frames, dark brass lantern swinging on an iron crook | 8 frames, flickering flame and a warm halo |
campfire | 4, 5 | 8 frames, cold logs, a sword planted in them, a wisp of smoke | 8 frames, roaring flames and rising sparks |
banner | 6, 7 | 8 frames, carved totem with a limp grey banner | 8 frames, glowing eyes and a waving royal banner with a gold emblem |
beacon | 8, 9 | 8 frames, metal pylon, dark lamp, red standby blink | 8 frames, spinning cyan lamp, light rays, energy climbing the column |
All pixels are fully opaque or fully clear, as the alpha-cut sprite shader needs; glows are dithered. Every look carries a dark outline so it reads on every theme.