home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / dnd29c4.zip / DOC.ZIP / EDIT.DOC < prev    next >
Text File  |  1992-08-16  |  15KB  |  333 lines

  1.  
  2.      DNDBBS Edit Documentation                                      Page  1
  3.  
  4.  
  5.      Table Of Contents                                               Page
  6.   
  7.      1.0  Introduction  . . . . . . . . . . . . . . . . . . . . . . .  2
  8.           1.1  The Editor . . . . . . . . . . . . . . . . . . . . . .  2
  9.           1.2  Entering *Edit . . . . . . . . . . . . . . . . . . . .  2
  10.           1.3  How and When to Edit . . . . . . . . . . . . . . . . .  3
  11.  
  12.      2.0  The Edit Menus  . . . . . . . . . . . . . . . . . . . . . .  4
  13.           2.1  [A]ction Menu  . . . . . . . . . . . . . . . . . . . .  4
  14.                2.1.1 [E]ncounter Monster  . . . . . . . . . . . . . .  5
  15.                2.1.2 [S]pells . . . . . . . . . . . . . . . . . . . .  5
  16.                2.1.3 [M]onster Talk . . . . . . . . . . . . . . . . .  5
  17.                2.1.4 [L]evel entry  . . . . . . . . . . . . . . . . .  5
  18.                         [H]ighest level
  19.                         [L]owest level
  20.                         [E]nter room restrictions
  21.                2.1.5 [H]ealth . . . . . . . . . . . . . . . . . . . .  5
  22.                         [F]atigue
  23.                         [V]itality
  24.                2.1.6 [R]ate . . . . . . . . . . . . . . . . . . . . .  5
  25.                         [E]ncounter
  26.                         [H]ealth
  27.                2.1.7 [I]nventory  . . . . . . . . . . . . . . . . . .  5
  28.                         [W]eapon
  29.                         [S]hields
  30.                         [A]rmor
  31.                         [M]agic items
  32.                2.1.8 [F]umble . . . . . . . . . . . . . . . . . . . .  5
  33.                2.1.9 [T]eleport . . . . . . . . . . . . . . . . . . .  5
  34.                2.1.10 [C]lear Room  . . . . . . . . . . . . . . . . .  5
  35.                2.1.11 [W]eapon Rusting  . . . . . . . . . . . . . . .  5
  36.                2.1.12 [O]bject Stealing . . . . . . . . . . . . . . .  5
  37.                2.1.13 [N]ew room number . . . . . . . . . . . . . . .  5
  38.                2.1.14 [D]isplay room actions  . . . . . . . . . . . .  5
  39.           2.2  [E]mail Menu . . . . . . . . . . . . . . . . . . . . .  x
  40.           2.3  [M]onster Menu . . . . . . . . . . . . . . . . . . . .  x
  41.           2.4  [O]bject Menu  . . . . . . . . . . . . . . . . . . . .  x
  42.           2.5  [R]oom Menu  . . . . . . . . . . . . . . . . . . . . .  x
  43.           2.6  [S]pell Menu . . . . . . . . . . . . . . . . . . . . .  x
  44.           2.7  [T]reasure Menu  . . . . . . . . . . . . . . . . . . .  x
  45.           2.8  [U]ser Menu  . . . . . . . . . . . . . . . . . . . . .  x
  46.  
  47.      DNDBBS Edit Documentation                                      Page  2
  48.  
  49.  
  50.      1.0  Introduction
  51.      =================
  52.      The  *Edit  program was  developed for the DMs and Sysop  so  creative
  53.      expansion  could take  place in the DNDBBS  campaign.  The options and
  54.      features for  editing are extensive  enough to  allow changing of most
  55.      any part of any data file needing to be edited.  This documentation is
  56.      intended to  be complete to the point  where any single editing prompt
  57.      or  entry can  be  looked up  in this  text for explanation.
  58.  
  59.      1.1  The Editor
  60.      ---------------
  61.      The editor is menu driven,  and oriented around maintaining the DNDBBS
  62.      database  (files with extension .DAT).  The DNDBBS files are organized
  63.      around a random record scheme,  each record containing many individual
  64.      fields (or a value for a particular editable entry).  Editing includes
  65.      the ability to add single records to files, change individual records,
  66.      search  for certain  records  given certain conditions, and  list file
  67.      records from a  file in page mode.
  68.  
  69.      1.2  Entering *Edit
  70.      -------------------
  71.      The editor (also known as *Edit) is contained in the program EDIT.EXE.
  72.      This program loads from the DOS command  prompt by typing EDIT.  There
  73.      are several ways to  enter *Edit from  the DNDBBS program.  The editor
  74.      can be entered  under three conditions.  One,  from the opening screen
  75.      which is displayed while waiting for a caller. Two, while the sysop is
  76.      online and the modem is offhook.  Three,  while another user is online
  77.      using the game  and  the modem.  During the  first condition  only the
  78.      sysop can enter *Edit  from the  console  (the keyboard  operating the
  79.      DNDBBS) by  pressing the F4 (function key number four).  In the second
  80.      condition only the sysop can enter *Edit from the console. During this
  81.      time the sysop can enter the editor only if his character which is on-
  82.      line the adventure is a dungeon master. Then the sysop can type *Edit,
  83.      press return,  or press the F1 (function key number one). In the third
  84.      condition the sysop can enter the editor and edit  interactively while
  85.      the user is  online by pressing the F1 key  (function key number one).
  86.      The user will not be shown the actual editing being done. Online users
  87.      can also edit from remote (through the modem) if their  character is a
  88.      dungeon master. Then the remote user types *Edit. The EDIT.EXE program
  89.      is considered an external program. This means the DNDBBS program calls
  90.      the editor,  which then loads as the currently operating program. When
  91.      the editor is exited, DNDBBS is loaded as the current program.
  92.  
  93.      DNDBBS Edit Documentation                                      Page  3
  94.  
  95.  
  96.      1.0  Introduction (cont.)
  97.      =================
  98.  
  99.      1.3  How and When to Edit
  100.      -------------------------
  101.      The editor's menu system is driven by hot keys. That means single key-
  102.      strokes will  guide you  through the menus.  When the editor is at the
  103.      main menu then selection of sub menus  are done by single keys without
  104.      the need for pressing the return key. Submenus are displayed after the
  105.      main menu selection and further submenus are selectable.  Exiting back
  106.      to the main menu is done by hitting Q (for quit) repeatedly.  The main
  107.      menu quits back to DOS (or the DNDBBS) with one final Q keystroke. The
  108.      reason for editing is to alter and shape the game campaign. The editor
  109.      allows the DM and Sysop to create new  rooms and objects in  the game.
  110.      The reason for restricting editing to certain players or users such as
  111.      dungeon masters and  the sysop  are  because of two matters.  One, the
  112.      game is expandable.  This  means what  new rooms or objects, etc.  are
  113.      created  go into  the files stored on disk.  They are not temporary or
  114.      exist in memory only.  This also  means that once a  room or object is
  115.      created then the file structure is expanded physically on the disk and
  116.      that  record (subdivision part of a file)  cannot be  deleted  without
  117.      reverting back to  the original files as  they come distributed.  Two,
  118.      the game itself is a careful balance  of objects, treasure,  monsters,
  119.      and rooms. This means that editing must be done  carefully in order to
  120.      preserve the atmosphere of a medieval type game play.  The campaign is
  121.      custom built with the adherence to DnD game play. Your dungeon masters
  122.      and assistant dungeon masters  should be hired with some experience in
  123.      owning a campaign  or having  spent time developing an adventure. Once
  124.      users are  hired as dungeon masters  then  they should  be given  full
  125.      access to the  edit functions  and  complete control  of the campaign.
  126.      This is  because when the DM is hired then  he is placed in a position
  127.      which enables him to contribute to the game.  What the DM does affects
  128.      the play of the campaign. The DM works together with the Sysop even if
  129.      the Sysop is too busy maintaining the main BBS  (if DNDBBS is run as a
  130.      door).  The DM should be  given rights by the Sysop to create the game
  131.      as he chooses.  This is the  definition of being a dungeon master. One
  132.      who operates the  campaign and game play.  The DM also  works together
  133.      with the user in creating and maintaining the adventure.  For example,
  134.      when the user requests spell  chants in mail then the DM responds with
  135.      some or all of the chants. Another example,  when the DM creates a new
  136.      area  for adventuring then  he instructs the users  how to get  to the
  137.      new rooms in mail.  Higher level characters can even contribute to the
  138.      campaign by  suggesting  new room areas to make.  Some  adventures are
  139.      also created  by consulting  on the phone  in a voice chat between the
  140.      users, dungeon masters, and the Sysop.  This is especially  useful for
  141.      games that have extremely large room files (above 2,000 rooms) or ones
  142.      that  have a  large amount  of users  (over 50 users).
  143.  
  144.      DNDBBS Edit Documentation                                      Page  4
  145.  
  146.  
  147.      2.0  The Edit Menus
  148.      ===================
  149.      The first editing menu  you will see  when *Edit starts is shown here:
  150.  
  151.         Edit V2.9B
  152.         [A]ction
  153.         [E]mail
  154.         [M]onster
  155.         [O]bject
  156.         [R]oom
  157.         [S]pell
  158.         [T]reasure
  159.         [U]ser
  160.         Edit Command(q to quit)?
  161.  
  162.      The  available main menu  selections are displayed for action, email,
  163.      monster, object, room, spell, treasure, user,  and quit.  The  prompt
  164.      "Edit Command?" waits  for one  of the current menu  selections to be
  165.      entered.  One keyboard  character is required to be typed.  The char-
  166.      acter  to  input is one of the  selection's first  letters;  the ones
  167.      surrounded in  brackets [].  For  example,  since [A]ction  is one of
  168.      the selections  displayed, you  would press the  A  key to  enter the
  169.      action edit menu.
  170.  
  171.      2.1  [A]ction Menu
  172.      ------------------
  173.      The action menu is shown here:
  174.      (selected by pressing A from the main menu)
  175.  
  176.         Edit Command? A
  177.         Room #1.
  178.         Triggers:
  179.         [E]ncounter Monster
  180.         [S]pells
  181.         [M]onster Talk
  182.         [L]evel entry
  183.         Results:
  184.         [H]ealth
  185.         [R]ate
  186.         [I]nventory
  187.         [F]umble
  188.         [T]eleport
  189.         Other:
  190.         [C]lear Room
  191.         [W]eapon Rusting
  192.         [O]bject Stealing
  193.         [N]ew room number
  194.         [D]isplay room actions
  195.         Action Edit Command(q to quit)?
  196.  
  197.      Actions by definition have two parts:  the trigger and the result. The
  198.      action has then taken place when both conditions are filled.  The four
  199.      triggers are:  1)by defaults,  if no triggers  are set  in the  action
  200.      edit menu,  by entering a room;  2)encountering of a  specific monster
  201.      number;  3)cast a  certain spell;  and 4)talking to some  monster when
  202.      the monster trigger in (2) is set.  The level entry option in triggers
  203.      above does not have a result.  This trigger is only  set off  with the
  204.      result to restrict users from entering a room direction based on their
  205.      character level. The four results are: 1)damage to health,  the result
  206.      could  be hits  for fatigue or vitality;  2)damage  to inventory,  the
  207.      user's weapons, shields, armor, or magic items can break or discharge;
  208.      3)fumbling weapons;  and  4)teleporting the user to another room.  The
  209.      rate result  listed above does  not have a trigger, instead the health
  210.      update  rate and  monster encounter rate  of a  room can be set. Other
  211.      selections include clearing  the room of all actions,  selecting a new
  212.      room to edit actions,  and to display the current room number actions.
  213.      The last remaining two only set the rate for weapon rusting and object
  214.      stealing,  in number of rounds  (user input prompts),  by monster in a
  215.      room. For rusting and stealing to work you must also edit the treasure
  216.      rustable, rust percent, and stealable, steal percent for each specific
  217.      treasure item.
  218.  
  219.      DNDBBS Edit Documentation                                      Page  5
  220.  
  221.  
  222.      2.0  The Edit Menus (cont.)
  223.      ===================
  224.  
  225.      2.1.1 [E]ncounter Monster
  226.      -------------------------
  227.      Enter monster name, or number?
  228.      Monster trigger added to room.
  229.  
  230.      2.1.2 [S]pells
  231.      --------------
  232.      Enter spell name, or number?
  233.      Spell trigger added to room.
  234.  
  235.      2.1.3 [M]onster Talk
  236.      --------------------
  237.      Enter monster name, or number?
  238.      Monster talk trigger added to room.
  239.  
  240.      2.1.4 [L]evel entry
  241.      -------------------
  242.      [H]ighest level (at least) for entry to room
  243.      [L]owest level (at most) for entry to room
  244.      [E]nter room restrictions
  245.      Enter option(q to quit)?
  246.  
  247.      Room restrictions:
  248.      [N], [E], [S], [W], [O], [U], [D], [NE], [SE], [SW], [NW], [G].
  249.      Enter option(q to quit)?
  250.  
  251.      2.1.5 [H]ealth
  252.      --------------
  253.      [F]atigue
  254.      [V]itality
  255.      Enter option(q to quit)?
  256.  
  257.      Number of hits of fatigue(1-32767)?
  258.      Room now hits for fatigue.
  259.  
  260.      Number of hits of vitality(1-32767)?
  261.      Room now hits for vitality.
  262.  
  263.      2.1.6 [R]ate
  264.      ------------
  265.      [E]ncounter
  266.      [H]ealth
  267.      Enter option(q to quit)?
  268.  
  269.      Encounter rate(1-32767)?
  270.      New encounter rate now in effect.
  271.  
  272.      Health rate(1-32767)?
  273.      New health rate now in effect.
  274.  
  275.      2.1.7 [I]nventory
  276.      -----------------
  277.      [W]eapons
  278.      [S]hields
  279.      [A]rmor
  280.      [M]agic items
  281.      Enter option(q to quit)?
  282.  
  283.      Room now breaks weapons.
  284.      Room now smashes shields.
  285.      Room now wrecks armor.
  286.      Room now drains magic items.
  287.  
  288.      2.1.8 [F]umble
  289.      --------------
  290.      Room now fumbles.
  291.  
  292.      2.1.9 [T]eleport
  293.      ----------------
  294.      Enter room number(1-x)?
  295.      Room now teleports.
  296.  
  297.      2.1.10 [C]lear room
  298.      -------------------
  299.      Room cleared of actions.
  300.  
  301.      2.1.11 [W]eapon rusting
  302.      -----------------------
  303.      Rate for weapons to rust(# of action prompts)?
  304.      Room now has rusting rate.
  305.  
  306.      2.1.12 [O]bject stealing
  307.      ------------------------
  308.      Rate for monsters to steal treasure(# of action prompts)?
  309.      Room now has monster stealing rate.
  310.  
  311.      2.1.13 [N]ew room number
  312.      ------------------------
  313.      Enter room number(1-x)?
  314.  
  315.      2.1.14 [D]isplay room actions
  316.      -----------------------------
  317.      Room has no triggers or results.
  318.  
  319.      Monster trigger in effect for monster: <monstername>.
  320.      Spell trigger in effect for spell: <spellname>.
  321.      Monster talk trigger in effect for monster: <monstername>.
  322.      Highest level user must be (at least) to enter room: <level>.
  323.      Lowest level user must be (at most) to enter room: <level>.
  324.      Restricted room directoins: <directionlist>.
  325.      Room hits for <hitnumber> for <fatigue/vitality>.
  326.      Encounter rate: <rate>.
  327.      Health rate: <rate>.
  328.      Room <breaks/smashes/wrecks/drains> <weapons/shields/armor/magic items>.
  329.      Room fumbles.
  330.      Room teleports to room <roomnumber>.
  331.      Room has weapon rusting rate of <rate> action prompts.
  332.      Room has monster stealing rate of <rate> action prompts.
  333.