Confusion: A Muddle interpreter

README 3.0KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. Confusion: A MDL interpreter
  2. (or, "How to Fit a Small Program into a Large Machine")
  3. For those poor souls still stuck in dawn of IF history, I present
  4. "Confusion" -- a MDL interpreter which works just well enough to play
  5. the original Zork all the way through. The original Zork isn't for the
  6. faint of heart, and neither is Confusion; it is only available in
  7. source form, with minimal instruction (which follows).
  8. Confusion is written in C++, though about 99% is pure C. To build it, you
  9. will need the Boehm-Demers-Weiser conservative garbage collector for
  10. C. <http://www.hpl.hp.com/personal/Hans_Boehm/gc/>
  11. Some Linux distros have this as a package, called "gc-dev" or
  12. similar. For the Mac, you'll need what is at this writing the very latest
  13. version (7.2alpha2), for Linux, 6.8 appears to work. For Windows... I
  14. recommend running Linux in a virtual machine. It might build under
  15. cygwin, but I wouldn't bet on it.
  16. Once you have the GC, a simple "make" will build the interpreter.
  17. The Zork sources, somewhat modified for the limitations of this
  18. interpreter, are available at
  19. <http://www.russotto.net/~mrussotto/confusion/mdlzork.tgz>
  20. To play Zork, unpack this directory, change directory to the new
  21. "mdlzork" directory", run the interpreter with the parameter "-r
  22. MDL/MADADV.SAVE" e.g. "../confusion-src/mdli -r MDL/MADADV.SAVE".
  23. You should be at the white house:
  24. $ ../confusion-src/mdli -r MDL/MADADV.SAVE
  25. This Zork created July 6, 2009.
  26. West of House
  27. This is an open field west of a white house, with a boarded front
  28. door.
  29. There is a small mailbox here.
  30. A rubber mat saying 'Welcome to Zork!' lies by the door.
  31. The HELP, DOC and INFO commands do not work, as I do not have those files.
  32. I have played Zork all the way through, however, I have made some
  33. changes to the intepreter since then, so I cannot guarantee success. If the
  34. interpreter crashes, let me know. (note that there are bugs in the
  35. game; if you get dumped to a MDL LISTEN prompt, this might not be an
  36. interpreter bug)
  37. If you modify the MDL sources, you can re-build the game by running
  38. the interpreter with no parameters in the mdlzork directory, and
  39. typing
  40. <FLOAD "run.mud">
  41. This will rebuild the MDL/MADADV.SAVE file and start the game.
  42. Confusion probably won't be developed further.
  43. Notable features not supported: proper SAVE/RESTORE (an incompatible but
  44. useful version is provided), GC-DUMP/GC-READ, interrupts, processes,
  45. overflow, compiled code.
  46. --
  47. Copyright 2009 Matthew T. Russotto
  48. You can redistribute and/or modify this file under the terms of the
  49. GNU General Public License as published by the Free Software
  50. Foundation, either version 3 of the License, or your option) any later
  51. version.
  52. This file is distributed in the hope that it will be useful, but
  53. WITHOUT ANY WARRANTY; without even the implied warranty of
  54. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  55. General Public License for more details.
  56. You should have received a copy of the GNU General Public License
  57. along with this program. If not, see <http://www.gnu.org/licenses/>.