home *** CD-ROM | disk | FTP | other *** search
/ Game Killer / Game_Killer.bin / 594.MMMAP.DOC < prev    next >
Text File  |  1993-02-03  |  25KB  |  662 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                                         MMMap
  29.  
  30.                              The Murder Motel MAP Maker
  31.  
  32.                            A Murder Motel Utility Program
  33.  
  34.  
  35.                                     Version 1.10
  36.  
  37.  
  38.                        Copyright (C) 1990-1993 by Duane Brown
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                   Table of Contents
  70.  
  71.  
  72.      System Requirements . . . . . . . . . . . . . . . . . . . . . . . .    2
  73.  
  74.      Included Files  . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  75.  
  76.      Setting up MMMap  . . . . . . . . . . . . . . . . . . . . . . . . .    2
  77.  
  78.      General Features  . . . . . . . . . . . . . . . . . . . . . . . . .    3
  79.  
  80.      Testing/Viewing a Map . . . . . . . . . . . . . . . . . . . . . . .    3
  81.  
  82.      Simple Editing  . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  83.  
  84.      Map Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  85.  
  86.      Quitting  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    4
  87.           Adding a Connection
  88.           Deleting a Connection
  89.           Adding a Room
  90.           Deleting a Room
  91.  
  92.      General Registration Information  . . . . . . . . . . . . . . . . .    6
  93.  
  94.      Revision History  . . . . . . . . . . . . . . . . . . . . . . . . .    6
  95.  
  96.      Registration and Other Legal Stuff  . . . . . . . . . . . . . . . .    6
  97.  
  98.      For Emergency Use Only  . . . . . . . . . . . . . . . . . . . . . .    7
  99.  
  100.      Registration Form . . . . . . . . . . . . . . . . . . . . . . . . .    8
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                Murder Motel Map Maker
  136.                                Written by Duane Brown
  137.                                     Version 1.10
  138.                    Copyright 1990, 1991, 1992, 1993 by Duane Brown
  139.  
  140.           This program is designed for anyone who wishes that there was a
  141.        better Map editor for Murder Motel maps for the Murder Motel door,
  142.        written by Sheldon Pasciak, currently being updated by Chuck Valechek. 
  143.        This program is a text-based, full screen, hot-key based map
  144.        editor/tester/debugger/viewer. Improvements over the old MakeMap
  145.        program:
  146.  
  147.        a) Full screen access to any room in a few keystrokes
  148.        b) Built in viewing/testing, all via intuitive keystrokes
  149.        c) Add and delete rooms and connections easily, automatically
  150.           increasing the number of rooms, if necessary.
  151.        d) Search room descriptions for text, with optional moving to that
  152.           room.
  153.        e) Ability to edit files other than Murder.Map.
  154.        f) And much much more!
  155.  
  156.        A picture is the best way to describe it's features:
  157.  
  158.    ╔════════════════════════ OLDEPRIS.MAP [Enterprise] ═════════════════════╗
  159.    ║           N┌─────┐   ┌─────┐U│ Current Room [Room 107]                 ║
  160.    ║            │# 108│   │# 101│ │  in the Turbolift at Deck J             ║
  161.    ║            └──┬──┘   └─────┘ │ North [Room 108]                        ║
  162.    ║               │^   ^/v       │  at a dead end (Circuit Breaker Room)   ║
  163.    ║               │v   /         │ South                                   ║
  164.    ║ W┌─────┐   ╔══╧══╗/         E│                                         ║
  165.    ║  │# 105├───╢# 107║           │ West  [Room 105]                        ║
  166.    ║  └─────┘< >╚═════╝           │  at a viewport                          ║
  167.    ║           /                  │ East                                    ║
  168.    ║         ^/                   │                                         ║
  169.    ║ D┌─────┐/         S          │ Up    [Room 101]                        ║
  170.    ║  │# 110│v                    │  in the Turbolift at Deck I             ║
  171.    ║  └─────┘                     │ Down  [Room 110]                        ║
  172.    ║                              │  in the Turbolift at Deck K             ║
  173.    ╠══════════════════════════════╧═════════════════════════════════════════╣
  174.    ║[G] Goto Room Number   [L] Search Descriptions      [T] Change Title    ║
  175.    ║[A] Add a Room         [C] Add Connection/Path      [N] Make New Map    ║
  176.    ║[D] Delete a Room      [R] Remove Connection/Path   [O] Open Map        ║
  177.    ║[S] Save Map           [E] Edit Description         [Q/Esc] Quit to DOS ║
  178.    ║Use Cursor Keys, PgUp and End to move to a room.                        ║
  179.    ╟────────────────────────────────────────────────────────────────────────╢
  180.    ║                                                                        ║
  181.    ║                                                                        ║
  182.    ╚═══════ Unregistered Murder Motel Map Maker, Version 1.10, 02/03/93. ═══╝
  183.  
  184.  
  185.  
  186.           The top line shows the file being worked on, as well as the Motel's
  187.         name in brackets. The upper left quadrant shows the current room
  188.         (room number is inside the double-lined box), surrounded by lines
  189.         which lead to other rooms. The letters show which direction the room
  190.         is (NSEW represent North, South, East, and West, with U and D
  191.         standing for Up and Down, respectively).  Also note the ^ v < >
  192.         pointers. These characters represent valid directions. That is, a
  193.         North room that has both a ^ (representing a North connection from
  194.         the current room) also has a South connection that will return you
  195.         back to the original room. YOu may see "one way" connections -- that
  196.  
  197.        MMMap                              1        THE Murder Motel Map Maker
  198.  
  199.  
  200.  
  201.  
  202.         is, just one "outbound" arrow without a corresponding return arrow.
  203.         That indicates a one way connection. Each direction is color coded
  204.         (if running on a color monitor) for easy identification. On the
  205.         opposite, upper right hand quadrant is listed the room descriptions
  206.         of all rooms that can be reached from the central room. The colors of
  207.         the descriptions match the colors of the rooms on the map.
  208.  
  209.         The bottom half of the screen consists of two areas. The bigger one
  210.         is the menu area, while the bottom two lines are the interactive
  211.         area. The menu shows you just that. The bottom two lines are where
  212.         any input from the user is asked.
  213.  
  214.         System Requirements
  215.         ===================
  216.  
  217.           Just a very basic system is needed to run MMMap. A color or
  218.         monochrome system capable of running in 80x25 mode is all that is
  219.         needed. 
  220.  
  221.  
  222.         Included Files
  223.         ==============
  224.  
  225.         MMMap.exe        The actual program.
  226.         MMMap.doc        This documentation file.
  227.         OldEpris.map     173 room map based on the NCC 1701 Enterprise,
  228.                          designed by me.
  229.         FullEprs.map     300 room map of Enterprise (above) plus a mining
  230.                          colony, designed by Ric Smith.
  231.  
  232.  
  233.  
  234.         Setting up MMMap
  235.         ================
  236.  
  237.           NOTE:  The program as distributed does not require a copy of
  238.         Brun45.exe, as I have decided that it would be best to make this
  239.         program capable of running standalone.  I know this increases the
  240.         size of the EXE file, but unlike Robot which is designed to run in a
  241.         Murder Motel directory, which has Brun45.exe available, MMMap is
  242.         designed to run on a non-Murder Motel directory/BBS.
  243.  
  244.           Just place a copy of the MMMap.exe file in the Murder Motel
  245.         directory or somewhere on DOS's Path, so it can be run from anywhere.
  246.         There are no other required files, just the .EXE.
  247.  
  248.         To run MMMap, type
  249.  
  250.         MMMap mapname
  251.  
  252.           Where Mapname does not have to have a .MAP extension (one is
  253.         assumed if it is not present). Note: MMMap must have either a new map
  254.         to work with, or load an existing map. Thus, running MMMap without a
  255.         filename will not work.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.        MMMap                              2        THE Murder Motel Map Maker
  264.  
  265.  
  266.  
  267.  
  268.  
  269.         General Features
  270.         ================
  271.  
  272.           All input to MMMap is via Hotkeys (no need to press enter) with a
  273.         few exceptions. Also, anytime any change is made within MMMap to an
  274.         map that has not been saved to disk, you will be warned before you
  275.         are allowed to quit MMMap or load a new map from disk.
  276.  
  277.           Movement is easy as well. The following keys are used for selecting
  278.         a direction.  
  279.  
  280.         North:  8/up arrow/Alt-N/Control-E
  281.         South:  2/down arrow/Alt-S/Control-X
  282.         East:   6/right arrow/Alt-E/Control-D
  283.         West:   4/left arrow/Alt-W/Control-S
  284.         Up:     9/Page Up key/Alt-U/Control-R
  285.         Down:   1/End key/Page Down/Alt-D/Control-Z or Control-C
  286.  
  287.         These keys work with the Numlock on or off. You can also use the
  288.         'inverted T' and the other grey function keys on the AT 101/102 type
  289.         keyboards as well.  Note the classic Wordstar diamond is supported,
  290.         as well as Alt-<direction> keys. Take your pick.
  291.  
  292.         Testing/Viewing a Map
  293.         =====================
  294.  
  295.           This is the easiest part of MMMap. Just use the cursor keys as
  296.         listed above to move around the map, see all of the connections, and
  297.         generally get a good feel for the map you are in. If you get stuck
  298.         and are trapped, you can go to another room in two ways: Enter the
  299.         room's number, or search the descriptions.
  300.  
  301.           If you know what room number you want to be, just select G for Go
  302.         to room number. Enter a number between 1 and the highest number
  303.         listed, and that room will now become the current room.  Easy enough.
  304.  
  305.           If you do not know the exact room number, but you know what the
  306.         room description says, you can select L for Search Descriptions. You
  307.         then enter a word or two that is in the room you want to be. You will
  308.         be shown a list of rooms, one at a time, that have the phrase you
  309.         entered (case insensitive search). If this room is not the right one,
  310.         select Y to the question 'Search for more matches'. When you find the
  311.         room you want, select N for the more matches question. You are then
  312.         given a choice of moving to the room you selected, or going back to
  313.         the place you were at the start of the search. Select Y if you want
  314.         to make this new room the current room, or N to return to the old
  315.         room.
  316.  
  317.         Simple Editing
  318.         ==============
  319.  
  320.           The simplest editing functions involve changing the Map title, and
  321.         editing a description for the current room. To change the Map title
  322.         (ie the name of the motel in Murder Motel, listed in brackets at the
  323.         top of the screen) select T and enter the new motel title. 
  324.  
  325.           To change/edit a description for a room, make that room the current
  326.         room (Goto it, or Look/Search for the description), then select E. To
  327.         leave the description the same, just press enter. Otherwise, type in
  328.  
  329.        MMMap                              3        THE Murder Motel Map Maker
  330.  
  331.  
  332.  
  333.  
  334.         the new description and press enter to save it.
  335.  
  336.         Map Maintenance
  337.         ===============
  338.  
  339.           You can do several things with maps: Save them, start new ones, and
  340.         load up new ones. Use the S command to save a map you are working on.
  341.         Press Enter to save the map using the original filename, Q to abort
  342.         the save, or type in a new filename (.MAP not necessary -- it is
  343.         appended automatically).
  344.  
  345.           To load a map file from disk, select Open/load map. If you are
  346.         working on a map and have made changes since the last save, you will
  347.         be asked if you want to save your changes before loading the new map.
  348.         In that case, follow the directions above for saving a map. After
  349.         that is done, you will be prompted for the name of the map to load.
  350.         Type in the name of the map file to load (.MAP assumed) and that map
  351.         is ready to be worked on.
  352.  
  353.           To make a new map from scratch from within MMMap, select N - Make a
  354.         New map. You will be asked for the Title of the Map, how many rooms
  355.         for the map (30 is the default, but do not worry about making it too
  356.         small--MMMap will automatically increase this limit as necessary),
  357.         and a filename. Design away!
  358.  
  359.         Quitting
  360.         ========
  361.  
  362.           To quit, type either the Escape key or Q. If you are asked about
  363.         whether you want to save any changes, answer Y to save changes, or N
  364.         to discard any changes. You are then asked if you really want to
  365.         return to DOS. Enter Y to exit, or N to go back to MMMap.
  366.  
  367.         Adding/Deleting Rooms and Connections
  368.         =====================================
  369.  
  370.         Ah yes. Adding and deleting rooms is at the heart of MMMap. This is
  371.         where MMMap overshadows Makemap. The easiest part is adding/deleting
  372.         a connection/path (I use both connection and path interchangeably --
  373.         both simply refer to a link between one room and another)
  374.  
  375.         Adding a Connection
  376.         -------------------
  377.  
  378.         C -- Add a connection/path adds a new path to another room, off of
  379.         the current room.  You are asked to select the room where the
  380.         connection is being made TO. You can enter a room number, search for
  381.         a room description, or Quit. After you select a room, you will be
  382.         asked to enter the direction FROM the current room to the room you
  383.         selected.  Once that direction key is pressed (ie 8, 2, etc), you
  384.         will have an opportunity to have an "opposite" connection added
  385.         automatically. That is, if you are in room #107 (as in the screen
  386.         capture above), and you add a connection to room #124, in the East
  387.         direction from #107, you will be asked if you want a West connection,
  388.         FROM #124 TO #107 added. That is, make a two-way connection without
  389.         having to worry about going to the new room, and making the
  390.         connection back. (Neat, huh? I thought so) Note, that if the room
  391.         that you just connected to already has an opposite direction used (ie
  392.         #124 already has a room to it's West) then you will be told that you
  393.         can't auto-add an opposite connection.  [Playing around a few times
  394.  
  395.        MMMap                              4        THE Murder Motel Map Maker
  396.  
  397.  
  398.  
  399.  
  400.         will give you a better feel for what I'm talking about.]
  401.  
  402.         Deleting a Connection
  403.         ---------------------
  404.  
  405.         R -- Remove a connection/path deletes a connection between two rooms.
  406.         Since there are only 6 possible directions, this is much easier to
  407.         understand. Just select the direction of the connection you want to
  408.         get rid of. If it is possible, you will be asked if you want to auto-
  409.         delete the opposite connection from the other room -- that is,
  410.         totally sever the connection for your convenience. It goes without
  411.         saying that you can not delete any connections if the room does not
  412.         have any connections going from it (ie a dead end room).
  413.  
  414.  
  415.         Adding a Room
  416.         -------------
  417.  
  418.         A -- Add a Room, allows you to add a room to the Map. You will be
  419.         first asked if you want to add a Separate room, a Connected room, or
  420.         Quit.  A separate room is just that -- it will be created without any
  421.         connections to other rooms. A connected room is a room that will be
  422.         connected to the current room. 
  423.  
  424.           Next, you will be asked if for the room that you want to add. You
  425.         can choose from entering a room number, having a new empty room
  426.         automatically found, or Quit. If you know the room number  you want
  427.         to add, just select E and type in the number. Selecting A will find
  428.         the first empty room (the one that has no room description) and
  429.         select that. If there are no available rooms, then the total number
  430.         of rooms in the map is automatically increased, with this new room
  431.         being the room added. For example, if you have 175 rooms used, and
  432.         select Automatically find an empty room, the number of rooms will be
  433.         increased to 176, and room 176 will be the room added.
  434.  
  435.           If you selected add a Connecting room, then you are asked for which
  436.         direction off of the current room should this new room be placed.
  437.  
  438.           At this point, you are asked to enter the description of the room
  439.         you are adding. Remember that the 'You are' is automatically placed
  440.         in front of any text entered here, and 'in area ###' is automatically
  441.         placed after the description of the room while in the Murder Motel
  442.         Door.
  443.  
  444.           Again, if you selected add a Connecting room, you will be asked, if
  445.         it is possible, to add an opposite connection (that is, to complete a
  446.         two-way path to and from the two rooms. Answer Y if you want such a
  447.         two way path setup, or N for a one way connection.
  448.  
  449.         That's it. You've just added a room to your motel map. It may sound
  450.         confusing, but try it out and you'll get the hang of it. Once you get
  451.         used to it, the process is intuitive.
  452.  
  453.         Deleting a Room
  454.         ---------------
  455.  
  456.         D -- Deleting a Room, is easier to understand and process. Deleting a
  457.         room means totally removing ANY traces of it's existence in the map.
  458.         The description of the room is erased, as well as *ALL OUTBOUND*
  459.         connections to other rooms, as well as *ALL INBOUND* connections from
  460.  
  461.        MMMap                              5        THE Murder Motel Map Maker
  462.  
  463.  
  464.  
  465.  
  466.         other rooms. This may well leave some parts of the map inaccessible.
  467.         You have been warned!
  468.  
  469.         You are first asked if you want to delete the Current room, Enter a
  470.         room number, or Quit. Note that for your own safety, you can NOT just
  471.         delete a room that is North, South, etc of you by just selecting a
  472.         direction. You MUST enter the actual room number.  You are asked if
  473.         you are sure you want to delete the room. Answer Y or N here.
  474.  
  475.         Now, if you entered the current room number, or selected delete
  476.         Current Room, you will be asked the same questions as above. However,
  477.         if you delete the current room, you now have no reference point, so
  478.         you are forced to goto another room. If you know a room number you
  479.         want to go to, enter that room number. Otherwise, the first non-empty
  480.         room in the map will be chosen for you automatically. A bit of an
  481.         inconvenience, but this is a safety feature for you.
  482.  
  483.         General Registration Information
  484.         =================================
  485.  
  486.         MMMap is not crippled in any way, shape, or form. Registration
  487.         removes the "Unregistered" word from the bottom line of the screen,
  488.         as well as gives you credit for being registered when you quit MMMap.
  489.         Registration is only five (5) dollars, or whatever you feel like
  490.         contributing. MMMap is the product of 3 years of work, on and off, of
  491.         producing a decent full screen based Murder Motel Map editor
  492.         (anything that can beat the pants off of Makemap and Testmap). MMMap
  493.         is about 2,600 lines of Quickbasic 4.5 code, all of which is mine. I
  494.         do not know of any other Map editor that is comparable to what MMMap
  495.         does. 
  496.  
  497.         Revision History
  498.         ================ 
  499.  
  500.         Version 1.10
  501.         January 23, 1993
  502.  
  503.         Initial release of MMMap. Previous versions were distributed to a few
  504.         people, some of which I give thanks to for trying out MMMap:
  505.  
  506.         Ric Smith, Walter Alexander, Ric Stverak, plus others who I can not
  507.         think of now. 
  508.  
  509.  
  510.  
  511.  
  512.         Registration and Other Legal Stuff
  513.         ==================================
  514.  
  515.           If you find after a reasonable amount of time (around 30 days) that
  516.         MMMap meets your needs, you must register the program.  After
  517.         receiving your registration key, MMMap will report that you are
  518.         running a registered copy, instead of saying that you are running an
  519.         Unregistered copy.  I will also add your name to my mailing list,
  520.         give you advance notice for updates on this and my other programs,
  521.         and send you updated versions of any of my programs that you have.
  522.  
  523.  
  524.  
  525.  
  526.  
  527.        MMMap                              6        THE Murder Motel Map Maker
  528.  
  529.  
  530.  
  531.  
  532.           Permission is granted to post this program on electronic Bulletin
  533.         Board systems.  Therefore, you are encouraged to upload the
  534.         unaltered, unmodified archive file to Bulletin Board Systems, even if
  535.         you do not use this program.  There are no warranties, express or
  536.         implied, other than that this software will take up space on your
  537.         disk.  I have tried to make this program as safe as possible, but I
  538.         will not be held responsible for any losses as the result from the
  539.         use of this program.
  540.  
  541.           The registration fee is $5, payable by check or money order, to
  542.         Duane Brown at the address below.  Print out and fill in the
  543.         requested information and I will send you the key file, or the
  544.         information needed for you to create the key file, and instructions
  545.         on how to install this file.  I will send the key file to you via
  546.         Netmail if you are on either Fidonet, Echonet, or Youthnet, or call
  547.         your BBS and upload the key file.  If you wish for me to call your
  548.         board and upload the key, please set up an account under the name
  549.         "Duane Brown" that will allow uploading, and enter the password on
  550.         the registration form.  
  551.           If you do not want me to send the key file to you electronically, I
  552.         will send you instructions on how to create the key file by mail. 
  553.         However, if you have any additional comments, bug reports, etc,
  554.         please feel free to get in touch with me via Snail-mail at
  555.  
  556.         Duane Brown
  557.         100 Pewter Lane
  558.         Stafford, VA 22554-1518
  559.  
  560.         or call
  561.  
  562.         The End of the Line BBS
  563.         Stafford, Virginia
  564.         Data (703)720-1624, 24 hours a day.
  565.         Running Dbridge 1.51 with Remote Access 1.11 (registered)
  566.         accepting 300/1200/2400/9600 V.32 callers.
  567.         Fidonet 1:274/16, Echonet 50:5703/16, Youthnet 13:13/20, 13:2600/0.
  568.         Crash mail accepted.  Full access to first time callers.
  569.  
  570.  
  571.         For Emergency Use Only
  572.         ======================
  573.  
  574.         If you have a question that absolutely can not wait, you can call me
  575.         voice at (703)659-6302 at reasonable hours (i.e. before 9:30 pm
  576.         Eastern Time).  If I am available, I will do my best to help you out. 
  577.         However, I can diagnose problems better if I have a copy of your
  578.         Murder Motel files so I can look at them.  I am now studying for my
  579.         BS in Computer Science full time at George Mason University, so my
  580.         time is limited.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.        MMMap                              7        THE Murder Motel Map Maker
  594.  
  595.  
  596.  
  597.  
  598.    Registration Form
  599.    =================
  600.  
  601.    Please fill out the following information, along with your check or money
  602.    order, and mail to:
  603.  
  604.    Duane Brown
  605.    100 Pewter Lane
  606.    Stafford, Virginia 22554-1518.
  607.  
  608.    Your registration will be processed within one day of receipt.  Thank you for
  609.    supporting shareware.
  610.  
  611.  
  612.    Program Registering:   ___MMMap_1.10___
  613.  
  614.    Name: ________________________________________________________________
  615.                 (case is significant!)
  616.  
  617.    Home Address:        _________________________________________________
  618.  
  619.                         _________________________________________________
  620.  
  621.    Voice Number:        ___________________________
  622.  
  623.    Send the Registration Key: Via Netmail? [ ] Uploading to Your BBS? [ ]
  624.                               Snailmail (US Postal Service?) [ ] 
  625.  
  626.    Please fill out below only if you run a BBS:
  627.  
  628.    BBS Software:        _________________________________________________
  629.  
  630.    Hours of Operation:  _________________________________________________
  631.  
  632.    BBS Number:       ___________________________
  633.  
  634.    Password:  ___________________________________________________________
  635.     (only needed if requesting 'Uploading to Your BBS?' box above)
  636.  
  637.    Where did you get this program?  _____________________________________
  638.  
  639.    Fidonet/Othernet Address(es):   ______________________________________
  640.  
  641.  
  642.    Any additional Comments/Suggestions (Use other sheets if necessary):
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.        MMMap                              8        THE Murder Motel Map Maker
  660.  
  661.  
  662.