Instructions for Replacement of Sokoban Puzzles in AdaGate
==========================================================

Each DegreeOfDifficulty [DoD] has a single text file containing 4 puzzle definitions in a common format that is easily found on the internet.  

One easy way to get hundreds is by going to SourceForge and downloading "WorldCupSokerban" because that contains dozens of puzzle files, each containing dozens of puzzles.  You can see which puzzles you want to use by playing Sokerban.

Choose 4 puzzles for each DoD and group them together in files named:

dod1.sok, ..., dod5.sok

Then check for and remove "#" characters in the header, if any, and you are ready to go!

I believe that the puzzle input code is relatively robust, and does not need to know #rows, #cols, and can tolerate textual comment lines that do not use the symbol "#".  It does require a blank line separating puzzles.

If you figure out the encoding, you can create your own puzzles.  Finally, there are many more to be found at http://www.sokobano.de/en/levels.php

Note that many sokoban puzzles are not appropriate to use in AdaGate.  Avoid ones that are:
. too large to fit into the dungeon,
. critically dependent on initial position of pusher (in AdaGate you might jump in anywhere),
. too repetitive or complex to solve using a 1st-person pusher (user gets queasy or lost),
. too much easier if cheating by jumping the walls,
. etc.

Jan 2015
fastrgv@gmail.com

