megazeux.doc 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801
  1. MegaZeux ver 2.51 source -
  2. Copyright (C) 1996 by Greg Janson
  3. Copyright (C) 1998 by Matthew D. Williams
  4. REQUIREMENTS:
  5. IBM PC (286 or higher) compatible computer
  6. 640K RAM
  7. EGA or higher display adapter
  8. SoundBlaster/PAS-16/GUS sound card optional
  9. Mouse optional
  10. Dos 2.1 or greater
  11. Hard drive w/at least 5 megabytes free
  12. Internet: dbwilli@scsn.net
  13. WWW: http://www.scsn.net/users/dbwilli/
  14. This game package may be copied or distributed according to the
  15. terms and conditions stated in GNUGPL.DOC.
  16. MegaZeux --- Table of Contents
  17. Section
  18. I. License Agreement and Support
  19. II. Installing and Starting the Program
  20. III. Overview of MegaZeux
  21. IV. Controls
  22. V. Advanced Play Info, Tips
  23. VI. The World Editor
  24. VII. General Editing Tips
  25. VIII. Robots- What They Are and How to Use Them
  26. IX. FREQUENTLY ASKED QUESTIONS
  27. X. Command Line Options
  28. XI. EMS Memory/Boot Disk Tips
  29. XII. Known Bugs and Quirks
  30. XIII. Thanks, Acknowledgements, and Miscellaneous
  31. I. LICENSE AGREEMENT AND SUPPORT
  32. --- LICENSE ---
  33. This program is free software; you can redistribute it and/or
  34. modify it under the terms of the GNU General Public License as
  35. published by the Free Software Foundation; either version 2 of
  36. the License, or (at your option) any later version.
  37. This program is distributed in the hope that it will be useful,
  38. but WITHOUT ANY WARRANTY; without even the implied warranty of
  39. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  40. General Public License for more details.
  41. You should have received a copy of the GNU General Public License
  42. (GNUGPL.DOC) along with this program; if not, write to the Free Software
  43. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  44. --- SUPPORT ---
  45. This source code is supplied as is. The current copyright holder is not
  46. required in any way to assist anyone who chooses to modify this code.
  47. However, the current copyright holder can be reached via email:
  48. Matt Williams
  49. dbwilli@scsn.net
  50. And via the World Wide Web:
  51. http://www.scsn.net/users/dbwilli/
  52. II. INSTALLING AND STARTING THE PROGRAM
  53. It is recommended that you install MegaZeux in its own sub-directory
  54. on your hard disk. Do NOT run the program directly from a distribution
  55. disk, as disks sometimes fail. Always make a copy and run the program
  56. from it!
  57. To install the registered version of MegaZeux, simply change to the proper
  58. drive (usually A: or B:) after inserting the installation disk. Type
  59. INSTALL and select the program to install. A recommended directory is
  60. MEGAZEUX. Then you must wait as the program is unarchived and copied to
  61. the given directory.
  62. You should always use INSTALL to install registered products from Software
  63. Visions, as they are in archived form.
  64. Once the program is installed, you can change to that sub-directory at
  65. any time and run the program.
  66. MegaZeux is started by typing
  67. MEGAZEUX
  68. You will then be prompted for an output device to use for all digitized
  69. music and sound. If you do not pick PC Speaker, you will then be prompted
  70. for whether you wish PC Speaker sound IN ADDITION to digitized music and
  71. sound. Then, if you did not pick No Sound for digitized output, you will
  72. be prompted to pick a mixing rate for digitized music. Lower numbers are
  73. more staticy and may distort percussion sounds, but higher numbers require
  74. more processor power. The high end numbers will slow down the game (OK on
  75. a 386 or 486) or even stop it on a 286 or very slow 386. Experiment for
  76. the best compromise.
  77. You will then be whisked to the title screen for the first included game,
  78. Caverns of Zeux. Press P to play, or L to load another world. Press F1
  79. for comprehensive help AT ANY TIME. Help is context sensitive, and much
  80. more comprehensive than this document.
  81. III. Overview of MegaZeux
  82. Welcome to MegaZeux!
  83. As you may already know, MegaZeux is a game system which
  84. allows you to play almost limitless worlds in EGA graphics
  85. and with beautiful digitized music and sound. MegaZeux comes
  86. with worlds, and new worlds are being uploaded every day to
  87. major on-line services such as America Online. But the most
  88. fabulous feature of MegaZeux is the World Editor.
  89. Using the World Editor, ANYONE can create the world of their
  90. dreams. Make it as simple or complex, as easy or difficult,
  91. as long or short as you please. And we aren't just talking
  92. about worlds made up of petty, pre-programmed enemies and
  93. objects. MegaZeux has it's own, easy to use PROGRAMMING
  94. LANGUAGE called Robotic that allows you to create enemies,
  95. objects, and worlds that do almost anything you desire.
  96. For the new user, I recommend you play Caverns, the first
  97. included game, to get the feel of MegaZeux. You may wish
  98. to read the section entitled "Controls" to learn how
  99. to play MegaZeux.
  100. Once you have the feel for the game, however, feel free
  101. to dive into the World Editor and get messy! You should
  102. probably read the section entitled "The World Editor"
  103. first.
  104. IV. Controls
  105. MegaZeux is very easy to play, once you understand the
  106. simple control system. After that, experimentation will
  107. prove to be the best teacher, although you can discover
  108. everything within Help as well.
  109. To start a game, press 'P' during the title screen. To
  110. select another world, press 'L' during the title screen.
  111. Use ESC during the title screen to exit to DOS, or during
  112. the game to return to the title screen. You know it is
  113. the title screen if a message on the bottom says "Press
  114. F1 for help, Enter for menu". Enter will bring up a menu
  115. of options on the title screen, also.
  116. Your character is represented by a little smiley face
  117. in the included game(s). In other games, he may be
  118. a stick person, animal, spaceship, or other entity.
  119. Usually it is obvious where you are, since you are usually
  120. colored to stand out.
  121. To move your character, press one of the arrow keys on
  122. the keyboard or numeric keypad. If you hold it down, you
  123. will continue to move in that direction.
  124. To interact with objects and other characters, you usually
  125. must stand next to them and touch them. This basically
  126. means push against them using the arrow keys. Watch out
  127. for enemies and evil creatures, who will often hurt you
  128. when you touch them.
  129. To stop enemies, you will usually have some type of weapon,
  130. often with limited ammunition. The actual weapon depends
  131. upon the game, and may even differ from game to game, but
  132. by default you have a small pistol. To fire your weapon,
  133. hold Space and press an arrow key. You can also hold the
  134. arrow key and press Space. You must press both keys TOGETHER.
  135. To see your current status, such as Health points, Coins,
  136. Gems, Ammunition, and Keys, press Enter. This will bring up
  137. a box containing all your stats, as well as a menu detailing
  138. other options you have available.
  139. In some games, you may encounter bombs. (as usual, push
  140. against them to pick them up.) To use a bomb, press the
  141. Delete key. Then run! The bomb will not actually burn its
  142. fuse until you step away from it. There are two styles of
  143. bomb- Low strength and High strength. You can tell which
  144. kind you pick up by the pitch of the sound it makes. To
  145. change which TYPE of bomb you are using, press Insert. A
  146. message at the bottom of the screen will inform you of
  147. your new selection.
  148. Other games may have other controls, such as 'S' to cast
  149. a spell, or 'J' to jump, but they will be detailed within
  150. the game. Some basic play tips:
  151. * Make sure you visit every screen. To get to other screens,
  152. enter passageways, stairs, caves, or doors. (by pushing
  153. against them.) You can also often reach another screen
  154. by pushing against the edge of the screen, leading to an
  155. adjacent screen.
  156. * Touch everything! Even things of seemingly little value may
  157. prove worthy of your attention. If it kills you, then...
  158. well... hope you saved.
  159. * Save your game! It is rather simple- Press F3 to save your
  160. game to disk at the EXACT point you are at. Press F4 to
  161. reload a game off of disk. You can use F9 and F10 to
  162. quick-save and quick-load, which work on the last game
  163. you saved. Remember to save often- If something kills you,
  164. you'll want a game to go back to.
  165. * Collect supplies! Make sure you grab every coin, gem,
  166. ammo dump, bomb, chest, and pouch you see! You will often
  167. be in want of supplies, so don't push things.
  168. * Remember how things work. Most things in MegaZeux have
  169. patterns, and the same object will usually do the same
  170. thing all the time. (although two objects may look alike
  171. and not really be the same thing)
  172. V. Advanced Play Info, Tips
  173. You've tried some MegaZeux worlds, and they are fun, but you
  174. have the feeling you are missing something. This is it- the
  175. remaining knowledge you might need to survive in a given world.
  176. First, let me warn you that many worlds you get from public
  177. services or BBSes may not be of a very good quality. They may
  178. be unfair, boring, have bugs, and/or not give proper
  179. instructions. My advice is to E-Mail the author and tell him
  180. what you think of poor quality MegaZeux games. There is no
  181. problem in MAKING them, but PLEASE don't upload them. Don't
  182. let a few losers ruin the fun.
  183. Now to cover the game keys, in detail-
  184. F1- Help
  185. Use this at any time to bring up help relating to the current
  186. situation. Within the game, you will go to the Controls
  187. section.
  188. Enter- Menu/status
  189. Use this to bring up a menu of options and a list of your
  190. current stats, such as Score, Gems, etc.
  191. ESC- Exit to title
  192. This will quit the current game and return to it's title
  193. screen.
  194. F2- Settings
  195. This will bring up a dialog box where you can change the
  196. current game settings, such as Game Speed, Music, and
  197. Sound. To speed up the game, lower the speed and/or turn
  198. music off. A speed of 1 will cause flicker in most machines,
  199. so it is not recommended unless it is your only option.
  200. F3- Save game
  201. This will prompt you for a filename, then save the exact
  202. state of your current game. Some games may not allow saving
  203. on some or all of its screens. This lets you quit your game
  204. in the middle or take precautions against unknown dangers.
  205. F4- Restore game
  206. This will let you select a saved game from a list of filenames.
  207. The game will then be reloaded from the same point you left off
  208. at.
  209. F5 or Insert- Toggle bomb type
  210. This will switch your current bomb type between High Strength
  211. and Low Strength.
  212. F6- Debug mode
  213. This will bring up a small box in the lower left corner of the
  214. screen, detailing your position and the current memory
  215. situation. It is generally only necessary when testing and
  216. fixing your own games. Press F6 again to turn the box off. The
  217. debug menu, when active, will also increase the sensitivity to
  218. module and SAM problems. Normally during the game, no errors
  219. relating to modules and SAMs will be shown. With the debug menu on,
  220. errors loading modules and SAMs and out of memory conditions will
  221. be shown.
  222. F9- Quicksave
  223. This will save the game, like F3, but to the last filename you
  224. used, without prompting you for a filename. The old file will
  225. be overwritten. If no game has been saved since MegaZeux was
  226. started, a filename of SAVED.SAV will be used.
  227. F10- Quickload
  228. This will reload the last game saved using F3 or F9. If no
  229. game has been saved since MegaZeux was started, a filename of
  230. SAVED.SAV will be used.
  231. Arrows- Move
  232. The arrow keys will move your character and allow him to
  233. interact with most objects.
  234. Space- Shoot
  235. Use this key in conjunction with an arrow key to fire your
  236. weapon in the selected direction. Weapons vary from world to
  237. world.
  238. Delete- Bomb
  239. This will drop a bomb of the current type BENEATH the player.
  240. Move out of the way to see it, then run before it explodes!
  241. The following keys are active at the title screen-
  242. F1- Help (see above)
  243. Enter- Menu
  244. This is similar to Enter within the game. However, there is
  245. no status screen.
  246. ESC- Exit to DOS
  247. Pressing ESC will exit MegaZeux, returning to the DOS prompt
  248. or other operating system.
  249. F2 or S- Settings (see above)
  250. F3 or L- Load world
  251. This will allow you to load up the title screen of any MegaZeux
  252. world. A list of choices will be presented to you to select
  253. from. After the world is loaded, you may watch the title
  254. screen, then press 'P' to play.
  255. F4 or R- Restore game (see above)
  256. F5 or P- Play game
  257. This will stop the title screen and actually begin game play.
  258. F6- Debug menu (see above)
  259. F8 or E- World editor
  260. This will quit the gaming portion of MegaZeux and enter the
  261. integrated World Editor. For detailed info on using the World
  262. Editor, view the appropriate help sections.
  263. F10- Quickload (see above)
  264. We'll close this section with some more playing tips, some
  265. general hints and others specific to certain sections of
  266. Caverns of Zeux, the first included game.
  267. * Don't take anything for granted. If it looks like a spike,
  268. it PROBABLY is. PROBABLY. Although it is rare that these
  269. types of puzzles must be solved to complete a game, there
  270. are often bonuses, hidden rooms, etc. behind illusions.
  271. * Don't trust anyone. All characters in a game, (including
  272. yourself) have the potential to lie, cheat, and backstab.
  273. * Try things twice. Sometimes objects respond differently a
  274. second time. If you get a new treasure, go talk to all
  275. the citizens- maybe one of them will say something new!
  276. * Caverns hint- (DON'T READ UNLESS YOU ARE STUCK!) Many people
  277. often get stuck early in the game, after a couple of bosses.
  278. If you have the three amulets, did you talk to the dwarf in
  279. town who wants them? Make sure you change back to a dwarf
  280. by talking to the spirit. Later make sure to lavawalk across
  281. the lava on the left of the room where you got the three
  282. amulets.
  283. VI. The World Editor
  284. Ready to start creating your own worlds? Then let's get
  285. started! This section is a short editor tutorial, it will teach
  286. you the basics of creating your own worlds.
  287. To get into the editor, press E from the title screen. You will
  288. be presented with a blank board with a small menu at the bottom.
  289. You can use PgUp and PgDn to change the currently shown menu,
  290. and you will be presented with various keys and options. The
  291. mouse also works here. Feel free to fool around with these
  292. various options. Press Alt+R to restart and clear everything.
  293. For your first world, you should start simple. The screen you
  294. begin on is your title screen, so pick a simple name for your
  295. game, such as "Mike's World". Move the flashing cursor down a
  296. few lines and over a few spaces, using the arrow keys. Press C
  297. and use the arrow keys to select an appropriate color. Press
  298. Enter to select this color. Now press F2 to write Text. Type
  299. in the name of your world, and then press F2 to stop writing
  300. text. This screen will be your title screen.
  301. Now you need to create the first board, or location, of your
  302. game. Press A to add a board, then type in a short description
  303. of the board, such as "Starting Board". Press Enter to go to
  304. this new board.
  305. Now you are free to doodle around. Use C to change the active
  306. color. Use F3 through F9 to bring up menus of items, terrains,
  307. and creatures. Selecting one with the arrows and Enter will
  308. allow you to place it using arrow keys and space.
  309. For example, press F3 for terrains, and select Line. (This is
  310. a form of wall.) Now move around, placing walls. To ease this,
  311. you can press Tab to toggle draw mode. When draw mode is active,
  312. every move of the cursor will place the current item/color. The
  313. current item and color is shown on the top line of the menu.
  314. Try to create a pleasing-looking screen, with walls, items, and
  315. creatures. Some items will require that you set settings to
  316. determine their behavior. To place the player's starting
  317. position, move the cursor to the destination, press F10, and
  318. select Player.
  319. When you are done, press G to go to the Global Info screen. TAB
  320. to the Next button and press Enter. You will now be highlighting
  321. the option "Starting Board". Press Enter, and select the
  322. starting board (NOT the title screen) from the list and press
  323. Enter. Then TAB to OK and press Enter. This tells MegaZeux which
  324. board you want the game to start on.
  325. You could now press Alt+N to select a module (music) file for the
  326. board, if you wished. Then press S to save the world, and type in a
  327. filename of eight or less characters. (The extension of .MZX
  328. will automatically be added.) Press Enter twice to save. Press
  329. ESC to exit the editor, and now you can play your game! You can
  330. use L to reload your world in the editor to make changes, if
  331. necessary. See General Editing Tips for more advanced editing
  332. info.
  333. VII. General Editing Tips
  334. The following is a list of important editing tips. They assume
  335. you are familiar with MegaZeux's dialog box system, and that
  336. you can navigate the editor's menus.
  337. Linking Boards
  338. One-board games get boring REAL fast. There are two ways to
  339. connect multiple boards. The first way is to add stairs, doors,
  340. and whirlpools using the Transport (F7) menu. Then you select a
  341. destination board. The destination board should contain a
  342. similar transport, leading back. The two entrances will now lead
  343. to each other.
  344. The other method of connecting boards is with X, the Board Exits
  345. dialog. Here, you can select boards that you will reach if you
  346. walk off of the screen in a given direction. The destination
  347. board shouldn't have anything in the way, and will not
  348. automatically lead back- You must set the exit on that board
  349. too.
  350. To add boards, press A, or select (new board) from a board list.
  351. To switch to other boards, use B.
  352. Board Sizes
  353. You can change the maximum size, and the view position, of a
  354. board, with Alt+P. Here you can move and re-size the view, or
  355. center it on-screen.
  356. You can also change the actual size of the board, as well as
  357. the maximum, overall size. The lowermost radio control
  358. determines the MAXIMUM size possible for the board, one of
  359. 60x166, 80x125, 100x100, 200x50, or 400x25. The Virtual size
  360. is the ACTUAL size of the board, which is always equal to or
  361. less than the MAXIMUM size. Example- If you wanted a board
  362. that was 180 wide and 40 high, you would select a MAXIMUM
  363. size of 200x50, then set the Virtual size to 180x40.
  364. Note that reducing the size of a board will permanently
  365. destroy anything outside the new limits.
  366. Other Important Editing Keys
  367. You can use Insert to "grab" the object beneath the cursor, or
  368. Enter to edit it and then grab it as well. Use P to modify the
  369. current object's settings. Use Alt+N to select music for the
  370. current board, or turn the music off if it is already selected.
  371. Use Alt+Z to clear the current board entirely. You can edit
  372. important Board Options with I, and important Global (world)
  373. Options with G.
  374. VIII. Robots- What They Are and How to Use Them
  375. Robots are the heart and soul of MegaZeux. Anything you could
  376. want to do in MegaZeux, anything you see done in a MegaZeux
  377. game, many things you didn't know were possible, can be done
  378. with MegaZeux's Robots.
  379. Robots are programmed in their own programming language, called
  380. Robotic. Robotic is a fairly simple language to learn, somewhere
  381. along the lines of BASIC, although a bit more complex. If you've
  382. ever used Epic Megagame's ZZT, Robotic is a bit more complex
  383. than ZZT-OOP, although it is similar and more logical in style
  384. and syntax.
  385. To place a Robot in the editor, press F10 and select Robot, or
  386. Pushable Robot if you want things to be able to push the Robot.
  387. Then name the Robot, and select a character to represent it. Now
  388. you are brought to the Robot editor, where you can program the
  389. Robot in Robotic.
  390. Complete info and a tutorial on Robotic is included in the online
  391. Help.
  392. IX. FREQUENTLY ASKED QUESTIONS
  393. The following is a list of questions that I have received
  394. through mail or E-mail about MegaZeux repetitively.
  395. Q: My robot can't change it's/the player's characters! I
  396. use CHAR "A" but it turns invisible!
  397. A: Use CHAR 'A' instead. You MUST use single quotes
  398. (apostrophes) or it will use the value of the COUNTER
  399. A which is probably 0.
  400. Q: Can I distribute a world I made with MegaZeux? Is it
  401. legal? Must I/Can I include MegaZeux with it? Can they
  402. be shareware worlds?
  403. A: Of course you can distribute your worlds! That is what
  404. MegaZeux is for! Please refrain from uploading worlds
  405. that you made as a novice user, if they contain only
  406. built-in enemies, items, and no plot/etc. People will
  407. only yell at you. Get creative and use Robots! Please
  408. include any SAM, MOD, and CHR files with the games,
  409. as well as a short TXT description file if necessary.
  410. Don't include MegaZeux, but make sure MegaZeux itself
  411. is available on any BBS or online system that you
  412. upload worlds to. (MegaZeux is available on AOL) Your
  413. worlds can be freeware, public domain, or shareware,
  414. whichever you prefer.
  415. Q: Can I use the music from Caverns in my games? How about
  416. the music from the registered games? How about the SAM
  417. files?
  418. A: I would prefer it if you did not use Caverns music in
  419. any games you distribute, because most people have
  420. heard it and it is getting old. The music from the
  421. registered games is illegal to distribute. The SAM
  422. files are public domain and may be used as you please.
  423. Q: Where can I get module files?
  424. A: If you can't make them, search public BBSes and online
  425. services for public domain ones. AOL has a large MOD/S3M
  426. library, as do many CD-ROM collections. Or employ a
  427. friend to do it for you. I myself (Greg Janson) am
  428. not available to create module files unless I am being
  429. paid well for my time.
  430. Q: What is some good software to create module files?
  431. A: For modules, Fast Tracker II by Triton is fairly good, but
  432. you have to avoid using the XM features. ScreamTracker 3.0
  433. is good for making S3M files.
  434. Q: How do I make SAM files?
  435. A: There are three easy ways to create SAM files. First,
  436. you get recording software, a sound card, and a mike.
  437. Hook 'em all up (read the instructions) and go for it.
  438. Second, you can download them or get them from module
  439. files or other games. Third, you can take existing files
  440. and change them with effects like echo. Blaster Master
  441. is a good piece of software to handle numbers one and
  442. three.
  443. Q: But I can only find software to make WAVs! (or VOCs)
  444. A: There is a nice small program called CVT2SAM which can
  445. convert most WAVs and VOCs to SAMs. I believe it is in
  446. the public domain. It is available on AOL.
  447. Q: The TELEPORT PLAYER command doesn't work!
  448. A: It does now. That was a small (er... big) bug in version
  449. 1.02, which was corrected in version 1.03 and 2.51.
  450. Q: Is the world design contest still going?
  451. A: Until you see a Best of MegaZeux series OR the calendar
  452. reaches 1-22-97 without sufficient entries, the contest
  453. will continue. So far I've received only one board,
  454. which wasn't even acceptable. However, I've received
  455. E-mail from several interested parties, so the contest
  456. continues. See CONTEST.TXT for details.
  457. Q: I need more than 256 characters!
  458. A: Then you'll need to carefully utilize the Robot command
  459. LOAD CHAR SET and ration your characters carefully. The
  460. limit of 256 is a hardware limit and cannot easily be
  461. worked around.
  462. X. Command Line Options
  463. The following command line options are available for use when
  464. starting MegaZeux. To use them, type them in after MEGAZEUX
  465. at the DOS prompt. Separate all options with spaces.
  466. -?
  467. Bring up command line option help screen.
  468. -lxxxxxxxx.MZX
  469. Loads up xxxxxxxx.MZX at start up. (the .MZX is optional)
  470. -nomouse
  471. Don't activate the mouse, even if one is present. Use if the
  472. mouse gets in the way or MegaZeux seems to think you have a
  473. mouse when you don't.
  474. -noems
  475. Don't use any EMS memory. Use if MegaZeux's use of EMS memory
  476. is causing a problem. Note that with this option, you will
  477. probably not have enough memory for module and SAM files.
  478. -ega
  479. Use EGA mode even on VGA or higher. This only affects the
  480. granularity of palette fades and color changes.
  481. -keyb2
  482. Use another style of keyboard handler. Use if your keyboard is
  483. locking up or otherwise causing problems.
  484. ** Sound Card Options
  485. -port###
  486. -irq#
  487. -dma#
  488. Allows you to specify the settings for your sound card. -port
  489. sets the base port and must be followed by a hexadecimal number
  490. such as 220. -irq sets the IRQ line number, and should be
  491. followed by a single digit such as 7. -dma sets the DMA number
  492. and should be followed by a single digit such as 1. See your
  493. sound card manual for details. These options are only neccesary
  494. if autodetection fails. An example of a command line for the
  495. default SoundBlaster settings-
  496. MEGAZEUX -port220 -irq7 -dma1
  497. XI. EMS Memory/Boot Disk Tips
  498. MegaZeux makes extensive use of EMS and conventional (first
  499. 640k) memory. The more you have available, the better it will
  500. run.
  501. To have EMS memory available, you must have an EMS driver
  502. installed. Most EMS drivers also require an XMS/HIMEM driver
  503. loaded first. You will need lines similar to the following in
  504. your CONFIG.SYS to load HIMEM and an EMS driver, respectively-
  505. DEVICE=C:\DOS\HIMEM.SYS
  506. DEVICEHIGH=C:\DOS\EMM386.EXE 3072 H=160
  507. The 3072 tells DOS to reserve up to 3072K of memory (3
  508. megabytes) for EMS. Feel free to lower or raise this value,
  509. but a minimum of 2048K (2 megabytes) is recommended.
  510. It is also recommended that you load SmartDrive to run MegaZeux.
  511. SmartDrive is a disk-cache utility that is usually loaded,
  512. because it greatly speeds up repeat disk accesses. You probably
  513. already have a line such as SMARTDRV.EXE /X in your AUTOEXEC.BAT;
  514. if not, you should consider adding it somewhere after the PATH
  515. statement.
  516. To help free up conventional memory, you may need to create a
  517. boot disk. This is a common procedure for games that use less
  518. conventional setups (such as MegaZeux), and if a certain boot disk
  519. works for one game, it may work just fine for MegaZeux. However,
  520. you must remember to include HIMEM and an EMS driver, and include
  521. a mouse driver if you want your mouse to be available.
  522. To create a boot disk, stick a blank disk into your A: drive and
  523. type the following:
  524. FORMAT A: /S <enter>
  525. Answer Yes to all questions. Give the disk a label if you wish.
  526. Answer No to "Format another?" and then type:
  527. COPY CON A:CONFIG.SYS <enter>
  528. DEVICE=C:\DOS\HIMEM.SYS <enter>
  529. DEVICEHIGH=C:\DOS\EMM386.EXE 4096 H=160 <enter>
  530. DOS=HIGH <enter>
  531. <ctrl+z>
  532. COPY CON A:AUTOEXEC.BAT <enter>
  533. PATH C:\DOS;C:\WINDOWS <enter>
  534. SMARTDRV /X <enter>
  535. C:\MOUSE\MOUSE <enter>
  536. C: <enter>
  537. CD \MEGAZEUX <enter>
  538. MEGAZEUX <enter>
  539. <ctrl+z>
  540. The line to load the mouse driver is optional, and may vary on
  541. different computers. The drive and directory you have MegaZeux
  542. in may differ as well. Your windows and dos paths may differ.
  543. Once you've followed these instructions, you can insert the
  544. disk and reboot the computer to run MegaZeux. It is best if you
  545. get a computer-wise friend to help you, if you can't get the
  546. above to work.
  547. One note- most newer sound cards require drivers or other
  548. programs to be run before they can be used. Check your existing
  549. configuration files and/or manuals to find out what these
  550. commands are if you intend to use MegaZeux with a boot disk.
  551. XII. Known Bugs and Quirks
  552. Note that the graphics quirks are more likely to appear on laptops
  553. as their graphics cards are usually proprietary and may contain
  554. non-standard quirks.
  555. A. A couple of computers/graphics cards display MegaZeux in the
  556. "9-pixel-character" mode. This basically means that thin black
  557. lines appear between each column of most characters. This doesn't
  558. affect gameplay but can be annoying. Known offenders- Zenith
  559. Z-Note MX laptop.
  560. B. A couple computers/graphics cards may display characters with the
  561. bottom of every character stretched down a little (2 additional
  562. rows of pixels added). This does not affect gameplay but can be
  563. annoying. Known offenders- Sharp 8700 Laptop
  564. C. Certain SVGA cards display black as deep red. Again, this doesn't
  565. affect gameplay but can be annoying.
  566. D. The Global Robot's code has been reported to be trashed while
  567. music is on. (in the editor.) It happened very rarely and I cannot
  568. seem to reproduce or pinpoint the bug. It may be an isolated
  569. cause.
  570. E. Certain modules may play slightly off-tune.
  571. F. MegaZeux does not always run under certain Windows or Win95
  572. configurations, or if it does, sound does not work.
  573. If you have something to add here or might be able to help solve one
  574. of these quirks, drop me a line.
  575. XIII. THANKS, ACKNOWLEDGEMENTS, AND MISCELLANEOUS
  576. ** Credits and Acknowledgments **
  577. Programming and Overall Design by Gregory Janson
  578. Music/Sound code by Edward Schlunder
  579. Included Game Modules by Gregory Janson
  580. Included Music by Gregory Janson
  581. Beta Testing and Special thanks:
  582. Jason Albanese
  583. Alek Benedict
  584. Chris Bromley
  585. Christopher Christensen *
  586. Chris Cooper
  587. Carlos DaSilva
  588. Jacob Farmer
  589. Geoff Friesen *
  590. Tim Gallagher
  591. Themie Gouthas *
  592. Jamie Holub
  593. Jason Kim
  594. Dave Kirsch *
  595. Elbert Lim
  596. Joe McManis
  597. Vic Putz *
  598. Robin Rudge *
  599. Brian Schweitzer
  600. Allen Shirvanian
  601. Tim Sweeny (author of ZZT)
  602. Tony Vanvranken
  603. * = Thanks for the public domain code!
  604. AOL Beta Testers
  605. Compukid
  606. Shammydog
  607. DMcgee1008
  608. SpectreB1
  609. NL Aric
  610. JustJoshua
  611. SkreenNme
  612. MegaKev
  613. Herbie III
  614. Spider124
  615. - Originally by Greg Janson
  616. ZZT'er at heart
  617. - Modified by Matt Williams
  618. also a ZZT'er at heart
  619. on March 1, 1998