0 Fork 0

mirror of https://github.com/tiennm99/sokoban.git synced 2026-10-11 12:29:05 +00:00

Files

T

tiennm99 2ee7ac886a feat(levels): ship the full 155-puzzle Microban set

Expand the level data from the first 100 Microban layouts to the complete
set, up through the two oversized finale mazes ("Take the long way home"
and "The Dungeon"). Responsive tile sizing already handles the large
grids — no rendering changes needed.

Update credit language in README, PDR, changelog, roadmap, codebase
summary, menu subtitle, and the data file header to reflect the full
set. Credit for David W. Skinner's layouts remains prominent; ownership
of the engine, UI, parser, and progression code stays explicit.

Verified all 155 layouts parse cleanly, have a player, matching box/goal
counts, and none start already solved.

2026-04-11 23:36:34 +07:00

1.7 KiB

Raw Blame History

Sokoban — Product Development Record

What it is

A from-scratch Sokoban implementation by tiennm99. Phaser 3 + Vite, deployed to GitHub Pages. The engine, UI, parser, and progression system are original code. Puzzle layouts come from David W. Skinner's freely distributable Microban set — the full 155-puzzle set is shipped — layouts only, no code reused from Skinner's own programs.

Goals

Clean, beginner-friendly Sokoban that runs in any modern browser with no install.
Full 155-puzzle Microban set shipped, progressing from tiny beginner teasers up to the two huge finale mazes.
Keyboard-first UX with undo, restart, move counter, persistent progress.
Small, well-organized codebase (<200 LOC per file) that's easy to extend.

Non-goals

Custom level editor (puzzles are fixed, shipped with the build).
Networked play / leaderboards.
Sound / music (kept out to stay lightweight; may add later).

Target audience

Casual puzzle fans, Sokoban beginners. Microban set chosen specifically because it's designed for beginners and illustrates one concept per puzzle.

Success criteria

All 155 levels playable end-to-end, including the oversized finale mazes that rely on responsive tile sizing.
Progress (completion + best moves) persists across sessions.
Build output fits in the default Vite budget.
Runs smoothly on desktop browsers at 1024×768 canvas (scaled responsively).

Credits

Puzzle layouts: Microban by David W. Skinner (April 2000). Used per the collection's free-distribution terms with credit. Only the level designs — none of Skinner's code.
Game code: tiennm99 (with AI pair-programming from Claude).
Engine: Phaser 3.

1.7 KiB Raw Blame History Unescape Escape