                                 Double-Up! 2.0
                              for mystic 1.12a38+
                               by Darryl Perry 
Software --------------------------------------------------------------------
       [ ] PCB PPe      [ ] OBV          [ ] VGA         [ ] OTHER___________
       [ ] Renegade     [ ] Iiniquity    [ ] ASCII       [ ] HTML/CGI/WWW    
       [x] Mystic       [ ] WWVI         [ ] Telegard    [x] MPL
       [ ] ANSI         [ ] TEXT
OS --------------------------------------------------------------------------
              [x] dos  [ ] os/2  [x] windows [x] Win32 [x] *nix
Type ------------------------------------------------------------------------
                infoform [ ]   utility [ ]  misc [ ]  door [X]
Disclaimer-------------------------------------------------------------------

   The author has taken every precaution to insure that no harm or damage
will occur on computer systems operating this util.  Never the less, the
author will NOT be held liable for whatever may happen on your computer
system or to any computer systems which connects to your own as a result of
operating this util.  The user assumes full responsibility for the correct
operation of this software package, whether harm or damage results from
software error, hardware malfunction, or operator error.  NO warranties are
offered, expressly stated or implied, including without limitation or
restriction any warranties of operation for a particular purpose and/or
merchant ability.  If you do not agree with this then do NOT use this
program.

Double-Up! Description---------------------------------------------------------

  Double-Up! is a Mystic MPL version of the 2048 puzzle game.

  On the 4x4 grid, move the numbered tiles Up, Down, Left, or Right.  The
  tiles slide over and if two matching numbered tiles touch, they Double-Up!
  into one tile.

  Double-Up! v2.0 is the first InterBBS version of the game.  With v2.0, 
  sysops can join their game with other BBSes in a message network.


+ Features include:
  
  o Fully functional - no registration required
  o source code included
  o Multi-Player InterBBS leader board - Get the high score!



NOTE!!! This app requires Mystic BBS v1.12a38 or later.


Double-Up! MPL Intallation-----------------------------------------------------

  o UPGRADING from v2.0 to v2.?
    No special tasks are needed.  Follow normal installation instructions.

  o UPGRADING from v1.x to v2.x
    Remove dblup.ply from the Double-Up! directory.  The file structure for 2.x
    is not compatable with v1.x, so it needs to be deleted and recreated.
    This will reset the game scores.

  o Place the doubleup.mps in the Mystic SCRIPTS directory and then compile with 
    mplc or mide.

  o Add Double-Up! to your desired menu.  The Mystic menu type is GX for running 
    a script. There is only one optional parameter. Add the path and filename
    of the top ten scores file.

    Type: GX
    Data: doubleup [/path/to/desired/textfile/dir/filename.ext]

  o OPTIONAL Add the scores file to your game scores bulletin.

InterBBS setup-----------------------------------------------------------------

  To run Double-Up! in InterBBS mode, it must first be configured to do so.

  Once Double-Up! is setup for InterBBS mode, no further sysop intervention is
  required.

  o Place ibbs.mpy in the Double-Up! directory
  o Create/Edit ibbs.ini in the Double-Up! directory
  o Configure ibbs.ini with the proper keyword settings. 
  ##
  ## DATA_BASE
  ## This is the perminant index value of the networked database message base on 
  ## the local BBS.  I use the FSX_DAT FSXnet echo to join the game to FSXnet
  ## but any message base can be used.  
  DATA_BASE=12
  ##
  ## FROM
  ## This is the message base FROM text.  The ibbs.mpy script will look for
  ## messages with this text in the from field.
  ## This must be set the same for every BBS in the network.  If it is 
  ## different than the rest, the script will not find messages that are
  ## intended for it.  It's best to not change this text.
  FROM=Double-Up IBBS
  ## 
  ## SUBJECT
  ## This is the default text to add to the subject field.  As with the FROM
  ## field, this must not be changed, or the script won't know what messages
  ## are intended for it.
  SUBJECT=DUIBBS
  ##
  ## PREFIX and POSTFIX
  ## Messages sent to IBBS are saved in a file.  The PREFIX and POSTFIX
  ## values are used to differentiate those files from other files.  You can
  ## changes these to what ever you want, but they must be distinctive so that
  ## they won't b confused with other files.
  PREFIX=ibbs.
  POSTFIX=.ibs
  ##
  ## ADDRESS
  ## This is the FTN address for the network.  This feature is not yet 
  ## implemented so it can be ignored.
  ADDRESS=33:1/1
  ##
  ## FLAG
  ## The Flag setting tells the script whether or not it should perform
  ## InterBBS functions.  Set this to '1' to activate IBBS functions.
  ## Any other value will deactivate InterBBS functions.
  FLAG=1


Notes on InterBBS functionality----------------------------------------------

  The method that Double-Up! uses to achieve InterBBS functions is by sending
  data via any networked message echo.  Scores and other data are posted to 
  the message base and sent out as a normal echomail message.  Recipients to 
  the echo can receive the messages and ibbs.mpy will extract the data from the 
  message and save it to a file in the double-up! directory.  The double-up MPL 
  script will then search for those files and decypher them and import the data 
  into the scores.

  The ibbs.mpy script only searches for certain messages and then saves those
  messages to text files in the same directory.  It is up to the MPL app
  to read and decode the textual data in the text file.  When the ibbs.mpy
  script reads a message from the message base, it deletes that message so
  that it will not be read again.  The script will not extract any messages
  from the local BBS.  Locally genrated messages are outgoing and must not be
  deleted lest they run the chance of being deleted before mutil extracts
  them.

  The Double-Up! app will then read the extracted text files and decypher the
  text.  The cypher is rudimentary at best and is only a means to obfuscate
  the text in an only available media.  No attempt has been made to offer any
  truly secure communication.  This method was chosen instead of using a 3rd
  party method is because I was atempting to make this game portable across
  all platforms and to be as self-contained as possible.


Bug Fixes/History-------------------------------------------------------------

Version 1.0 is the first release.  
Version 1.1 unreleased
Version 1.2 Fixed issues with the player list.  The game was not correctly
              adding/updating a player.
            Changed player listing to top ten player leaderboard display.  So
              now it only shows the top 10 players.
            Changed some artwork
Version 1.3 Fixed an issue where the game would abort at startup.  With Mystic
              1.11, it was ok to assign a value to a variable when defining it.
              It is apparently not a valid option with 1.12.
Version 2.0 Double-Up! is now InterBBS Capable
Version 2.1 Fixed an issue where the player's high score wasn't update if it 
              bested his previous high score.

Bug Reports-----------------------------------------------------------------

If you want to send me bug report or a note telling me how much you like it,
please feel free to do so.

Cyberia BBS web page http://cyberia.darktech.org
Email me at dperry.geo@yahoo.com
Telnet to telnet://cyberia.darktech.org

