pickups.module
This package holds more than this page lists. See all of its files in its world.
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.