README JTrek a Netrek client for the Java(TM) Platform version 0.9.3 Beta by Robert Temple June 23, 1998 ----------------------------------------------------------------------- NOTICE ----------------------------------------------------------------------- No representations are made about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. JTrek was written entirely by Robert Temple on his own time. In no way is this software associated with Robert Temple's employer, Starwave Corporation. Starwave is not responsible for any part of this software, nor is Starwave responsible for anything that happens as the result of using this software. Java and all Java-based marks are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Robert Temple is independent of Sun Microsystems, Inc. ----------------------------------------------------------------------- Contents ----------------------------------------------------------------------- Overview of JTrek Acknowlegments System requirements Installing JTrek Running JTrek Changes Things which are not yet implemented Known bugs Comments, Bug reports resource/properties file changes Other information ----------------------------------------------------------------------- Overview of JTrek ----------------------------------------------------------------------- JTrek is the first Netrek client written entirely in 100% Java. This is a alpha release of the software, meaning that there parts of the software that are not yet implemented, and there are many bugs. Most of the code for this software was ported over from the COW and Paradise clients. Look for new releases at: http://www.starwave.com/people/robertt/JTrek ----------------------------------------------------------------------- Acknowlegments ----------------------------------------------------------------------- People who made it possible for me to do this: Jason Herring, who helped me set up my own server, so that I could test this thing. Brad Morrey, who set up a server at Berkeley and helped me test the client as an applet. People who worked on the COW client or some other part of Netrek: Chris Guthrie, Ed James, Scott Silvey, and Kevin Smith, Tedd Hadley, Andy McFadden, Eric Mehlhaff, J. Mark Noworolski, Nick Trown, Lars Bernhardsson, Sam Shen, Rick Weinstein, Jeff Nelson, Jeff Waller, Robert Kenney, Steve Sheldon, Jonathan Shekter, Dave Gosselin, Heiko Wengler, Neil Cook, Kurt Siegl and many others. People who worked the Paradise client: Larry Denys, Kurt Olsen, Brandon Gillespie ----------------------------------------------------------------------- System requirements ----------------------------------------------------------------------- JTrek requires that a Java 1.1 compatible version of a Java virtual machine be installed on your machine. For information on where to get this software, see http://www.javasoft.com ---------------------------------------------------------------------- Installing JTrek ----------------------------------------------------------------------- To install JTrek, uncompress the archive into a directory. ----------------------------------------------------------------------- Running JTrek ----------------------------------------------------------------------- JTrek requires that both the the standard Java 1.1 libraries, and the JTrek classes be in the Java classpath. The main Java class of JTrek is: jtrek.Main To execute JTrek use the following command from the prompt: java jtrek.Main -h kirk.ci.houston.tx.us -p 2592 ----------------------------------------------------------------------- Setting up JTrek as an applet ----------------------------------------------------------------------- JTrek was designed to work with IE 4 and Netscape 4 as an applet. User properties get saved as cookies. Copy the applet.html page to your HTTP server. The HTTP server needs to be the same server as the netrek server. Put the JTrek.jar file in the same directory as the applet.html. To get sounds to work, Make a sub directory called jtrek in this directory. In this directory make another called applet, and then one more called sounds. Put all the .au files there. Your files system should look like this: /applet.html /JTrek.jar /jtrek/applet/sounds/*.au Hit applet.html with IE 4 or Netscape 4 or greater and try it out! ----------------------------------------------------------------------- Changes ----------------------------------------------------------------------- 0.9.3 Added sound support in the applet version, the help window, continuous mouse, and the macro window. Enhanced the applet version of the applet. 0.9.2 Added RSA. Added full color support. A few others things that I can't remember. ----------------------------------------------------------------------- Things which are not yet implemented ----------------------------------------------------------------------- There are a few things that are missing that you are probably used to in other clients. Documentation!!! Metaserver window netstat TTS ----------------------------------------------------------------------- Known bugs ----------------------------------------------------------------------- Sometimes two clicks are registered in the the Options window instead of one. This causes weired side effects. This is Javaosft bug, and is documented on the their website: http://developer.javasoft.com/developer/bugParade/bugs/4065242.html ----------------------------------------------------------------------- Comments, Bug reports ----------------------------------------------------------------------- Send all comments, requests, bug reports to: robertt@starwave.com PLEASE, put the word JTREK somewhere is the subject, otherwise I might ignore the message... ----------------------------------------------------------------------- resource/properties file changes ----------------------------------------------------------------------- The default resource file is called "JTrek.props" Inside is all of the defaults settings of the client. This file is very similar to the .xtrekrc you are used to. A few keys have changed to have consistent naming patterns as other keys. All boolean parameters should be either "true" or "false" - "on", "off", "yes", and "no" don't work. Window geometry is done with pixels increments, in the form of "x,y,width,height". ----------------------------------------------------------------------- Other information ----------------------------------------------------------------------- JTrek doesn't have extended buttonmaps. I don't think it is possible to implement this in Java because of the way Java handles the differences between systems with less then three mouse buttons. The classes are compiled with optimation turned off, and debugging turned on. This should help me track down any bugs that might be out there. I've only tested this on Windows NT 4.0 and Solaris. Never quit the game by using Control-C at the command prompt. This will leave a slot being wasted on the server. ----------------------------------------------------------------------- Source code ----------------------------------------------------------------------- There is a link to the latest at: http://www.starwave.com/people/robertt/JTrek