#puzzle #sokoban #game

yanked sokoworld

Classic box pushing puzzler Sokoban

0.2.1-pre Aug 21, 2024
0.2.0 Aug 21, 2024

#5 in #sokoban

Unlicense

1.5MB
2.5K SLoC

Rust 2K SLoC // 0.0% comments JavaScript 173 SLoC // 0.1% comments Handlebars 144 SLoC Shell 60 SLoC // 0.1% comments

SokoWorld

Free and open source Sokoban client made with Rust and Macroquad.

Play the game!

Alternate install instructions:

Defining Levels

Levels are collected in Packs, which are TOML files that describe the pack and the data for each level within it.

The benefit of using TOML is that it's much more human readable than XML but provides a bit of structure and mark-up. It strikes a nice balance of easy to map to data structures while also being human editable.

See level-format.txt for the meaning of characters in the level files.

Dev Tools

In debug builds, Shift + Esc quits quickly.

Play a Specific Level

Run a specific pack and level with:

cargo run -- -p=assets/yoshio-murase-automatic.toml -l=2

where -p= is the path to the level pack and -l= is the number of level in the levels table.

Reload the Current Level from Disk

Press the 9 key to reload the current level from disk. This is useful for iterating on the design of a level.

Dev Notes

  • the JS shims in web are explicitly checked in in case they disappear & to have versions match

Deployment

The game is currently hosted on itch at https://brettchalupa.itch.io/sokoworld

Web

WASM builds can be built and pushed by running:

./release_wasm.sh

Ideally in the future this would push builds for desktop operating systems, create tags, etc., but this works for development.

macOS

macOS uses cargo bundle:

  1. Install cargo bundle: cargo install cargo-bundle
  2. Build the bundle: cargo bundle --release

There's a release_macos.sh script to build and upload a Universal app for macOS (works on both Intel and Apple Silicon Macs).

Windows

Not ideal but functioning

  1. cargo run --release
  2. mkdir win
  3. cp .\target\release\sokoworld.exe .\win\
  4. copy the assets folder into the win dir
  5. zip it up
  6. upload it to itch.io manually

Linux

Run the script:

./release_linux.sh

Credits

  • Programming: Brett Chalupa
  • Sprites
  • Sound Effects
    • melos: Melos Han-Tani of Analgesic Productions (non-commercial usage)

License

The course code is released under the Unlicense, see LICENSE for full details.

The license does not apply to the other assets, they fall under their own terms (see above). Assets created by me, Brett Chalupa, for the game are CC0 (Public Domain).

Dependencies

~12–26MB
~385K SLoC