home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / LORDP32.ZIP / lordp32.inf (.txt) < prev    next >
OS/2 Help File  |  2006-04-07  |  69KB  |  430 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Disclaimer ΓòÉΓòÉΓòÉ
  3.  
  4. This INF file and all the information contained within was written by Sean 
  5. Dennis.  THIS IS NOT AN OFFICIAL DOCUMENT FROM GAMEPORT NOR MICHAEL PRESLAR! If 
  6. there are problems with the information, please contact me (Sean Dennis) and 
  7. NOT Gameport or Michael Preslar. 
  8.  
  9. Warning: At the time of this writing, LORD/2 is considered ALPHA SOFTWARE. YOU 
  10. RUN THIS AT YOUR OWN RISK!  Please, please make sure you backup your current 
  11. game before attempting to run this.  This has barely been tested (Michael 
  12. doesn't have an OS/2 machine yet, but we're working on that). 
  13.  
  14. Legend of the Red Dragon (LORD) is (C)1998-2006 Gameport, Inc.  LORD is 
  15. developed and nurtured by Michael Preslar. This INF and all the material 
  16. contained within was written by Sean Dennis (aka hausmaus).  The information is 
  17. correct to the best of my knowledge, but may change at any time with or without 
  18. notice.  The scripts included in the archive and in this document were written 
  19. by Sean Dennis.  You may edit them to your heart's content, but please give me 
  20. credit where credit is due, thanks. 
  21.  
  22. I highly recommend using NewView to view this INF with since NewView will allow 
  23. you to use Firefox to view all the external URLs.  I wrote this INF to use 
  24. NETSCAPE.EXE since that's the default for older versions of OS/2. 
  25.  
  26. This is version 0.1 of this FAQ.
  27.  
  28.  
  29. ΓòÉΓòÉΓòÉ 2. About LORD/2 ΓòÉΓòÉΓòÉ
  30.  
  31. LORD/2 is currently just a recompile of Legend of the Red Dragon for OS/2.  It 
  32. was compiled using Virtual Pascal/2 and MannDoor for the doorkit.  This is a 
  33. drop-in replacement for LORD.EXE. 
  34.  
  35. I have tested this using Maximus/2 and my DOOR32.MEC script.  The door itself 
  36. seems to work fine.  I have NOT tested any IGMs with it, however.  Much, much 
  37. more testing needs to be done before this becomes 'production quality'. 
  38.  
  39. I've included configuration sections for Maximus/2 and Telegard/2, as well as 
  40. one for other OS/2-native BBSes that are DOOR32.SYS capable or possibly could 
  41. be capable. Please read everything CAREFULLY before trying this 'live'. 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 3. LORD/2 Setup and Configuration ΓòÉΓòÉΓòÉ
  45.  
  46. I've included configurations for Maximus/2 and Telegard/2.  I haven't tried 
  47. LORD/2 on any other BBS configurations, but if you have, please let me know 
  48. about it. 
  49.  
  50.  
  51. ΓòÉΓòÉΓòÉ 3.1. Maximus/2 Configuration ΓòÉΓòÉΓòÉ
  52.  
  53. Maximus/2 Configuration 
  54.  
  55. Maximus/2 can be found at http://maximus.outpostbbs.net 
  56.  
  57. Here's how to get this setup under Maximus/2 (or at least how I did it on my 
  58. system): 
  59.  
  60.    1. Copy the DOOR32.MEC file to your \Misc directory and run MECCAP on it. 
  61.  
  62.    2. BACKUP YOUR LORD GAME (in fact, I'd recommend copying everything to 
  63.       another directory and using that directory to run this in). 
  64.  
  65.    3. Replace the original LORD.EXE with the LORD.EXE in this directory. 
  66.  
  67.    4. Create a batch file similar to below: 
  68.  
  69.             @echo off
  70.             d:
  71.             cd\doors\lord
  72.             lord -Dd:\max\node%1\door32.sys
  73.             cd\max\node%1
  74.  
  75.       Drop that into your \Max directory and name it whatever you want (I named 
  76.       mine LORDP32.CMD). 
  77.  
  78.    5. Edit your MENUS.CTL as such: 
  79.  
  80.               NoDsp Display_File    misc\door32             Demoted  "LORD"
  81.                     Xtern_OS2       runlordp.cmd_%k         Demoted  "LORD"
  82.  
  83.       Please note that you are passing the com PORT to the door, NOT the com 
  84.       SOCKET. Since you are using SIO/VMODEM to handle the communications and 
  85.       Maximus/2 isn't a true TCP/IP enabled application when it comes to 
  86.       connecting to the world, you want to make sure it goes on the right port, 
  87.       not the socket. 
  88.  
  89.    6. SILTP your CTL file(s), make sure you MECCAP'd your DOOR32.MEC and fire 
  90.       up Max.  Telnet in and all should be fine. 
  91.  
  92.  I noticed an immediate increase in speed with respect to the redrawing of 
  93.  screens in the OS/2 version, as well as an overall general increase in speed 
  94.  when running the door remotely.  Locally, it flew.  I personally recommend 
  95.  running all of your doors (and Max) in a full-screen session-the system runs 
  96.  better and the screen refresh is faster. 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 3.2. Telegard/2 Configuration ΓòÉΓòÉΓòÉ
  100.  
  101. Telegard/2 Configuration 
  102.  
  103. Telegard/2 can be found at http://www.telegard.net 
  104.  
  105. It's a fairly simple setup for Telegard/2 BBS sysops.  You'll need the 
  106. DOOR32.SCR script included in this archive.  I'll show you how I've tested it 
  107. here with the TG setup I have. 
  108.  
  109.    1. Put DOOR32.SCR in your \TG\TEXT directory. 
  110.  
  111.    2. Backup your LORD directory.  I recommend to copy your LORD directory to 
  112.       another new directory and then put this LORD.EXE in it. 
  113.  
  114.    3. Copy the new LORD.EXE over to the LORD directory. 
  115.  
  116.    4. Create a .CMD file in /TG called RUNLORD.CMD: 
  117.  
  118.             @echo off
  119.             d:
  120.             cd\doors\lord
  121.             lord -Dd:\tg\temp%1\door32.sys
  122.             cd\tg\temp%1
  123.  
  124.       Remember that you are not using a true native telnet server, so since you 
  125.       are using SIO/VMODEM, you have to pass the port to the door, not the hot 
  126.       telnet socket.  See DOOR32.SCR for more details. 
  127.  
  128.    5. Make a new menu entry in TG that looks something like this: 
  129.  
  130.             1. Long Description
  131.                "(L) LORD"
  132.             2. Short Description
  133.                "(L) LORD"
  134.             3. Keys       L
  135.             4. Command    -E - Execute Script
  136.             5. Options    "door32 d:\tg\runlord.cmd ~CN"
  137.             6. Access     "s10"
  138.             7. Display    ACS Dependant
  139.  
  140.  
  141.  That's all you need to do-telnet in remotely into your board and try it out. 
  142.  Do remember that you'll have to use -L to log in locally. so if you play the 
  143.  door through the BBS you'll need to modify the .CMD file accordingly. 
  144.  
  145.  
  146. ΓòÉΓòÉΓòÉ 3.3. Other OS/2 Native BBSes ΓòÉΓòÉΓòÉ
  147.  
  148. Other OS/2 Native BBS Configuration 
  149.  
  150. I'm not sure about other OS/2 native BBSes, but I believe that both EleBBS and 
  151. Mystic BBS can create and use DOOR32 doors just fine (from what I understand). 
  152. Synchronet/2 should also be able to do this, but you'll have to write a BAJA 
  153. script to create the DOOR32.SYS drop file. 
  154.  
  155. If you are able to get LORD/2 running on any of these BBS software packages, 
  156. please contact me and let me know your setup and how you did it.  I'll pass the 
  157. information along. 
  158.  
  159.  
  160. ΓòÉΓòÉΓòÉ 4. About the DOOR32 Format and the DOOR32 Scripts ΓòÉΓòÉΓòÉ
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ 4.1. The DOOR32 Format ΓòÉΓòÉΓòÉ
  164.  
  165. DOOR32.SYS Specification Revision 1 
  166.  
  167. This is the original DOOR32.SYS specification.  Please note that the URL given 
  168. in the bottom of this document does not work anymore. 
  169.  
  170.  .--------------------------------------------------------------------------.
  171.  | DOOR32 Revision 1 Specifications                 Updated: Feb 23rd, 2001 |
  172.  `--------------------------------------------------------------------------'
  173.  
  174.   What is Door32?
  175.   ---------------
  176.  
  177.   Door32 is a standard text-based drop file designed to take advantage of
  178.   32-bit operating systems.  Supporting handle inheritance, it will allow
  179.   for doors to work under multiple platforms and over both serial and
  180.   socket (telnet) connections.
  181.  
  182.   Programming Door32 Doors
  183.   ------------------------
  184.   There are several freeware door libraries which support Door32 although
  185.   most if not all of them are for Pascal at this time.  These libraries are
  186.   able to compile doors for DOS, Windows, OS/2, and Linux.
  187.  
  188.   I personally suggest the D32 library which is freeware and comes with
  189.   source code.  It can compile doors for DOS, Windows, OS/2 and Linux using
  190.   various Pascal compilers.  There are other great door libraries as well,
  191.   so give them all a try!
  192.  
  193.   Testing Door32 Support in BBS Software
  194.   --------------------------------------
  195.   Included in the Door32 specification archive is a Win32 executable by the
  196.   name of SAMPLE.EXE.  This is a very simple Door32 compatible door compiled
  197.   with the Pascal library mentioned above.  BBS authors may find this
  198.   program useful for testing their Door32 support.
  199.  
  200.   Notes about Door32 Programming
  201.   ------------------------------
  202.   At this point, there seems to be two things which need to be kept
  203.   in mind when doing Door32 programming:
  204.  
  205.      1. Under Linux or any operating system with case sensitive file names,
  206.         the Door32 drop file (DOOR32.SYS) will be created with all lower
  207.         cased lettering. IE:  door32.sys
  208.  
  209.      2. There appears to be a bug in the Win32 programming API (ie, a bug in
  210.         Windows) which prevents Door32 programs from running from a batch
  211.         file.  This means that the doors have to be executed directly from
  212.         the software.  Instead of running MYDOOR.BAT which eventually
  213.         executes MYDOOR.EXE, you must run MYDOOR.EXE directly.  This problem
  214.         has said to have been fixed in Windows NT, but still exists under
  215.         the Windows 9x platforms.
  216.  
  217.         What does this mean to BBS authors?  Not much.
  218.  
  219.         What does this mean to DOOR authors?  Maybe some changes...
  220.  
  221.         Because Door32 doors must be executed directly, there is a good
  222.         chance that the current directory will NOT be the directory that
  223.         your door executable is stored.  When porting an old DOS door,
  224.         the door might assume that the system is in the same directory
  225.         as the .EXE when loading data files.  Because of this, it is
  226.         recommended that you have your Door switch to the directory where
  227.         the door .EXE is located, or read that directory and use it when
  228.         accessing door related files.  In Pascal, this is a sample of
  229.         getting the directory where the door .EXE is found:
  230.  
  231.         Function ProgPath : String;
  232.         Var
  233.           Dir  : DirStr;
  234.           Name : NameStr;
  235.           Ext  : ExtStr;
  236.         Begin
  237.           FSplit (ParamStr(0), Dir, Name, Ext);
  238.           ProgPath := Dir + '\';
  239.         End;
  240.  
  241.         The above example will return the path where your door is located.
  242.         Some door libraries might already switch to the directory of the
  243.         executable, so you may not have to worry about it.
  244.  
  245.   The DOOR32.SYS Drop file
  246.   ------------------------
  247.  
  248.   Below is the final Revision 1 version of DOOR32.SYS.  It is a straight
  249.   DOS-style text file in all lower cased letters under operating systems
  250.   with case sensitive file systems:
  251.  
  252. [cut here]-------------------------------------------------------------------
  253.  
  254. 0                            Line 1 : Comm type (0=local, 1=serial, 2=telnet)
  255. 0                            Line 2 : Comm or socket handle
  256. 38400                        Line 3 : Baud rate
  257. Mystic 1.07                  Line 4 : BBSID (software name and version)
  258. 1                            Line 5 : User record position (1-based)
  259. James Coyle                  Line 6 : User's real name
  260. g00r00                       Line 7 : User's handle/alias
  261. 255                          Line 8 : User's security level
  262. 58                           Line 9 : User's time left (in minutes)
  263. 1                            Line 10: Emulation *See Below
  264. 1                            Line 11: Current node number
  265.  
  266. [cut here]-------------------------------------------------------------------
  267.  
  268.  * The following are values we've predefined for the emulation:
  269.  
  270.  0 = Ascii
  271.  1 = Ansi
  272.  2 = Avatar
  273.  3 = RIP
  274.  4 = Max Graphics
  275.  
  276.  Avatar, RIP, and Max Graphics all have ANSI fallback support, so most door
  277.  libraries that don't support those emulations can just use ANSI if emulation
  278.  2, 3, or 4 is encountered.
  279.  
  280.  Conclusion
  281.  ----------
  282.  
  283.  Thats it for the Revision 1 specifications of DOOR32.SYS.  You can find the
  284.  latest information at the official Door32 web page:
  285.  
  286.     http://www.mysticbbs.com/door32
  287.  
  288.  You can e-mail mysticbbs@geocities.com for any questions or suggestions
  289.  relating to Door32 or post a message in the FidoNet DOORGAMES echo
  290.  
  291.  
  292. ΓòÉΓòÉΓòÉ 4.2. DOOR32.MEC (Maximus/2) ΓòÉΓòÉΓòÉ
  293.  
  294. Maximus/2 DOOR32.MEC
  295.  
  296. This is the DOOR32.MEC file that I wrote for Maximus/2-it's included in this 
  297. archive, but I put it in here in case you need to reference it.  See "The 
  298. DOOR32 Format" for more information about the actual format and fields 
  299. required. 
  300.  
  301. [comment DOOR32.SYS MECCA written by Sean Dennis
  302.          Last updated 7 April 2006]
  303. [delete]d:\max\node.k\door32.sys
  304. [open]d:\max\node.k\door32.sys
  305. [write]1[comment Comm type (0=local, 1=serial, 2=telnet)]
  306. [write]%P[comment Comm or socket handle]
  307. [write]%b[comment Baud rate]
  308. [write]Maximus/2 v3.01[comment BBSID (software name and version)]
  309. [write]%u[comment User record position (1-based)]
  310. [write]%Z[comment User's real name]
  311. [write]%r[comment User's handle/alias]
  312. [write]%o[comment User's security level - that is the letter O]
  313. [write]%t[comment User's time left (in minutes)]
  314. [write]%g[comment Emulation 0=ASCII/TTY 1=ANSI 2=AVATAR]
  315. [write]%k[comment Current node number]
  316.  
  317.  
  318. ΓòÉΓòÉΓòÉ 4.3. DOOR32.SCR (Telegard/2) ΓòÉΓòÉΓòÉ
  319.  
  320. Telegard/2 DOOR32.SCR File 
  321.  
  322. I wrote this SCR file quite some time ago when I was experimenting with writing 
  323. my own OS/2-native BBS doors.  This was my first attempt and I managed to get 
  324. it right. 
  325.  
  326. ; DOOR32.SYS script written by Sean Dennis for Telegard/2
  327. ; hausmaus@darktech.org - 1:18/200@Fidonet
  328. ; Written on 12 October 2004 at 2035 CDT
  329. ;
  330. ; This is public domain.  However, I wouldn't suggest changing
  331. ; anything except the "D:\TG" part for it to work. :)
  332. ;
  333. ; This works here for me-I hope it works for you!
  334. ;
  335. ; Usage inside TG/2:
  336. ;4. Command    -E - Execute Script
  337. ;5. Options    "door32 d:\tg\doorbat\oracle.cmd ~CN"
  338. ;
  339. ;I pass the node number to the batch file for my multinode
  340. ;setup I run.
  341. ;
  342. VARIABLE TEMP STRING
  343. VARIABLE BBSDIR STRING "D:\TG\TEMP~CN\"
  344. FILECREATE DOOR32.SYS
  345. ; Comm type (0=local, 1=serial, 2=telnet)
  346. ; ALWAYS KEEP THIS AT 1.  Remember, if you're using SIO/VMODEM,
  347. ; you're using com ports, NOT telnet sockets.  That's only under
  348. ; Win32.  I'd recommend using the door's -L command line if you
  349. ; are going to run it locally under the BBS.
  350. FILEPUT "1"
  351. ; Comm or socket handle
  352. FILEPUT "~2P"
  353. ; Baud rate
  354. FILEPUT "~CB"
  355. ; BBSID (software name and version)
  356. FILEPUT "Telegard/2 ~SV"
  357. ; User record position (1-based)
  358. ; NOTE: I think TG uses 0-based record positions (it always
  359. ; reports mine as 0 as the sysop), so if you use this, be sure
  360. ; to increment the number by one.
  361. FILEPUT "~UN"
  362. ; User's real name
  363. FILEPUT "~UR"
  364. ; User's handle/alias
  365. FILEPUT "~UH"
  366. ; User's security level
  367. FILEPUT "~US"
  368. ; User's time left (in minutes)
  369. FILEPUT "~CM"
  370. ; Emulation *See Below
  371. FILEPUT "~UW"
  372. ; Current node number
  373. FILEPUT "~CN"
  374. FILECLOSE
  375. MENU D-@*@
  376.  
  377. ;* The following are values we've predefined for the emulation:
  378. ;
  379. ; 0 = Ascii
  380. ; 1 = Ansi
  381. ; 2 = Avatar
  382. ; 3 = RIP
  383. ; 4 = Max Graphics
  384. ;
  385. ; Avatar, RIP, and Max Graphics all have ANSI fallback support, so most door
  386. ; libraries that don't support those emulations can just use ANSI if emulation
  387. ; 2, 3, or 4 is encountered.
  388.  
  389.  
  390. ΓòÉΓòÉΓòÉ 5. Contacting the LORD Author ΓòÉΓòÉΓòÉ
  391.  
  392. Contacting the LORD Author 
  393. Michael when he's not staring at a monitor 
  394.  
  395. You can contact Michael Preslar by the following: 
  396.  
  397.      Email: mike@lordlegacy.com 
  398.  
  399.      Netmail: 1:275/112@Fidonet 
  400.  
  401.      WWW: http://lord.lordlegacy.com 
  402.  
  403.      Online forums: http://lord.lordlegacy.com/phorum 
  404.  
  405.  If you want to get the latest LORD/2 binaries, simply email Mike with the 
  406.  subject of "LORD/2 Binaries Request". 
  407.  
  408.  
  409. ΓòÉΓòÉΓòÉ 6. About the LORDP32 Author ΓòÉΓòÉΓòÉ
  410.  
  411. About the LORDP32 Author 
  412. Sean with his cat, Tigger 
  413.  
  414. I've been running a BBS under OS/2 since 1998.  I'm glad that Michael was 
  415. finally able to get an OS/2 native version of LORD for those of us who choose 
  416. to go our own way with our BBSes.  I also write my own line of BBS doors and 
  417. sysop utilities called Cheepware. I run Maximus/2 v3.01 under OS/2 Warp 4.52. 
  418.  
  419. If you'd like to contact me, here's how: 
  420.  
  421.      Netmail: 1:18/200@Fidonet 
  422.  
  423.      Email: sean@outpostbbs.net 
  424.  
  425.      WWW: http://outpostbbs.net 
  426.  
  427.  I hope you find this useful and LORD even more enjoyable now that there is a 
  428.  native OS/2 version. 
  429.  
  430.  -- Sean Dennis