[GPF]

Z2me - Z Machine 3, ZCode Interpreter for J2ME
Version 0.1.0
http://gpf.dcemu.co.uk


Copyright (c) 2004 Troy Davis
All Rights Reserved
Licensed under the The Artistic License

Credits:
===================
Z2me is based in part on the Zplet ZCode interpreter by Matthew T. Russotto
More information may be found at http://sourceforge.net/projects/zplet/
and the complete Zplet code can be downloaded from there as well.

RandomAccessFile class from Firth Software
from http://www.firthsoftware.co.uk/RandomAccessFile.jsp

AdventureCanvas from Paul Rowland
from http://www.geocities.com/wirelessjava2002/adventure/

FastText input from Markku Korsumäki , I ported it to J2ME
from http://koti.mbnet.fi/korsu/ft.html

Thanks to everyone on j2me.org who answered my questions as I am learning j2me.


===================
Z2me is a ZCode interpreter for the J2ME environment.
ZCode is the intermediate language that was designed
and used by the original Infocom text adventure games.
Using Z2me, it is possible to package and play a large
variety of interactive fiction on your J2ME mobile device.

Z2me is shipped with the public domain game "MiniZork". This
is a demo version of the original Infocom Zork game. Refer to
http://gpf.dcemu.co.uk for more information about Z2me.

What's New
==========
- Initial release

Features
========
- J2ME MIDP 1.0 or greater, should run on most devices that have enough memory.
- Should run most Z-code programs of versions 3.
- Text completion(Z9) - can be enabled/disabled through menu.
- About screen through menu.
- Save/Restore support for 1 save file.
- key 1 , cycles through all of the directions (NORTH, SOUTH, etc)
- key 0 , cycles through some commands I frequently use. ( ',' , AGAIN , WAIT, AND)
- key * , cycles through the Z9 completed words
- UP/DOWN arrow keys scroll the screen.
- LEFT/RIGHT cycle through the last 10 commands.

Also a different Z3 zcode format file can be added to the jar file(remove minizork.z3 first) and then update the "Zfile" user defined property with the name of the new Z3 file in the jad file. Remembering to watch the file size of the jar depending on your cellphone limitations.

What's Missing
==============
- Multiple save/restore slots


Prerequisites
=============
- J2ME MIDP 1.0 capable device
- Enough memory to load the jar, load the zcode and host the heap.
The amount of memory will vary tremendously from one Z-Code game to the next.

Getting Started
===============
Install the JAR and JAD file to your mobile device.




Disclaimer
==========
Z2me is provided as-is. There is no warranty or guarantee that Z2me will work as advertised and
that it won't cause your mobile device any harm.

I hope you enjoy Z2me.

Midp1.0 version
===============
http://gpf.dcemu.co.uk/Z2me.jad
http://gpf.dcemu.co.uk/Z2me.jar

Source code
http://gpf.dcemu.co.uk/Z2me_src.rar

BlackBerry Version
===============
http://gpf.dcemu.co.uk/blackberryZ2me.alx
http://gpf.dcemu.co.uk/blackberryZ2me.cod
http://gpf.dcemu.co.uk/blackberryZ2me.cso
http://gpf.dcemu.co.uk/blackberryZ2me.rapc
http://gpf.dcemu.co.uk/blackberryZ2me.jad
http://gpf.dcemu.co.uk/blackberryZ2me.jar

Source code
http://gpf.dcemu.co.uk/blackberryZ2me_src.rar