home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 Mobile / Chip_Mobile_2001.iso / palm / spiele / pikoban / pikoban.exe / pikoban.txt < prev    next >
Encoding:
Text File  |  2000-07-13  |  23.1 KB  |  588 lines

  1. Pikoban Copyright (c) 1996-2000 Tan Kok Mun
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3. This is version 3.0 of Pikoban aka Sokoban for PalmPilot.
  4.  
  5. +----------------------------------------------------------------------+
  6. | Sokoban is Copyright(C)1982 by Thinking Rabbit Inc. Japan.           |
  7. | The Classic Levels 1-50 is Copyright(C)1982 by Thinking Rabbit.      |
  8. | The Bonus Level 1-40 is Public Domain.                               |
  9. |                                                                      |
  10. | The Classic Levels 1-50 is similar to XSokoban Levels 1-50, and the  |
  11. | Public Domain Levels 1-40 is similar to XSokoban Levels 51-90.       |
  12. | The XSokoban Web-page maintained a Global High Score at:             |
  13. |      http://xsokoban.lcs.mit.edu/cgi-bin/xsokoban/best-scores        |
  14. |                                                                      |
  15. | You can participate in the score by submitting your solution.        |
  16. | Use the export feature to store your solution.                       |
  17. | Information is available at :                                        |
  18. |      http://xsokoban.lcs.mit.edu/~andru/xsokoban/manual-solve.html   |
  19. |                                                                      |
  20. +----------------------------------------------------------------------+
  21. | The sample memopad levels (Yoshio.csv and Autogen.csv) included in   |
  22. | the package are Copyright(c)1996-2000 by Yoshio Murase. Distributed  |
  23. | with permission.                                                     |
  24. |                                                                      |
  25. | Yoshio.csv contains levels manually created by Yoshio Murase. There  |
  26. | are currently 45 very challenging levels. He published new levels at |
  27. | his web-site from time to time.                                      |
  28. | Autogen.csv contains computer generated levels created by            |
  29. | Yoshio Murase on the study of Automatic making of Sokoban problems.  |
  30. | Looks simple but beware of it's challenge.                           |
  31. +----------------------------------------------------------------------+
  32.  
  33. Note: If you have additional information on the Levels copyright
  34. information, please let me know.
  35.  
  36. Please read LICENSE.TXT for important licencing information before
  37. installation.
  38.  
  39. NOTE FOR REGISTERED USERS :
  40. If you are using Pikoban2, please delete it. All puzzle levels are
  41. now integrated into a single program.
  42.  
  43. If you have register, thankyou for registering.
  44.  
  45. If you have not register and will like to know how to,
  46. please read REGISTER.TXT for more information.
  47.  
  48. The latest version of this software can be found at :
  49.      http://home.pacific.net.sg/~kokmun/palmpilot.htm
  50.  
  51. The Pikoban Dedicated Web-site is at
  52.      http://home.pacific.net.sg/~kokmun/pikoban/pikoban.htm
  53.  
  54. CONTENTS
  55. ========
  56.  0. WHAT'S NEW
  57.  1. GAME FEATURES
  58.  2. THE GAME
  59.  3. TO PLAY
  60.  4. DEFINE MEMOPAD LEVEL
  61.  5. EXPORT SOLUTION
  62.  6. IMPORT SOLUTION
  63.  7. INSTALLATION
  64.  8. DISCLAIMER
  65.  9. REGISTERATION INFORMATION
  66. 10. DISTRIBUTION
  67. 11. SHAREWARE AGREEMENT
  68. 12. HISTORY
  69. 13. PROBLEM ?
  70.  
  71.  
  72. 0. WHAT'S NEW (3.0)
  73.    ==================
  74.    Version 2.1 and above requires a minimum PalmOS 3.0 and above 
  75.    to run. For older PalmOS user, please use the older version
  76.    of Pikoban.
  77.  
  78.    New Features
  79.    - Unlimited undo, with support for undo move, undo push, 
  80.      undo push till tap, and undo move till tap.
  81.      Note: The undo implemented in this version is very much 
  82.            different from the previous version.
  83.            If you undo past your last memorized position, the
  84.            memorized is cleared.
  85.            Theoritically able to store around 3000 moves. Only 
  86.            moves used are stored and is highly compressed. 
  87.  
  88.            ie. If your current number of move is 800, it will
  89.                only stored the 800 moves and at an average 
  90.                compression ratio of 1.5:1, it will only used
  91.                around 534 bytes.
  92.  
  93.      During undo move/push till tap, the undo speed can be changed
  94.      with the up/down key. Up-key to speed up and down-key to
  95.      slow down.
  96.  
  97.    - Export moves to memopad, with user defined move characters.
  98.    - Import moves from memopad for solution playback or restore
  99.      game to export status. During playback, press the up-key to speed
  100.      up and down-key to slow down and tap anywhere on screen to forward
  101.      to last move. If sound is enabled, you can turn sound-off with the
  102.      Address-Key.
  103.  
  104.      Note: With the export/import feature, you can now:
  105.            - show other users your solution.
  106.            - saved uncompleted game/level for later completion.
  107.            - analyze your solution.
  108.  
  109.    - Auto replay at end of each level, to playback your solution.
  110.      During playback, tap anywhere on screen to forward to last move.
  111.      The playback speed is defined in Preference-Animation Speed.
  112.      You can press the up-key to speed up the playback or down-key
  113.      to slow the playback.
  114.      If sound is enabled, you can turn sound-off with the
  115.      Address-Key.
  116.  
  117.    - Basic sound effect. Set in preference.
  118.  
  119.    - New movement control. You can now control Pikoban to move
  120.      around the cargo instead of pushing it, by tapping on Pikoban first
  121.      and then the destination where you want it to move to.
  122.      When it is in move mode only, the pikoban will be inverted. If
  123.      blinking is enabled, the blinking rate is faster.
  124.  
  125.      This does not save any tapping stroke but do make it easier
  126.      on the player, cause now you no longer need to tap to another
  127.      destination before tapping into the final destination.
  128.  
  129.      All previous movement behaviour is still the same.
  130.  
  131.    Updated
  132.    - Level title display in Goto Games-Levels/Stats, to show
  133.      level numbering when title is too long.
  134.  
  135. 1. GAME FEATURES
  136.    ~~~~~~~~~~~~~
  137.    - Graphics are bigger when possible.
  138.    - All new flexi movement. If there is a path to the location
  139.      you specified, it will find it and move there in the shortest
  140.      path possible.
  141.  
  142.      You can push the cargo while moving either horizontally or 
  143.      vertically only.
  144.  
  145.    - 50 classic levels, plus 40 more levels for registered users,
  146.      plus more.....
  147.    - Unlimited undo, with support for undo move, undo push, 
  148.      undo push till tap, and undo move till tap.
  149.    - Pen and key movement Input.
  150.    - Game change (registered user only) and Level change.
  151.    - Memorized current positions and restore memorized positions.
  152.    - Game statistics.
  153.    - Color, Gray-scale and Black & White supported.
  154.    - New levels via MEMOPAD.
  155.    - Support board size up to 32x32.
  156.    - Export moves to memopad, with user defined move characters.
  157.    - Import moves from memopad for solution playback or restore
  158.      game to export status.
  159.    - Auto replay at end of each level, to playback your solution.
  160.  
  161.  
  162. 2. THE GAME
  163.    ========
  164.    Pikoban is a puzzle game.
  165.  
  166.    You are in a warehouse operating a push vehicle called the Pikoban.
  167.    In this world the building is a maze, and the Pikoban can only push
  168.    one cargo at a time.
  169.  
  170.    Your task is to push all the cargos scattered in the warehouse to
  171.    the designated locations for pickup.
  172.  
  173.    Pikoban can be moved horizontally or vertically only. Built into the
  174.    game is a smart maze move engine, where you can tap the location you
  175.    want to move to and it will decide the shortest possible path to the
  176.    location. If there is any obstruction to the destination, it will not
  177.    move.
  178.  
  179.  
  180. 3. TO PLAY
  181.    =======
  182.    The game will start at Level 1. At the completion of each level you will
  183.    have a choice to proceed to the next level. There are altogether 50 levels.
  184.  
  185.    The MENU commands are as follows :
  186.  
  187.    COMMANDS
  188.    ~~~~~~~~
  189.    - RESET LEVEL    : Reset the current level and start over.
  190.  
  191.    - GOTO Game/LEVEL...  : 
  192.                       Allows you to change the game/Level.
  193.  
  194.                       Use CLEAR to clear the level statistics.
  195.                       If you clear more than three level continuously you
  196.                       will be prompted with a CLEAR ALL option.
  197.  
  198.                       Press HELP for online description of the various
  199.                       button and usage for this option.
  200.  
  201.    - NEXT LEVEL     : Play next level.
  202.    - PREV LEVEL     : Play previous level.
  203.  
  204.    - MEMORIZE       : Memorized current positions. An indicator "M" at the
  205.                       top right corner will reminds you of a saved
  206.                       positions. Only one positions can be saved. Subsequent
  207.                       saving will overwrite previous saved positions.
  208.                       
  209.    - RECALL         : Restore memorized positions. Nothing happens when there
  210.                       is nothing to recall. Use the "M" indicator at top right
  211.                       corner to know if there is any saved positions.
  212.  
  213.    - PREFERENCES    : Setup game preferences. Select the "i" in the Preference
  214.                       screen for detail information for each options.
  215.  
  216.    UNDO
  217.    ~~~~
  218.    - UNDO BOX PUSH      : Undo your last box push.
  219.    - UNDO PUSH TILL TAP : Continuous undo one box push at a time until the screen
  220.                           is tap.
  221.    - UNDO MOVE          : Undo your last move.
  222.    - UNDO MOVE TILL TAP : Continuous undo one move at a time until the screen
  223.                           is tap.
  224.  
  225.    TOOLS
  226.    ~~~~~
  227.    - EXPORT MOVES : Export your current level moves to memopad.
  228.    - IMPORT MOVES : Import solution from memopad into current level.
  229.  
  230.    INFO
  231.    ~~~~
  232.    - HELP        : Summary instructions about the game.
  233.    - ABOUT       : Author information.
  234.  
  235.    Please refer to the on-line available in most panel for a description
  236.    of the items on the screen. Tap the "i" on the top right hand corner
  237.    or the "HELP" button for a description of the items on panel.
  238.  
  239.  
  240. 4. DEFINE MEMOPAD LEVEL
  241.    ====================
  242.    There are two ways to define MEMOPAD Level.
  243.  
  244.    METHOD 1. Direct definition on the PalmPilot Device
  245.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  246.    To have MEMOPAD defined levels, follow the following steps:
  247.    1. Launch MEMOPAD.
  248.    2. Define a new category with the name 'Pikoban', without
  249.       the quote and observed case.
  250.    3. In the Pikoban category, create a new memo.
  251.    4. In the memo, the first line is the title for the
  252.       level. For level copyright information specify '(c)'
  253.       follow by the copyright owner. Please note that 'c'
  254.       is in lower case.
  255.  
  256.       For the level title, I will recommend the use of a puzzle
  257.       group name followed by the level numbers. The level numbers
  258.       within the group should have the same number of numerals. 
  259.       To do this prefix the level number with zeroes as required.
  260.  
  261.       eg. Puzzle Group "Kids", which has 20 levels, the title
  262.           will be like 
  263.           Kids 01 (c)1999 Kiddy, Kids 02 (c)1999 Kiddy, ..., 
  264.           Kids 20 (c)1999 Kiddy
  265.  
  266.           Puzzle Group "TKM", which has 100 levels, the title will
  267.           be like
  268.           TKM 001 (c)1990 Tan KM, TKM 002 (c)1990 Tan KM, ...,
  269.           TKM 010 (c)1990 Tan KM, TKM 011 (c)1990 Tan KM, ...,
  270.           TKM 100 (c)1990 Tan KM
  271.  
  272.       By following this recommendation for level title, you can
  273.       easily jump from one puzzle group to another, by using
  274.       the -/+GROUP button in the GOTO GAME LEVEL screen.
  275.  
  276.       Board layout start from line 2, and uses the standard XSB
  277.       format with the following symbols.
  278.          # for Wall
  279.          . for Goal
  280.          $ for Box
  281.          * for Box on goal
  282.          @ for Pikoban
  283.          + for Pikoban on goal
  284.          <space> for Floor
  285.  
  286.       To make it easier to compose level on the memopad, you
  287.       can use the following symbols as well:
  288.          n for Wall
  289.          g for Goal
  290.          b for Box
  291.          d for Box on goal
  292.          p for Pikoban
  293.          q for Pikoban on goal
  294.          u for Floor
  295.  
  296.       The puzzle size is limited to 20x20 cells.
  297.       You can have up to 9999 memopad levels, except in the
  298.       unregistered version which allows you to define all
  299.       the levels but only played the first three levels only.
  300.  
  301.       eg.
  302.  
  303.       TKM Sample 001 (c)2000 Tan KM
  304.       ############
  305.       #..      #@#
  306.       # .     $  #
  307.       #######$$  #
  308.             #    #
  309.             ######
  310.  
  311.    The level sequence, will be as it appeared in your MEMOPAD. 
  312.    If you have followed the LEVEL TITLE naming recommendation, you
  313.    can turn on the MEMOPAD SORT option to have the level appearing
  314.    in the sequence you have defined.  
  315.  
  316.  
  317.    METHOD 2. Define via the Palm Desktop
  318.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  319.    YOSHIO.CSV and AUTOGEN.CSV contain levels that you can import into 
  320.    your memopad via the Palm Desktop. Follow the following steps to 
  321.    import the sample level. CSV, are comma seperated value which is 
  322.    recognised by the Palm Desktop Memopad.
  323.    
  324.  
  325.    1. Startup your Palm Desktop
  326.    2. Select MEMO application.
  327.    3. In the Memo Pad Category, create the Pikoban category.
  328.    4. Select Pikoban category.
  329.    5. Select File and then Import.
  330.    6. Select Comma Seperated (*.csv) for Files of Type.
  331.    7. Select YOSHIO.CSV or AUTOGEN.CSV and press Open.
  332.    8. You will see the Specify Import Fields screen. On the left is the
  333.       "Palm Fields" which shows Memo, Private and Category. All three
  334.       should be selected.
  335.    9. Press "OK" to complete the import process.
  336.    10. Hotsync your PalmPilot.
  337.  
  338.    To create your own level in the Palm Desktop, select MEMO application
  339.    and create new memo in the "Pikoban" category. Follows METHOD 1 
  340.    instructions and when done, do a sync to sync the level into your
  341.    PalmPilot device.
  342.  
  343.    Note: The level definition when view in the actual PalmPilot and 
  344.          Palm Desktop looks weird. This is due to the propotional font.
  345.          When viewed under fix font, eg. Courier it will be ok.
  346.  
  347.    +--------------------------------------------------------------+ 
  348.    | There are many levels available in the Internet that you can |
  349.    | download and play in Pikoban. Search using the keyword       |
  350.    | "Sokoban".                                                   |
  351.    | I will make available new levels to download from my website |
  352.    | in CSV format. Levels contribution are most welcome, but do  |
  353.    | respect the level author copyright.                          |
  354.    |                                                              |
  355.    | Do visit Pikoban dedicated website for new information:      |
  356.    |     http://home.pacific.net.sg/~kokmun/pikoban/pikoban.htm   |
  357.    +--------------------------------------------------------------+
  358.  
  359. 5. EXPORT SOLUTION
  360.    ===============
  361.    To export current level moves to MEMOPAD:
  362.      i. Select MENU-TOOLS-EXPORT MOVES
  363.     ii. Select the memopad category where you want to store the 
  364.         moves.
  365.    iii. Define the four movement characters, the default is xsokoban 
  366.         style which is KJLH.
  367.     iv. Provide a 20 letters comments.
  368.      v. Press OK.
  369.  
  370.    Note: The memo title will be as follows:
  371.          <level> <(moves/push)> <comments>
  372.          
  373.          eg. If the level is Classic 1 with 250/90 moves/push and
  374.              the comment is "Unsolved", the memo title will be
  375.              "Classic 01 (250/90) Unsolved"
  376.  
  377. 6. IMPORT SOLUTION
  378.    ===============
  379.    To import moves from MEMOPAD:
  380.      i. Select the game/level you want to import solution to.
  381.     ii. Select MENU-TOOLS-IMPORT MOVES
  382.    iii. Select the memopad category where you want to import from.
  383.     iv. Define the four movement characters, the default is xsokoban
  384.         style which is KJLH.
  385.      v. Select the memo and press OK
  386.  
  387.    Note: The import function will automatically select the first
  388.          memo within the category that matches the level description.
  389.  
  390.          During animated playback, use the up-down key to change
  391.          the animation speed.
  392.          Tap anywhere on screen to forward to last move.
  393.  
  394.          If sound is enabled, you can turn sound-off with the
  395.          Address-Key.
  396.  
  397. 7. INSTALLATION
  398.    ============
  399.    Install pikoban.prc using the standard pilot application installer.
  400.  
  401.  
  402. 8. DISCLAIMER
  403.    ==========
  404.    The author will not take responsibility for any form of damage or loss 
  405.    that occurs when/by using this program. By using the program, you have 
  406.    agreed on all the conditions stated here.
  407.  
  408.  
  409. 9. REGISTERATION INFORMATION
  410.    =========================
  411.    For registration information, please read the REGISTER.TXT file.
  412.  
  413.  
  414. 10.DISTRIBUTION
  415.    ============
  416.    This manual and all accompanying files may be distributed freely,
  417.    provided that:
  418.    - Neither text nor any other file is modified in any way. No file
  419.      may be omitted nor added in the distribution.
  420.  
  421.    - No money may be charged for the program nor for any accompanying
  422.      files, other than the usual downloading time fees charged by
  423.      commercial BBSes and online services.
  424.  
  425.    - I want to know where my program will be distributed. Please notify me
  426.      if it will be included in printed matter, floppy, or CD-ROM before its
  427.      publication. No matter what the circumstance, I would strongly
  428.      appreciate a copy of whatever collection in which it is included.
  429.  
  430.  
  431. 11.SHAREWARE AGREEMENT
  432.    ===================
  433.    Pikoban is a ShareWare. After registeration, it does not mean that you
  434.    own the software, you are only licence to use it in one machine. 
  435.    All ownership and Copyright of the software belongs to Tan Kok Mun. 
  436.    Please read LICENSE.TXT for the complete LICENSING AGREEMENT. 
  437.   
  438.  
  439. 12.HISTORY
  440.    =======
  441.    12/07/2000 - version 3.0
  442.  
  443.    23/06/2000 - Version 2.1
  444.    Version 2.1 and above requires a minimum PalmOS 3.0 and above 
  445.    to run. For older PalmOS user, please use the older version
  446.    of Pikoban.
  447.  
  448.    PalmOS 2.0 is dropped from this version onward. This is due to
  449.    the limitation of PalmOS 2.0 memory stack and is not able to 
  450.    support the larger board size of 32x32.
  451.  
  452.    New Features
  453.    - Support for board size up to 32x32. Do be aware that the 
  454.      object will be very much smaller at that size and will be
  455.      harder to play. You may want to enable Right-left Wall
  456.      Truncation to improve the object size (when possible).
  457.  
  458.    - Added Right/Left Wall truncation. 
  459.      The puzzle is always enclosed by wall. To have larger object
  460.      size you can enabled display truncation, which will cause 
  461.      some part of the wall on either sides to be truncated from
  462.      the display. Select 1 for minor truncation and 2 for more 
  463.      truncation. Set to 1-Small or 2-Small to enable truncation 
  464.      when the boardzise is larger than 22x22. In some puzzle this
  465.      option has no impact.
  466.  
  467.    - Options to backup the score/statistics database.
  468.  
  469.    - Current title level is display at the bottom of the screen.
  470.  
  471.    Updated
  472.    - Corrected Classic levels copyright information.
  473.  
  474.    - When hardware key is enabled for movement, the Calender Button when
  475.      pressed will go to the previous level and the Memopad button will go
  476.      to the next level.
  477.  
  478.    - Code optimization, speed up response.
  479.  
  480.    - The Display Warning when using grey-scale for PalmOS older than 3.5
  481.      will only display once for each game session.
  482.  
  483.    - The MEMORIZED indicator is now at top right hand corner.
  484.  
  485.    - Display is smoother during update.
  486.  
  487.    Fix
  488.    - Preview screen displaying rubbish when no level is defined in
  489.      MEMOPAD.
  490.  
  491.    18/06/2000 - Version 2.0
  492.    New Features
  493.    - Support B&W, Gray Scale(4 and 16) and Color display.
  494.      Note: Requires supported hardware and PalmOS 3.0. Gray scale
  495.            in PalmOS 3.0 to 3.3 are not officially supported. If
  496.            you encounter problem, please switch to B&W mode.
  497.  
  498.    - Move and push statistics and person initial.
  499.    - Best move/push statistics for each Game Level.
  500.    - Support New Level via Memopad.
  501.    - Smart menu. You can just write the menu shortcut character
  502.      without specifying the menu shortcut. eg. Just write "U" or
  503.      "u" to Undo.
  504.  
  505.    Bug Fixes
  506.    - Resolves compatibility issues with PalmOS 3.5.
  507.    - Fix undo problem after Memory-Recall.
  508.  
  509.    06/04/1999 - Version 1.9.2
  510.               - Resolves compatibility issues with TRG memory.
  511.  
  512.    30/01/1999 - Version 1.9d
  513.               - Fix display problem in Goto Game/Level for Palm OS 1.x.
  514.               - Fix undo box moves, with "Combine box moves enabled" when 
  515.                 Pikoban is "trapped".
  516.               - Fix DB error while exiting from game (in rare cases).
  517.  
  518.    05/12/1998 - Version 1.8
  519.               - The PRC is now smaller than before. 29K compare to previous
  520.                 version which is 32K. Registered users will benefits much
  521.                 more (32K memory saving) cause both Game Levels are now 
  522.                 available in one single game.
  523.  
  524.               - Change Undo Last Move to Undo box moves. You can now undo the
  525.                 last ten box movements.
  526.  
  527.               - Combine box move fox undo. When enabled in preferences, the
  528.                 same box movement will be combined as a single move for undo.
  529.                 This effectively increases the undo capability.
  530.  
  531.               - Support Hardware key for movement. Enable it within 
  532.                 Preferences.
  533.  
  534.               - All new Goto Game/Level. Ability to switch between the two
  535.                 available games (Registered Users only) and Level.
  536.  
  537.                 It now shows, which level has been solved with a TICK. You
  538.                 can mark/unmark the level.
  539.  
  540.               - Support Palm III list icons.
  541.  
  542.               - Resolve compatibility issues with the new generation of Palm 
  543.                 EZ processor.
  544.  
  545.    08/06/1998 - Version 1.7
  546.               - All new flexi movement. If there is a path to the location
  547.                 you specified, it will find it and move there in the shortest
  548.                 path possible.
  549.  
  550.                 You can push the cargo while moving either horizontally or 
  551.                 vertically only.
  552.  
  553.                 Special thanks to ArsΦne von Wyss for giving me the insight on
  554.                 the implementation.
  555.  
  556.    23/05/1998 - Version 1.6
  557.                 - Double L-path movement.
  558.                 - Corrected the Same Level play when a puzzle is solved.
  559.                 - Fix PalmPilot III compatibility.
  560.  
  561.    30/05/1997 - Version 1.5
  562.                 - Boxes in the final location is shown differently.
  563.                 - Fix display problem when the menu shortcut is used.
  564.                 - Nicer "Memorize" indicator.
  565.                 - Corrected the misleading 50+ button in the GOTO Panel.
  566.  
  567.    21/05/1997 - Version 1.2
  568.                 - Added Next Level and Prev Level menu.
  569.                 - Added ability to memorized current position and
  570.                   ability to restore memorized position.
  571.                 - Some minor bug fixes (Memory shortage problem after
  572.                   long play and blinking within MENU).
  573.  
  574.    06/04/1997 - Version 1.1
  575.                 - The graphics are bigger and easier to see for some
  576.                   levels.
  577.                 - L-path movement capability, to reduce screen tapping.
  578.  
  579.    02/04/1997 - Version 1.0
  580.  
  581.  
  582. 13.PROBLEM ?
  583.    =========
  584.    If you should wish to contact me, I can be reached at:
  585.  
  586.         E-Mail   : kokmun@pacific.net.sg
  587.         Web Page : http://home.pacific.net.sg/~kokmun/
  588.