Collectibles & Surfaces

Collectibles are items the player can pick up. Surfaces are interactive terrain the player can stand on, jump from, or climb. All positions are in logical pixels (400×300 space).

Collectibles

Coin

File: src/collectibles/coin.c / coin.h
Sprite: assets/sprites/collectibles/coin.png — 16×16 px display size
Pickup: AABB overlap with player. Plays gs->audio.coin on collection.

[coins]
x = 46.0
y = 236.0   # top edge in logical pixels

Every 1000 points (10 coins) the player earns a bonus life. The score threshold is configurable via score_per_life in the level file.

Star Yellow

File: src/collectibles/star_yellow.c / star_yellow.h
Sprite: assets/sprites/collectibles/star_yellow.png — 16×16 px display size
Pickup: AABB overlap. Restores 1 heart (up to MAX_HEARTS). No score awarded.

[star_yellows]
x = 272.0
y = 108.0

Star Green

File: src/collectibles/star_green.h
Sprite: assets/sprites/collectibles/star_green.png — 16×16 px
Pickup: Same as star yellow — restores 1 heart.

[star_greens]
x = 500.0
y = 80.0

Star Red

File: src/collectibles/star_red.h
Sprite: assets/sprites/collectibles/star_red.png — 16×16 px
Pickup: Same as star yellow — restores 1 heart.

[star_reds]
x = 800.0
y = 100.0

Last Star

File: src/collectibles/last_star.c / last_star.h
Sprite: assets/sprites/collectibles/last_star.png
Display size: 24×24 px
Pickup: Collecting it sets collected = 1, snapshots the level-completion summary, and shows the completion overlay. If next_phase is configured, Enter/Space/Start loads that TOML level; otherwise confirmation exits. Esc/Back exits without advancing. Only one instance per level, defined with [last_star].

[last_star]
x = 1492.0
y = 100.0

Surfaces

Platform (Ground Pillar)

File: src/surfaces/platform.c / platform.h
Sprite: assets/sprites/levels/grass_platform.png — 48×48 tile, 9-slice rendered
Behaviour: Static ground pillar. The player can land on the top surface. Pillars are positioned on the floor and extend upward. Rendered before the floor so the pillar base sinks into the ground naturally.

[platforms]
x           = 80.0   # left edge in logical pixels
tile_height = 2      # height in 48px tiles (1–3)
tile_width  = 1      # width in 48px tiles (usually 1)

Top surface Y for a pillar: FLOOR_Y − (tile_height × TILE_SIZE) = 252 − (h × 48).

Float Platform

File: src/surfaces/float_platform.c / float_platform.h
Sprite: assets/sprites/surfaces/float_platform.png — 48×16 px, 3-slice (left cap | centre fill | right cap)
Behaviour: Hovering one-way surface. Player lands on the top face only (one-way collision — can jump through from below). Three modes:

[float_platforms]
mode       = "STATIC"   # "STATIC" | "CRUMBLE" | "RAIL"
x          = 172.0
y          = 200.0
tile_count = 4          # width in 16px pieces
rail_index = 0          # RAIL mode only: index into [rails]
t_offset   = 0.0        # RAIL mode only: starting position on rail
speed      = 0.0        # RAIL mode only: traversal speed in tiles/s

Bridge

File: src/surfaces/bridge.c / bridge.h
Sprite: assets/sprites/surfaces/bridge.png — 16×16 px brick tile
Behaviour: Tiled crumble walkway. Bricks fall individually when the player walks over them, creating a time-limited path. After falling they respawn when the player moves away.

[bridges]
x           = 1350.0
y           = 172.0
brick_count = 8   # number of 16×16 brick tiles

Bouncepad

File: src/surfaces/bouncepad.c / bouncepad.h
Sprites: bouncepad_small.png, bouncepad_medium.png (wood), bouncepad_high.png
Sheet: 144×48 px, 3 columns × 1 row — Frame 0: extended, Frame 1: mid-compress, Frame 2: compressed (default idle state)
Behaviour: Spring pad that launches the player upward on landing. Plays a 3-frame squash/release animation (2→1→0, 80 ms/frame) then resets to idle.

[bouncepads_small]
x         = 734.0
launch_vy = -380.0
pad_type  = "GREEN"

[bouncepads_medium]
x         = 310.0
launch_vy = -536.2
pad_type  = "WOOD"

[bouncepads_high]
x         = 1420.0
launch_vy = -700.0
pad_type  = "RED"

Rail

File: src/surfaces/rail.c / rail.h
Sprite: assets/sprites/surfaces/rail.png — 64×64 px, 4×4 grid of 16×16 bitmask tiles
Behaviour: A path of interconnected tiles that spike blocks and float platforms ride along. Each tile has a bitmask of connection directions (N/E/S/W) that drives the correct sprite selection. Objects riding a rail store a float t ∈ [0, tile_count) and call rail_get_world_pos() each frame.

[rails]
layout  = "RECT"   # "RECT" = closed rectangle | "HORIZ" = open horizontal line
x       = 444      # top-left tile x
y       = 35       # top-left tile y
w       = 10       # width in tiles
h       = 6        # height in tiles
end_cap = 0        # 0 = open end (rider detaches), 1 = bouncing end

Vine

File: src/surfaces/vine.c / vine.h
Sprites: assets/sprites/surfaces/vine_green.png, assets/sprites/surfaces/vine_brown.png — 16×48 px per tile
Behaviour: Climbable vertical surface. The player enters by touching the vine and pressing Up or Down. Press Left/Right to detach and jump away.

[vines]
x          = 88.0
y          = 172.0   # top tile y in logical pixels
tile_count = 2       # height in tiles (each tile = 16 px wide × 48 px tall)

Ladder

File: src/surfaces/ladder.c / ladder.h
Sprite: assets/sprites/surfaces/ladder.png
Behaviour: Climbable ladder. The player enters by pressing Up at the base. Climbing is done with Up/Down. Jump or move left/right to exit.

[ladders]
x          = 1552.0
y          = 0.0       # top tile y
tile_count = 30        # height in tiles

Rope

File: src/surfaces/rope.c / rope.h
Sprite: assets/sprites/surfaces/rope.png
Behaviour: Climbable rope. Same interaction model as the vine — touch and press Up to grab, Up/Down to climb, Left/Right to swing off.

[ropes]
x          = 460.0
y          = 172.0
tile_count = 1