Skip to content

Sokoban explainer PR #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
D-W-Chiang wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Sokoban explainer PR #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6d27c31
Add files via upload
D-W-Chiang Apr 29, 2026
901e072
refactor: full explanation of rules and strategies
JesterCoding May 3, 2026
6bd13b6
feat: separate explainers for each puzzle
JesterCoding May 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions instructions/en/puzzles/sokobaniq.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<game>
<name>Sokoban IQ</name>
<code>sokobaniq</code>
<history>The Sokoban puzzle was originally conceived by Hiroyuki Imabayashi, founder of Thinking Rabbit, a video game developer. It was released commercially in 1982.</history>
<board>
<pieces>There are an equal number of crates and targets, which can be moved by the worker.</pieces>
<tomove>Click an arrow to move the crate to one of its empty, adjacent tiles.</tomove>
<towin>Move every crate to a designated storage location (target) on the board.</towin>
</board>
<rules>
<rule>The worker (or player) can only move up, down, left, or right into an empty space.</rule>
<rule>The worker can push a single crate, but cannot pull crates.</rule>
<rule>Crates cannot be pushed into walls or other crates (no passing or stacking allowed).</rule>
<rule>The puzzle is solved when each crate is located on a target.</rule>
</rules>
<strategies>
<strategy>Plan your moves carefully in advance to avoid getting crates stuck in corners or narrow corridors.</strategy>
<strategy>Keep the worker behind the crates and push them toward the goals rather than moving them side-to-side unnecessarily.</strategy>
<strategy>Identify "deadlock" spaces—squares where a crate can never be pushed out—and avoid placing crates there.</strategy>
</strategies>
<alternates>
<pictures>
<references>
<links>
<gamescrafters>
<gamescrafter>Doris Chiang (Backend, GamesmanUni GUI Design &amp; Implementation)</gamescrafter>
<gamescrafter>Kshitij Tomar (Backend, GamesmanUni GUI Implementation, Variants)</gamescrafter>
<gamescrafter>Abraham Hsu (Mentor, Server Debugging)</gamescrafter>
<gamescrafter>Allena Oglivie (Mentor)</gamescrafter>
</gamescrafters>
</game>
32 changes: 32 additions & 0 deletions instructions/en/puzzles/sokobanlarge.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<game>
<name>Sokoban Large</name>
<code>sokobanlarge</code>
<history>The Sokoban puzzle was originally conceived by Hiroyuki Imabayashi, founder of Thinking Rabbit, a video game developer. It was released commercially in 1982.</history>
<board>
<pieces>There are an equal number of crates and targets, which can be moved by the worker.</pieces>
<tomove>Click an arrow to move the crate to one of its empty, adjacent tiles.</tomove>
<towin>Move every crate to a designated storage location (target) on the board.</towin>
</board>
<rules>
<rule>The worker (or player) can only move up, down, left, or right into an empty space.</rule>
<rule>The worker can push a single crate, but cannot pull crates.</rule>
<rule>Crates cannot be pushed into walls or other crates (no passing or stacking allowed).</rule>
<rule>The puzzle is solved when each crate is located on a target.</rule>
</rules>
<strategies>
<strategy>Plan your moves carefully in advance to avoid getting crates stuck in corners or narrow corridors.</strategy>
<strategy>Keep the worker behind the crates and push them toward the goals rather than moving them side-to-side unnecessarily.</strategy>
<strategy>Identify "deadlock" spaces—squares where a crate can never be pushed out—and avoid placing crates there.</strategy>
</strategies>
<alternates>
<pictures>
<references>
<links>
<gamescrafters>
<gamescrafter>Doris Chiang (Backend, GamesmanUni GUI Design &amp; Implementation)</gamescrafter>
<gamescrafter>Kshitij Tomar (Backend, GamesmanUni GUI Implementation, Variants)</gamescrafter>
<gamescrafter>Abraham Hsu (Mentor, Server Debugging)</gamescrafter>
<gamescrafter>Allena Oglivie (Mentor)</gamescrafter>
</gamescrafters>
</game>