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.
This commit is contained in:
tiennm99 committed 2026-04-11 23:36:34 +07:00
1 parent 97d43d0d57
commit 2ee7ac886a
7 files changed
+563 -9

No files matched your search

+1 -1
View File
@@ -5,7 +5,7 @@ My from-scratch Sokoban game, built with Phaser 3 and Vite. The engine, UI, leve
Play: [https://tiennm99.github.io/sokoban/](https://tiennm99.github.io/sokoban/)
## Features
- **100 solvable puzzles** using level layouts from the Microban set (beginner-friendly, concept-focused).
- **All 155 puzzles** from the Microban set, from beginner teasers up to the giant "Take the long way home" maze and "The Dungeon" finale.
- **Paginated level select** with progress tracking and best-move record per level.
- **Controls**: arrow keys or WASD. `U` / `Z` to undo, `R` to restart, `Esc` for menu.
- **Undo history**, live move counter, animated moves.
+1 -1
View File
@@ -7,7 +7,7 @@ src/
└── game/
├── main.js # Phaser Game config + scene registration
├── data/
│ └── microban-levels.js # 100 XSB level strings
│ └── microban-levels.js # 155 XSB level strings (full Microban set)
├── core/
│ ├── level-parser.js # XSB text → {walls, targets, boxes, player, floors}
│ ├── board-model.js # Pure game state + move/undo/win logic
+1 -1
View File
@@ -6,7 +6,7 @@
- Arrow-key movement, box pushing, target detection.
## Phase 2 — Overhaul (complete, 2026-04-11)
- Replace 3 hand-crafted levels with 100 Microban levels.
- Replace 3 hand-crafted levels with the full 155-puzzle Microban set.
- Modularize: core / ui / scenes split, every file <200 LOC.
- BoardModel with undo + move counter.
- Paginated level select (5 pages × 20 levels).
+5
View File
@@ -1,5 +1,10 @@
# Project Changelog
## 2026-04-11 — Full Microban set
### Changed
- Level data expanded from the first 100 Microban puzzles to the complete 155-level set, including the oversized finale mazes ("Take the long way home", "The Dungeon"). Credit language updated everywhere to match.
## 2026-04-11 — Overhaul
### Added
+3 -3
View File
@@ -1,11 +1,11 @@
# 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 (100 of his puzzles shipped) — layouts only, no code reused from Skinner's own programs.
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.
- 100 curated puzzles, progressing from easy to moderately tricky.
- 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.
@@ -18,7 +18,7 @@ A from-scratch Sokoban implementation by tiennm99. Phaser 3 + Vite, deployed to
Casual puzzle fans, Sokoban beginners. Microban set chosen specifically because it's designed for beginners and illustrates one concept per puzzle.
## Success criteria
- All 100 levels playable end-to-end.
- 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).
+551 -2
View File
@@ -1,7 +1,8 @@
/**
* Puzzle layouts from the Microban level set by David W. Skinner
* (April 2000, 155 puzzles, freely distributable with credit).
* First 100 layouts shipped here — small, concept-focused puzzles.
* The full 155-layout set is shipped here — from tiny beginner puzzles
* up to the huge "Take the long way home" maze and "The Dungeon" finale.
* Only the level designs are borrowed; the parser, renderer, and engine
* are original code written for this project.
* Source: http://users.bentonrea.com/~sasquatch/sokoban/
@@ -825,5 +826,553 @@ export const MICROBAN_LEVELS = [
#.$# #
#. # $ #
# # #
########`
########`,
` #####
# #
# # #######
# * # #
## ## # #
# #* #
### # # # ###
# *#$+ #
# # ## ##
# # * #
####### # #
# #
#####`,
`###########
#....# #
# # $$ #
# @ ## #
# ##$ #
###### $ #
# #
######`,
` #####
# . ##
### $ #
# . $#@#
# #$ . #
# $ ###
## . #
#####`,
` #####
##### #
# $ #
# $#$#@#
### # #
# ... #
### ##
# #
####`,
` #### ####
## ### ##
# # # #
# *. .* #
###$ $###
# @ #
###$ $###
# *. .* #
# # # #
## ### ##
#### ####`,
` ########
# #
#@ $ #
## ###$ #
# .....###
# $ $ $ #
###### # #
# #
#####`,
`########
# #
# $*** #
# * * #
# * * #
# ***. #
# @#
########`,
`#### #####
# ### # ##
# # #$ $ #
#..# ##### # #
# @ # $ $ #
#..# ##
## #########
#####`,
` #######
# # #
# # # # #
# @ $ #
### ### #
# ### #
# $ ##.#
## $ #.#
## $ .#
# ## $#.#
## ## #.#
### # #
### #####`,
` ####
# #
# $####
###. . #
# $ # $ #
# . .###
####$ #
# @#
####`,
`######
# ####
# ...#
# ...#
###### #
# # #
# $$ ##
# @$ #
# $$ #
## $# #
# #
######`,
` #####
## ####
# $$$ #
# # $ #
# $## ##
### #. #
# # #
##### ###
# # ##
# @....#
# #
# # #
########`,
` #####
## #
### # #
# . #
# ## #####
# . . # ##
# # @ $ ###
#####. # $ #
#### $ #
## $ ##
# ##
# #
####`,
`######
# ###
# # $ #
# $ @ #
## ## #####
# #......#
# $ $ $ $ #
## ######
#####`,
` #####
##### ####
# # #
# #..... #
## ## # ###
#$$@$$$ #
# ###
#######`,
` #####
### #
####.....#
# @$$$$$ #
# # ##
##### #
#####`,
` #### ####
# ### ##
# @ #
##..### #
# # #
#...#$ # #
# ## $$ $ #
# $ ###
#### ###
####`,
` #####
## ##
# $ ##
# $ $ ##
###$# . ##
# # . #
## ##. #
# @ . ##
# # #
########`,
` ######
# ##
## ## #
# $$ # #
# @$ # #
# # #
#### # #
# ... ##
# ##
#######`,
` ####
####### #
# $ ##
# $##### #
# @# # #
## ##.. #
# # ..####
# $ ###
# $###
# #
####`,
` ######
# . #
##$.# #
# * #
# ..###
##$ # #####
## ## # #
# #### # #
# @ $ $ #
## # #
##########`,
`#####
# ###
# #$ #
# $ #
# $ $ #
# $# #
# @###
## ########
# ...#
# #
########..#
####`,
`########
# #
# $ $$ ########
##### @##. . #
#$ # . #
# #. . ##
#$# ## # #
# #
# ### ##
# # ####
####`,
`##############
# # #
# $@$$ # . ..#
## ## ### ## #
# # # #
# # # # #
# ######### #
# #
#############`,
` #####
# ##
# $ #
######## #@##
# . # $ $ #
# $# #
#...##### #
##### #####`,
` ###########
##....... #
# $$$$$$$@ #
# # # # ##
# # # #
# #######
#####`,
`## ####
#### ####
# $ $. #
## # .$ #
# ##.###
# $ . #
# @ # #
# ######
####`,
` #########
### # #
# * $ . . #
# $ ## ##
####*# #
# @ ###
# ###
#####`,
` #########
### @ # #
# * $ *.. #
# $ # #
####*# ###
# ##
# ###
#####`,
`##### #####
# ####.. #
# $$$ #
# $# .. #
### @# ## #
# ## #
##########`,
`#####
# #
# . #
#.@.###
##.# #
# $ #
# $ #
##$$ #
# ###
# #
####`,
`####
# @###
#.* #####
#..#$$ $ #
## #
# # ## #
# #####
#####`,
` #######
# . .###
# . . . #
### #### #
# @$ $ #
# $$ $ #
#### ###
#####`,
` ####
######### #
# ## $ #
# $ ## #
### #. .# ##
# #. .#$##
# # # #
# @ $ #
# #######
####`,
`#######
# #####
# $$#@##..#
# # #
# $ # # #
#### $ ..#
########`,
` #######
# #
## ###$##
#.$ @ #
# .. #$ #
#.## $ #
# ####
######`,
` ####
## ###
#### # $ #
# #### $ $ #
# ..# #$ #
# # @ ###
## #..# ###
# ## # #
# #
########`,
` ####
### #
# ###
# # . .#
# @ ...####
# # # # ##
# # $$ #
##### $ $ #
##$ # ##
# #
######`,
` ####
## ####
# ...#
# ...#
# # ##
# #@ #### ####
##### $ ### #
# ##$ $ #
### $$ #
# $ ## ###
# ######
######`,
`######## #####
# # ### #
# ## $ #
#.# @ ## $ ##
#.# # $ ##
#.# $ ##
#. ## #####
## #
######`,
` ########
# # . #
# .*.#
# # * #
####$##.##
# $ #
# $ ## $ #
# @# #
##########`,
` ####
# #
# ####
###$.$ #
# .@. #
# $.$###
#### #
# #
####`,
`####
# ####
# $ #
# .# #
# $# ##
# . #
#### #
# #
### ###
# $ #
## #$# ##
# $ @ $ #
# ..#.. #
### ###
#####`,
` ####
### #####
# $$ # #
# $ . .$$##
# .. #. $ #
### #** . #
# . **# ###
# $ .# .. #
##$$.@. $ #
# # $$ #
##### ###
####`,
` #####
# @ #
## ##
###.$$$.###
# $...$ #
# $.#.$ #
# $...$ #
###.$$$.###
## ##
# #
#####`,
` #######
## . ##
# .$$$. #
# $. .$ #
#.$ @ $.#
# $. .$ #
# .$$$. #
## . ##
#######`,
` #####
######## #
#. . @#.#
# ### #
## $ # #
# $ #####
# $# #
## # #
# ##
#####`,
`###########
# . # #
# #. @ #
# #..# #######
## ## $$ $ $ #
## #
#############`,
` ####
## ###
#@$ #
### $ #
# ######
# $....#
# # ####
## # #
# $# #
# #
# ###
####`,
` ####
##### #
# $#######
## ## ..# ...#
# $ $$#$ @ #
# ### #
####### # ####
####`,
` ####
# #
### #
## $ #
# # #
# #$$ ######
# # # .#
# $ @ .#
### ####..#
#### ####`,
`###### ####
# # #
#.## #$## #
# # # #
#$ # ### # #
# # # # #
# # #### # # #
#. @ $ * . #
###############`,
`#############
#.# @# # #
#.#$$ # $ #
#.# # $# #
#.# $# # $##
#.# # $# #
#.# $# # $#
#.. # $ #
#.. # # #
############`,
` ############################
# #
# ######################## #
# # # #
# # #################### # #
# # # # # #
# # # ################ # # #
# # # # # # # #
# # # # ############ # # # #
# # # # # # # # #
# # # # # ############ # # #
# # # # # # # #
# # # # ################ # #
# # # # # #
##$# # #################### #
#. @ # #
#############################`,
` ###### ####
#####*# ################# ##
# ### #
# ######## #### ## #
### #### # #### #### ##
#*# # .# # # # # # #
#*# # # # ## # ## ## #
### ### ### # ## # ## ##
# # #*# # # # #
# # ### ##### #### # #
##### ##### ####### ######
# # # #**# #
## # # #**# ####### ## #
# ######### # ##### ###
# # # $ #*#
# ######### ### @##### #*#
##### #### #### ######`
];
+1 -1
View File
@@ -19,7 +19,7 @@ export default class MenuScene extends Phaser.Scene {
const cy = this.cameras.main.centerY;
this.add.text(cx, cy - 200, 'SOKOBAN', FONTS.title).setOrigin(0.5);
this.add.text(cx, cy - 130, '100 puzzles to solve', FONTS.subtitle).setOrigin(0.5);
this.add.text(cx, cy - 130, '155 puzzles to solve', FONTS.subtitle).setOrigin(0.5);
createButton(this, cx, cy - 20, 'PLAY', () => this.scene.start('LevelScene'), { width: 240, height: 64 });