home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FK202.ZIP / V2DATA.EXE / 3RDPARTY.DOC next >
Encoding:
Text File  |  1996-08-02  |  5.1 KB  |  168 lines
  1. NOTE!!!!
  2. Many ways to customize Farmers and Kings are not shown in this file.  I have
  3. chosen to spend more time on informing programmers after I get through with
  4. the beta cycle.  Please check my web page for news.
  5. http://www.netsites.net/~guardian/fk.htm
  6.  
  7.  
  8. WARNING!!!
  9. You should get in touch with me before writing an IGM in case there are any
  10. upgrades or secrets you should know about.
  11.  
  12. Using the 3rdparty.exe file, it is simple to add a module to this game to 
  13. be reached by way of searching the forest.  
  14. If you are inclined in programming doors and would like to program a module
  15. sysops can add to this game, read on.  Otherwise, this file contains nothing.
  16. -------------------------------------------
  17. 3rdparty.exe
  18. -------------------------------------------
  19.  
  20. First in order to let FK know there is a 3rdparty module installed, you must
  21. use 3rdparty.exe.  It is a simple program that uses 3rdparty.dat file to
  22. store all modules.  To use 3rdparty.exe, enter these parameters in your
  23. install program:
  24.  
  25. 3rdparty [module name] [town location] [path/file to mod] [path to fk]
  26.  
  27. EXP:
  28. 3rdparty "Wishing well" hayward c:\fk\wish\wish.exe c:\fk
  29.  
  30. You will need to write an install program to find out where Farmers and Kings
  31. is located and perhaps to find out what town the sysop would prefer your
  32. module to be located in.  The name of the module can be up to 70 characters
  33. long.  If you need to put a space in the name, use quotation marks.
  34. Towns should be specified by the following:
  35.         Hayward
  36.         Den
  37.         Pomdirgunua
  38.         Burkshire
  39.  
  40. These are the only towns that have forests.  Please try to keep your type
  41. of modules correct on the town.  As in, don't put a Pirate's Treasure Hole
  42. in Pomdirgunua, or a carnival in Burkshire.
  43. As to the size and and extent of your module, it doesn't matter to me at all.
  44. You can program a whole game and add it on if you want to.
  45. FK does swap itself to EMS or disk, but does not exit completely.
  46.  
  47. -----------------------------------------
  48. FKDROP.DAT
  49. -----------------------------------------
  50.  
  51. When a 3rdparty module is spawned from Farmers and Kings, a drop file is
  52. created in the directory called fkdrop.dat.  It contains the following
  53. information:
  54. It is written in a C++ binary data sctructure listed below.
  55. * - can be edited by module
  56.  
  57. User's Alias *
  58. User's ANSI settings  1 for TRUE, 0 for FALSE
  59. User's Sex * M or F
  60. User's strength *  1-22
  61. User's dexterity * 1-22
  62. User's aim * 1-20
  63. User's experience * 1-60000
  64. User's Skill  1-25
  65. User's trainpts * specifies how many more times user can train
  66. User's current hit points * 1- totalhit
  67. User's total possible hit points * 1-220
  68. User's coins * 1-60000
  69. User's ammo * 1-40
  70. User's weapon ratings * values 1-15
  71. User's long-range weapon *
  72. User's short-range weapon *
  73. User's Armour *
  74. User's Shield
  75. User's food counts *
  76. horse 1,2 *
  77. dragon 1-10 *
  78. fur count 1-10 *
  79. turns left 1-1000 *
  80. hunger A,B,C,D *
  81. Thief level 1-20 *
  82. Kill count 1-60000 *
  83. Honor -30000 - 30000 *
  84. Companion name *
  85. Companion attack level 1-10 *
  86. Companion attack message *
  87. Comport
  88. IRQ
  89. Path to BBS drop file
  90.  
  91. *IMPORTANT:  Fkdrop.dat must be written back or not deleted. 
  92. The readable values must be read back unscrambled.
  93. Failare to do so could crash the game.
  94.  
  95. struct drop{
  96. char name[30];
  97. char sex;
  98. char ANSI;
  99. int str;
  100. int dex;
  101. int skill;
  102. int trainpts;
  103. unsigned int exp;
  104. int hitpts;
  105. int totalhit;
  106. unsigned int coins;
  107. char ws;
  108. char wl;
  109. char ar;
  110. char weaponshort[14];
  111. char weaponlong[10];
  112. int ammo;
  113. char armor[12];
  114. char shield[11];
  115. char fish;
  116. char skins;
  117. char meat;
  118. char bread;
  119. char horse;
  120. char dragon;
  121. char fur;
  122. int turns;
  123. char hunger;
  124. int aim;
  125. int thief;
  126. unsigned int kills;
  127. int honor;
  128. char compname[10];
  129. char compatt;
  130. char compa[50];
  131. int comport;
  132. int irq;
  133. char path[80];
  134. } d;
  135.  
  136. -------------------------------
  137. MULTI-NODE COMPATIBILITY
  138. -------------------------------
  139.  
  140.         If for any reason you need the node number of the game, it always
  141. passes the node number as the first arguement unless in local mode.  This
  142. could be useful if you wanted to read Farmers and King's node dat files.
  143.  
  144. -------------------------------
  145. LOCAL PLAY
  146. -------------------------------
  147.  
  148.         If Farmers and Kings is being played in local mode, it will pass a
  149. command-line parameter to your program of "l"  Use this to run your program
  150. in local mode.
  151.  
  152. -------------------------------
  153. Finally
  154. -------------------------------
  155.  
  156.         Well, that should get you started.  Feel free to read player.dat, for
  157. more information but please do not edit it in anyway.  If you would like to
  158. know more about how Farmers and Kings works or would like to know exactly
  159. how all variables are stored in Player.dat, feel free to call my bulletin
  160. board and ask.  If you program a module, I would love to see it, upload
  161. it to my bulletin board.  And if it is OK, I would like to see the source
  162. code.  If you have any questions, feel free to contact me at my Bulletin
  163. Board:
  164.                 The Stone Tower BBS    (PcBoard 15.21)
  165.                 (918) 478-4326
  166.                 14.4 bps
  167.                 Fidonet: 1:3813/307
  168.