From 8dae7f9dc0cc50806bff6898c683e1d897e6fe78 Mon Sep 17 00:00:00 2001 From: adokanchi Date: Tue, 26 May 2026 00:50:16 -0700 Subject: [PATCH 1/2] Add Klotski explainer --- instructions/en/puzzles/klotski.xml | 30 +++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 instructions/en/puzzles/klotski.xml diff --git a/instructions/en/puzzles/klotski.xml b/instructions/en/puzzles/klotski.xml new file mode 100644 index 0000000..3145a79 --- /dev/null +++ b/instructions/en/puzzles/klotski.xml @@ -0,0 +1,30 @@ + + + Klotski + klotskie + Klotski is a puzzle originating in the early 20th century. Its exact origin is not fully known, possibly emerging from the United States' 15-puzzle or the Chinese Huarong Dao. + + There are pieces of various sizes that can be moved around the board. + Click an arrow to slide a piece to an adjacent, empty space. + Move the large 2x2 piece to the target area. + + + Pieces cannot overlap or leave the boundaries of the board. + Pieces cannot be removed from the board or moved through other pieces. + The puzzle is solved when the large 2x2 piece reaches the target area, regardless of the locations of other pieces. + + + Plan how to efficiently move disruptive pieces away from the path to the target area. + Ensure empty board spaces remain in useful locations, as pieces cannot move unless there is space to move into. + Consider alternate paths to the target area, rather than immediately traveling in a straight line. + + + + + + + Tony Dokanchi (Design, Backend, GamesmanUni GUI Implementation, Themes, & Variants) + Boyi Pan (Design, Backend, QA, & Debugging) + Allena Oglivie (Mentor) + + \ No newline at end of file From e2dc1bbb63e08201422692320cf9f89f86220049 Mon Sep 17 00:00:00 2001 From: Alvaro Estrella Date: Tue, 16 Jun 2026 18:51:27 -0700 Subject: [PATCH 2/2] Instruction fix. --- instructions/en/puzzles/klotski.xml | 53 +++++++++++++++++++---------- 1 file changed, 35 insertions(+), 18 deletions(-) diff --git a/instructions/en/puzzles/klotski.xml b/instructions/en/puzzles/klotski.xml index 3145a79..6334139 100644 --- a/instructions/en/puzzles/klotski.xml +++ b/instructions/en/puzzles/klotski.xml @@ -1,30 +1,47 @@ Klotski - klotskie + klotski Klotski is a puzzle originating in the early 20th century. Its exact origin is not fully known, possibly emerging from the United States' 15-puzzle or the Chinese Huarong Dao. - - There are pieces of various sizes that can be moved around the board. - Click an arrow to slide a piece to an adjacent, empty space. - Move the large 2x2 piece to the target area. - - - Pieces cannot overlap or leave the boundaries of the board. - Pieces cannot be removed from the board or moved through other pieces. - The puzzle is solved when the large 2x2 piece reaches the target area, regardless of the locations of other pieces. - + The board is a 4x5 grid containing pieces of various sizes that can be slid horizontally or vertically into adjacent empty spaces. + There are pieces of various sizes that can be moved around the board. + Click an arrow to slide a piece to an adjacent, empty space. + Move the large 2x2 piece to the target area. + Pieces cannot overlap or leave the boundaries of the board. Pieces cannot be removed from the board or moved through other pieces. The puzzle is solved when the large 2x2 piece reaches the target area, regardless of the locations of other pieces. - Plan how to efficiently move disruptive pieces away from the path to the target area. - Ensure empty board spaces remain in useful locations, as pieces cannot move unless there is space to move into. - Consider alternate paths to the target area, rather than immediately traveling in a straight line. + + Clear the Path + Plan how to efficiently move disruptive pieces away from the path to the target area. + + + Manage Empty Space + Ensure empty board spaces remain in useful locations, as pieces cannot move unless there is space to move into. + + + Explore Alternate Routes + Consider alternate paths to the target area, rather than immediately traveling in a straight line. + - - + + + + Wikipedia contributors. "Klotski." Wikipedia, The Free Encyclopedia, en.wikipedia.org/wiki/Klotski. Accessed 16 June 2026. + Palomino, Joshua, and Roanne Crisologo. "Determining the Minimum Number of Moves in a Klotski Puzzle." International Journal of Academic Multidisciplinary Research (IJAMR), 2025, ijeais.org/wp-content/uploads/2025/2/IJAMR250225.pdf. + + + https://en.wikipedia.org/wiki/Klotski + Wikipedia — Klotski + + + http://ijeais.org/wp-content/uploads/2025/2/IJAMR250225.pdf + IJAMR — Determining the Minimum Number of Moves in a Klotski Puzzle + + - Tony Dokanchi (Design, Backend, GamesmanUni GUI Implementation, Themes, & Variants) - Boyi Pan (Design, Backend, QA, & Debugging) + Tony Dokanchi (Backend, GamesmanUni GUI Design & Implementation) + Boyi Pan (Backend, GamesmanUni Design) Allena Oglivie (Mentor) \ No newline at end of file