mirror of
https://github.com/tiennm99/sokoban.git
synced 2026-10-13 06:15:45 +00:00
tiennm99
97d43d0d57
Reword README, PDR, menu scene, and the data file header so the Microban credit clearly covers only the puzzle layouts borrowed from David W. Skinner. The parser, renderer, UI, and progression code are original, and ownership is now stated explicitly. Attribution for Skinner is preserved everywhere it appeared.
Sokoban
My from-scratch Sokoban game, built with Phaser 3 and Vite. The engine, UI, level parser, and progression system are all my own implementation. The puzzle layouts themselves come from David W. Skinner's freely distributable Microban set — I'm not reusing any of his code, only his level designs.
Play: https://tiennm99.github.io/sokoban/
Features
- 100 solvable puzzles using level layouts from the Microban set (beginner-friendly, concept-focused).
- Paginated level select with progress tracking and best-move record per level.
- Controls: arrow keys or WASD.
U/Zto undo,Rto restart,Escfor menu. - Undo history, live move counter, animated moves.
- Progress saved locally in
localStorage. - Responsive tile sizing so small and large levels both look right.
Development
npm install
npm run dev # dev server on http://localhost:8080
npm run build # production build
npm run dev-nolog # dev without the analytics ping
npm run build-nolog # build without the analytics ping
Project layout
Documentation
docs/project-overview-pdr.md— product scope.docs/system-architecture.md— how the pieces fit together.docs/code-standards.md— conventions.docs/development-roadmap.md— past and planned phases.docs/project-changelog.md— release notes.
Credits
- Puzzle layouts: Microban level set by David W. Skinner (April 2000). Freely distributable with credit. Original site: http://users.bentonrea.com/~sasquatch/sokoban/
- Game code: tiennm99 (with AI pair-programming from Claude).
- Engine: Phaser 3.
License
MIT — see LICENSE.