home *** CD-ROM | disk | FTP | other *** search
- Pikoban Copyright (c) 1996-2000 Tan Kok Mun
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- This is version 3.0 of Pikoban aka Sokoban for PalmPilot.
-
- +----------------------------------------------------------------------+
- | Sokoban is Copyright(C)1982 by Thinking Rabbit Inc. Japan. |
- | The Classic Levels 1-50 is Copyright(C)1982 by Thinking Rabbit. |
- | The Bonus Level 1-40 is Public Domain. |
- | |
- | The Classic Levels 1-50 is similar to XSokoban Levels 1-50, and the |
- | Public Domain Levels 1-40 is similar to XSokoban Levels 51-90. |
- | The XSokoban Web-page maintained a Global High Score at: |
- | http://xsokoban.lcs.mit.edu/cgi-bin/xsokoban/best-scores |
- | |
- | You can participate in the score by submitting your solution. |
- | Use the export feature to store your solution. |
- | Information is available at : |
- | http://xsokoban.lcs.mit.edu/~andru/xsokoban/manual-solve.html |
- | |
- +----------------------------------------------------------------------+
- | The sample memopad levels (Yoshio.csv and Autogen.csv) included in |
- | the package are Copyright(c)1996-2000 by Yoshio Murase. Distributed |
- | with permission. |
- | |
- | Yoshio.csv contains levels manually created by Yoshio Murase. There |
- | are currently 45 very challenging levels. He published new levels at |
- | his web-site from time to time. |
- | Autogen.csv contains computer generated levels created by |
- | Yoshio Murase on the study of Automatic making of Sokoban problems. |
- | Looks simple but beware of it's challenge. |
- +----------------------------------------------------------------------+
-
- Note: If you have additional information on the Levels copyright
- information, please let me know.
-
- Please read LICENSE.TXT for important licencing information before
- installation.
-
- NOTE FOR REGISTERED USERS :
- If you are using Pikoban2, please delete it. All puzzle levels are
- now integrated into a single program.
-
- If you have register, thankyou for registering.
-
- If you have not register and will like to know how to,
- please read REGISTER.TXT for more information.
-
- The latest version of this software can be found at :
- http://home.pacific.net.sg/~kokmun/palmpilot.htm
-
- The Pikoban Dedicated Web-site is at
- http://home.pacific.net.sg/~kokmun/pikoban/pikoban.htm
-
- CONTENTS
- ========
- 0. WHAT'S NEW
- 1. GAME FEATURES
- 2. THE GAME
- 3. TO PLAY
- 4. DEFINE MEMOPAD LEVEL
- 5. EXPORT SOLUTION
- 6. IMPORT SOLUTION
- 7. INSTALLATION
- 8. DISCLAIMER
- 9. REGISTERATION INFORMATION
- 10. DISTRIBUTION
- 11. SHAREWARE AGREEMENT
- 12. HISTORY
- 13. PROBLEM ?
-
-
- 0. WHAT'S NEW (3.0)
- ==================
- Version 2.1 and above requires a minimum PalmOS 3.0 and above
- to run. For older PalmOS user, please use the older version
- of Pikoban.
-
- New Features
- - Unlimited undo, with support for undo move, undo push,
- undo push till tap, and undo move till tap.
- Note: The undo implemented in this version is very much
- different from the previous version.
- If you undo past your last memorized position, the
- memorized is cleared.
- Theoritically able to store around 3000 moves. Only
- moves used are stored and is highly compressed.
-
- ie. If your current number of move is 800, it will
- only stored the 800 moves and at an average
- compression ratio of 1.5:1, it will only used
- around 534 bytes.
-
- During undo move/push till tap, the undo speed can be changed
- with the up/down key. Up-key to speed up and down-key to
- slow down.
-
- - Export moves to memopad, with user defined move characters.
- - Import moves from memopad for solution playback or restore
- game to export status. During playback, press the up-key to speed
- up and down-key to slow down and tap anywhere on screen to forward
- to last move. If sound is enabled, you can turn sound-off with the
- Address-Key.
-
- Note: With the export/import feature, you can now:
- - show other users your solution.
- - saved uncompleted game/level for later completion.
- - analyze your solution.
-
- - Auto replay at end of each level, to playback your solution.
- During playback, tap anywhere on screen to forward to last move.
- The playback speed is defined in Preference-Animation Speed.
- You can press the up-key to speed up the playback or down-key
- to slow the playback.
- If sound is enabled, you can turn sound-off with the
- Address-Key.
-
- - Basic sound effect. Set in preference.
-
- - New movement control. You can now control Pikoban to move
- around the cargo instead of pushing it, by tapping on Pikoban first
- and then the destination where you want it to move to.
- When it is in move mode only, the pikoban will be inverted. If
- blinking is enabled, the blinking rate is faster.
-
- This does not save any tapping stroke but do make it easier
- on the player, cause now you no longer need to tap to another
- destination before tapping into the final destination.
-
- All previous movement behaviour is still the same.
-
- Updated
- - Level title display in Goto Games-Levels/Stats, to show
- level numbering when title is too long.
-
- 1. GAME FEATURES
- ~~~~~~~~~~~~~
- - Graphics are bigger when possible.
- - All new flexi movement. If there is a path to the location
- you specified, it will find it and move there in the shortest
- path possible.
-
- You can push the cargo while moving either horizontally or
- vertically only.
-
- - 50 classic levels, plus 40 more levels for registered users,
- plus more.....
- - Unlimited undo, with support for undo move, undo push,
- undo push till tap, and undo move till tap.
- - Pen and key movement Input.
- - Game change (registered user only) and Level change.
- - Memorized current positions and restore memorized positions.
- - Game statistics.
- - Color, Gray-scale and Black & White supported.
- - New levels via MEMOPAD.
- - Support board size up to 32x32.
- - Export moves to memopad, with user defined move characters.
- - Import moves from memopad for solution playback or restore
- game to export status.
- - Auto replay at end of each level, to playback your solution.
-
-
- 2. THE GAME
- ========
- Pikoban is a puzzle game.
-
- You are in a warehouse operating a push vehicle called the Pikoban.
- In this world the building is a maze, and the Pikoban can only push
- one cargo at a time.
-
- Your task is to push all the cargos scattered in the warehouse to
- the designated locations for pickup.
-
- Pikoban can be moved horizontally or vertically only. Built into the
- game is a smart maze move engine, where you can tap the location you
- want to move to and it will decide the shortest possible path to the
- location. If there is any obstruction to the destination, it will not
- move.
-
-
- 3. TO PLAY
- =======
- The game will start at Level 1. At the completion of each level you will
- have a choice to proceed to the next level. There are altogether 50 levels.
-
- The MENU commands are as follows :
-
- COMMANDS
- ~~~~~~~~
- - RESET LEVEL : Reset the current level and start over.
-
- - GOTO Game/LEVEL... :
- Allows you to change the game/Level.
-
- Use CLEAR to clear the level statistics.
- If you clear more than three level continuously you
- will be prompted with a CLEAR ALL option.
-
- Press HELP for online description of the various
- button and usage for this option.
-
- - NEXT LEVEL : Play next level.
- - PREV LEVEL : Play previous level.
-
- - MEMORIZE : Memorized current positions. An indicator "M" at the
- top right corner will reminds you of a saved
- positions. Only one positions can be saved. Subsequent
- saving will overwrite previous saved positions.
-
- - RECALL : Restore memorized positions. Nothing happens when there
- is nothing to recall. Use the "M" indicator at top right
- corner to know if there is any saved positions.
-
- - PREFERENCES : Setup game preferences. Select the "i" in the Preference
- screen for detail information for each options.
-
- UNDO
- ~~~~
- - UNDO BOX PUSH : Undo your last box push.
- - UNDO PUSH TILL TAP : Continuous undo one box push at a time until the screen
- is tap.
- - UNDO MOVE : Undo your last move.
- - UNDO MOVE TILL TAP : Continuous undo one move at a time until the screen
- is tap.
-
- TOOLS
- ~~~~~
- - EXPORT MOVES : Export your current level moves to memopad.
- - IMPORT MOVES : Import solution from memopad into current level.
-
- INFO
- ~~~~
- - HELP : Summary instructions about the game.
- - ABOUT : Author information.
-
- Please refer to the on-line available in most panel for a description
- of the items on the screen. Tap the "i" on the top right hand corner
- or the "HELP" button for a description of the items on panel.
-
-
- 4. DEFINE MEMOPAD LEVEL
- ====================
- There are two ways to define MEMOPAD Level.
-
- METHOD 1. Direct definition on the PalmPilot Device
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- To have MEMOPAD defined levels, follow the following steps:
- 1. Launch MEMOPAD.
- 2. Define a new category with the name 'Pikoban', without
- the quote and observed case.
- 3. In the Pikoban category, create a new memo.
- 4. In the memo, the first line is the title for the
- level. For level copyright information specify '(c)'
- follow by the copyright owner. Please note that 'c'
- is in lower case.
-
- For the level title, I will recommend the use of a puzzle
- group name followed by the level numbers. The level numbers
- within the group should have the same number of numerals.
- To do this prefix the level number with zeroes as required.
-
- eg. Puzzle Group "Kids", which has 20 levels, the title
- will be like
- Kids 01 (c)1999 Kiddy, Kids 02 (c)1999 Kiddy, ...,
- Kids 20 (c)1999 Kiddy
-
- Puzzle Group "TKM", which has 100 levels, the title will
- be like
- TKM 001 (c)1990 Tan KM, TKM 002 (c)1990 Tan KM, ...,
- TKM 010 (c)1990 Tan KM, TKM 011 (c)1990 Tan KM, ...,
- TKM 100 (c)1990 Tan KM
-
- By following this recommendation for level title, you can
- easily jump from one puzzle group to another, by using
- the -/+GROUP button in the GOTO GAME LEVEL screen.
-
- Board layout start from line 2, and uses the standard XSB
- format with the following symbols.
- # for Wall
- . for Goal
- $ for Box
- * for Box on goal
- @ for Pikoban
- + for Pikoban on goal
- <space> for Floor
-
- To make it easier to compose level on the memopad, you
- can use the following symbols as well:
- n for Wall
- g for Goal
- b for Box
- d for Box on goal
- p for Pikoban
- q for Pikoban on goal
- u for Floor
-
- The puzzle size is limited to 20x20 cells.
- You can have up to 9999 memopad levels, except in the
- unregistered version which allows you to define all
- the levels but only played the first three levels only.
-
- eg.
-
- TKM Sample 001 (c)2000 Tan KM
- ############
- #.. #@#
- # . $ #
- #######$$ #
- # #
- ######
-
- The level sequence, will be as it appeared in your MEMOPAD.
- If you have followed the LEVEL TITLE naming recommendation, you
- can turn on the MEMOPAD SORT option to have the level appearing
- in the sequence you have defined.
-
-
- METHOD 2. Define via the Palm Desktop
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- YOSHIO.CSV and AUTOGEN.CSV contain levels that you can import into
- your memopad via the Palm Desktop. Follow the following steps to
- import the sample level. CSV, are comma seperated value which is
- recognised by the Palm Desktop Memopad.
-
-
- 1. Startup your Palm Desktop
- 2. Select MEMO application.
- 3. In the Memo Pad Category, create the Pikoban category.
- 4. Select Pikoban category.
- 5. Select File and then Import.
- 6. Select Comma Seperated (*.csv) for Files of Type.
- 7. Select YOSHIO.CSV or AUTOGEN.CSV and press Open.
- 8. You will see the Specify Import Fields screen. On the left is the
- "Palm Fields" which shows Memo, Private and Category. All three
- should be selected.
- 9. Press "OK" to complete the import process.
- 10. Hotsync your PalmPilot.
-
- To create your own level in the Palm Desktop, select MEMO application
- and create new memo in the "Pikoban" category. Follows METHOD 1
- instructions and when done, do a sync to sync the level into your
- PalmPilot device.
-
- Note: The level definition when view in the actual PalmPilot and
- Palm Desktop looks weird. This is due to the propotional font.
- When viewed under fix font, eg. Courier it will be ok.
-
- +--------------------------------------------------------------+
- | There are many levels available in the Internet that you can |
- | download and play in Pikoban. Search using the keyword |
- | "Sokoban". |
- | I will make available new levels to download from my website |
- | in CSV format. Levels contribution are most welcome, but do |
- | respect the level author copyright. |
- | |
- | Do visit Pikoban dedicated website for new information: |
- | http://home.pacific.net.sg/~kokmun/pikoban/pikoban.htm |
- +--------------------------------------------------------------+
-
- 5. EXPORT SOLUTION
- ===============
- To export current level moves to MEMOPAD:
- i. Select MENU-TOOLS-EXPORT MOVES
- ii. Select the memopad category where you want to store the
- moves.
- iii. Define the four movement characters, the default is xsokoban
- style which is KJLH.
- iv. Provide a 20 letters comments.
- v. Press OK.
-
- Note: The memo title will be as follows:
- <level> <(moves/push)> <comments>
-
- eg. If the level is Classic 1 with 250/90 moves/push and
- the comment is "Unsolved", the memo title will be
- "Classic 01 (250/90) Unsolved"
-
- 6. IMPORT SOLUTION
- ===============
- To import moves from MEMOPAD:
- i. Select the game/level you want to import solution to.
- ii. Select MENU-TOOLS-IMPORT MOVES
- iii. Select the memopad category where you want to import from.
- iv. Define the four movement characters, the default is xsokoban
- style which is KJLH.
- v. Select the memo and press OK
-
- Note: The import function will automatically select the first
- memo within the category that matches the level description.
-
- During animated playback, use the up-down key to change
- the animation speed.
- Tap anywhere on screen to forward to last move.
-
- If sound is enabled, you can turn sound-off with the
- Address-Key.
-
- 7. INSTALLATION
- ============
- Install pikoban.prc using the standard pilot application installer.
-
-
- 8. DISCLAIMER
- ==========
- The author will not take responsibility for any form of damage or loss
- that occurs when/by using this program. By using the program, you have
- agreed on all the conditions stated here.
-
-
- 9. REGISTERATION INFORMATION
- =========================
- For registration information, please read the REGISTER.TXT file.
-
-
- 10.DISTRIBUTION
- ============
- This manual and all accompanying files may be distributed freely,
- provided that:
- - Neither text nor any other file is modified in any way. No file
- may be omitted nor added in the distribution.
-
- - No money may be charged for the program nor for any accompanying
- files, other than the usual downloading time fees charged by
- commercial BBSes and online services.
-
- - I want to know where my program will be distributed. Please notify me
- if it will be included in printed matter, floppy, or CD-ROM before its
- publication. No matter what the circumstance, I would strongly
- appreciate a copy of whatever collection in which it is included.
-
-
- 11.SHAREWARE AGREEMENT
- ===================
- Pikoban is a ShareWare. After registeration, it does not mean that you
- own the software, you are only licence to use it in one machine.
- All ownership and Copyright of the software belongs to Tan Kok Mun.
- Please read LICENSE.TXT for the complete LICENSING AGREEMENT.
-
-
- 12.HISTORY
- =======
- 12/07/2000 - version 3.0
-
- 23/06/2000 - Version 2.1
- Version 2.1 and above requires a minimum PalmOS 3.0 and above
- to run. For older PalmOS user, please use the older version
- of Pikoban.
-
- PalmOS 2.0 is dropped from this version onward. This is due to
- the limitation of PalmOS 2.0 memory stack and is not able to
- support the larger board size of 32x32.
-
- New Features
- - Support for board size up to 32x32. Do be aware that the
- object will be very much smaller at that size and will be
- harder to play. You may want to enable Right-left Wall
- Truncation to improve the object size (when possible).
-
- - Added Right/Left Wall truncation.
- The puzzle is always enclosed by wall. To have larger object
- size you can enabled display truncation, which will cause
- some part of the wall on either sides to be truncated from
- the display. Select 1 for minor truncation and 2 for more
- truncation. Set to 1-Small or 2-Small to enable truncation
- when the boardzise is larger than 22x22. In some puzzle this
- option has no impact.
-
- - Options to backup the score/statistics database.
-
- - Current title level is display at the bottom of the screen.
-
- Updated
- - Corrected Classic levels copyright information.
-
- - When hardware key is enabled for movement, the Calender Button when
- pressed will go to the previous level and the Memopad button will go
- to the next level.
-
- - Code optimization, speed up response.
-
- - The Display Warning when using grey-scale for PalmOS older than 3.5
- will only display once for each game session.
-
- - The MEMORIZED indicator is now at top right hand corner.
-
- - Display is smoother during update.
-
- Fix
- - Preview screen displaying rubbish when no level is defined in
- MEMOPAD.
-
- 18/06/2000 - Version 2.0
- New Features
- - Support B&W, Gray Scale(4 and 16) and Color display.
- Note: Requires supported hardware and PalmOS 3.0. Gray scale
- in PalmOS 3.0 to 3.3 are not officially supported. If
- you encounter problem, please switch to B&W mode.
-
- - Move and push statistics and person initial.
- - Best move/push statistics for each Game Level.
- - Support New Level via Memopad.
- - Smart menu. You can just write the menu shortcut character
- without specifying the menu shortcut. eg. Just write "U" or
- "u" to Undo.
-
- Bug Fixes
- - Resolves compatibility issues with PalmOS 3.5.
- - Fix undo problem after Memory-Recall.
-
- 06/04/1999 - Version 1.9.2
- - Resolves compatibility issues with TRG memory.
-
- 30/01/1999 - Version 1.9d
- - Fix display problem in Goto Game/Level for Palm OS 1.x.
- - Fix undo box moves, with "Combine box moves enabled" when
- Pikoban is "trapped".
- - Fix DB error while exiting from game (in rare cases).
-
- 05/12/1998 - Version 1.8
- - The PRC is now smaller than before. 29K compare to previous
- version which is 32K. Registered users will benefits much
- more (32K memory saving) cause both Game Levels are now
- available in one single game.
-
- - Change Undo Last Move to Undo box moves. You can now undo the
- last ten box movements.
-
- - Combine box move fox undo. When enabled in preferences, the
- same box movement will be combined as a single move for undo.
- This effectively increases the undo capability.
-
- - Support Hardware key for movement. Enable it within
- Preferences.
-
- - All new Goto Game/Level. Ability to switch between the two
- available games (Registered Users only) and Level.
-
- It now shows, which level has been solved with a TICK. You
- can mark/unmark the level.
-
- - Support Palm III list icons.
-
- - Resolve compatibility issues with the new generation of Palm
- EZ processor.
-
- 08/06/1998 - Version 1.7
- - All new flexi movement. If there is a path to the location
- you specified, it will find it and move there in the shortest
- path possible.
-
- You can push the cargo while moving either horizontally or
- vertically only.
-
- Special thanks to ArsΦne von Wyss for giving me the insight on
- the implementation.
-
- 23/05/1998 - Version 1.6
- - Double L-path movement.
- - Corrected the Same Level play when a puzzle is solved.
- - Fix PalmPilot III compatibility.
-
- 30/05/1997 - Version 1.5
- - Boxes in the final location is shown differently.
- - Fix display problem when the menu shortcut is used.
- - Nicer "Memorize" indicator.
- - Corrected the misleading 50+ button in the GOTO Panel.
-
- 21/05/1997 - Version 1.2
- - Added Next Level and Prev Level menu.
- - Added ability to memorized current position and
- ability to restore memorized position.
- - Some minor bug fixes (Memory shortage problem after
- long play and blinking within MENU).
-
- 06/04/1997 - Version 1.1
- - The graphics are bigger and easier to see for some
- levels.
- - L-path movement capability, to reduce screen tapping.
-
- 02/04/1997 - Version 1.0
-
-
- 13.PROBLEM ?
- =========
- If you should wish to contact me, I can be reached at:
-
- E-Mail : kokmun@pacific.net.sg
- Web Page : http://home.pacific.net.sg/~kokmun/
-