From 6d27c314094b8e89cd0e4bbf5d1dde5baae1615a Mon Sep 17 00:00:00 2001 From: D-W-Chiang Date: Wed, 29 Apr 2026 02:13:22 -0700 Subject: [PATCH 1/3] Add files via upload --- instructions/en/puzzles/sokoban.xml | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 instructions/en/puzzles/sokoban.xml diff --git a/instructions/en/puzzles/sokoban.xml b/instructions/en/puzzles/sokoban.xml new file mode 100644 index 0000000..2124600 --- /dev/null +++ b/instructions/en/puzzles/sokoban.xml @@ -0,0 +1,23 @@ + + + Sokoban + sokoban + The Sokoban puzzle was originally conceived by Hiroyuki Imabayashi, founder of Thinking Rabbit, a video game developer. It was released commercially in 1982. + + There are an equal number of crates and targets, which can be moved by the worker. + Click an arrow to move the crate to one of its empty, adjacent tiles. + + The puzzle is solved when each crate is located on a target. + + + + + + + + Doris Chiang (Backend, GamesmanUni GUI Design & Implementation) + Kshitij Tomar (Backend, GamesmanUni GUI Implementation, Variants) + Abraham Hsu (Mentor, Server Debugging) + Allena Oglivie (Mentor) + + \ No newline at end of file From 901e072a7d0c6f0478566d5382067ec22cb36f24 Mon Sep 17 00:00:00 2001 From: kshitij Date: Sat, 2 May 2026 17:56:37 -0700 Subject: [PATCH 2/3] refactor: full explanation of rules and strategies --- instructions/en/puzzles/sokoban.xml | 31 +++++++++++++++++++---------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/instructions/en/puzzles/sokoban.xml b/instructions/en/puzzles/sokoban.xml index 2124600..e0aa0e4 100644 --- a/instructions/en/puzzles/sokoban.xml +++ b/instructions/en/puzzles/sokoban.xml @@ -4,20 +4,29 @@ sokoban The Sokoban puzzle was originally conceived by Hiroyuki Imabayashi, founder of Thinking Rabbit, a video game developer. It was released commercially in 1982. - There are an equal number of crates and targets, which can be moved by the worker. - Click an arrow to move the crate to one of its empty, adjacent tiles. - - The puzzle is solved when each crate is located on a target. - - - - - - + There are an equal number of crates and targets, which can be moved by the worker. + Click an arrow to move the crate to one of its empty, adjacent tiles. + Move every crate to a designated storage location (target) on the board. + + + The worker (or player) can only move up, down, left, or right into an empty space. + The worker can push a single crate, but cannot pull crates. + Crates cannot be pushed into walls or other crates (no passing or stacking allowed). + The puzzle is solved when each crate is located on a target. + + + Plan your moves carefully in advance to avoid getting crates stuck in corners or narrow corridors. + Keep the worker behind the crates and push them toward the goals rather than moving them side-to-side unnecessarily. + Identify "deadlock" spaces—squares where a crate can never be pushed out—and avoid placing crates there. + + + + + Doris Chiang (Backend, GamesmanUni GUI Design & Implementation) Kshitij Tomar (Backend, GamesmanUni GUI Implementation, Variants) - Abraham Hsu (Mentor, Server Debugging) + Abraham Hsu (Mentor, Server Debugging) Allena Oglivie (Mentor) \ No newline at end of file From 6bd13b6fa47c1e62e07983c9e29cf15333e37650 Mon Sep 17 00:00:00 2001 From: kshitij Date: Wed, 6 May 2026 22:01:50 -0700 Subject: [PATCH 3/3] feat: separate explainers for each puzzle --- .../en/puzzles/{sokoban.xml => sokobaniq.xml} | 4 +-- instructions/en/puzzles/sokobanlarge.xml | 32 +++++++++++++++++++ 2 files changed, 34 insertions(+), 2 deletions(-) rename instructions/en/puzzles/{sokoban.xml => sokobaniq.xml} (97%) create mode 100644 instructions/en/puzzles/sokobanlarge.xml diff --git a/instructions/en/puzzles/sokoban.xml b/instructions/en/puzzles/sokobaniq.xml similarity index 97% rename from instructions/en/puzzles/sokoban.xml rename to instructions/en/puzzles/sokobaniq.xml index e0aa0e4..4927ef1 100644 --- a/instructions/en/puzzles/sokoban.xml +++ b/instructions/en/puzzles/sokobaniq.xml @@ -1,7 +1,7 @@ - Sokoban - sokoban + Sokoban IQ + sokobaniq The Sokoban puzzle was originally conceived by Hiroyuki Imabayashi, founder of Thinking Rabbit, a video game developer. It was released commercially in 1982. There are an equal number of crates and targets, which can be moved by the worker. diff --git a/instructions/en/puzzles/sokobanlarge.xml b/instructions/en/puzzles/sokobanlarge.xml new file mode 100644 index 0000000..866ca6d --- /dev/null +++ b/instructions/en/puzzles/sokobanlarge.xml @@ -0,0 +1,32 @@ + + + Sokoban Large + sokobanlarge + The Sokoban puzzle was originally conceived by Hiroyuki Imabayashi, founder of Thinking Rabbit, a video game developer. It was released commercially in 1982. + + There are an equal number of crates and targets, which can be moved by the worker. + Click an arrow to move the crate to one of its empty, adjacent tiles. + Move every crate to a designated storage location (target) on the board. + + + The worker (or player) can only move up, down, left, or right into an empty space. + The worker can push a single crate, but cannot pull crates. + Crates cannot be pushed into walls or other crates (no passing or stacking allowed). + The puzzle is solved when each crate is located on a target. + + + Plan your moves carefully in advance to avoid getting crates stuck in corners or narrow corridors. + Keep the worker behind the crates and push them toward the goals rather than moving them side-to-side unnecessarily. + Identify "deadlock" spaces—squares where a crate can never be pushed out—and avoid placing crates there. + + + + + + + Doris Chiang (Backend, GamesmanUni GUI Design & Implementation) + Kshitij Tomar (Backend, GamesmanUni GUI Implementation, Variants) + Abraham Hsu (Mentor, Server Debugging) + Allena Oglivie (Mentor) + + \ No newline at end of file