J R O B O T S ============= A strategic programming game system By Drew Bowering Curtis Yallop 1999/09/15 Introduction ============ A long time ago, there was a marvellous game called CRobots. It was a programming game, designed to let players write a simple control program for a robot, that would battle other robots. It was a great learning tool for the C language, and in fact, helped me learn it. I found an Amiga port of this game (ACRobots), quickly learned C, and wrote some robots. I showed the game to my friend Curtis, and we started having many great battles. After one-upping each other in robot technology for quite some time, I finally wrote a robot that managed to crash the entire computer (!), and the arms race ended. Several years passed, and Curtis and I started reminiscing about how great CRobots was. We had the brilliant idea of writing our own CRobots-like game, possibly extending the ideas in the game. We decided to implement the game in Java, because we thought the fact that it could dynamically load classes that were platform independent was the perfect solution. JRobots was born. Usage ===== First, compile the program. It is very simple, and should compile with the following command line: javac *.java All of the class files that are generated should be put into a directory in your $CLASSPATH variable. To run the game, issue the following command: java JRobots ... where the arguments are the names of the robot classes that will be participating in the battle. You don't need to type the .class extension on these. This is a graphical application (using AWT), so you will need to be on a graphics capable terminal. Writing Your Own Robots ======================= Writing your own robot is a fairly simple process. For instructions on the game API and robot writing directions, please refer to the file robot-guide.txt. JRobots comes with a number of test robots in the TestRobots directory. Use their source code as an example of how to write a robot, and use their binaries as sample opponents! Distribution Terms ================== We haven't really decided on licensing terms yet, but please follow these guidelines: 1) Don't redistribute the game without providing access to the source code 2) Don't make undocumented changes to the source code, and redistribute the game. 3) Make sure you include all documentation files when you redistribute, including this one! 4) If you make any changes that you think are positive, please send them back to us! Contact information is at the bottom of this file. 5) Don't use the source code here in any other project without letting us know. Let us know what you'd like to use it for, and we'll decide then. 6) Don't expect this program to work 100% just yet. Although it works, we're not really "done". Changes to our APIs may happen yet, so don't trust 'em! Web Page ======== The "official" JRobots web page can be found at this URL: http://tachyon.vekxed.net/~drew/jrobots.html The latest version of the program may also be downloaded from there. Mailing List ============ JRobots now has a mailing list! To subscribe, send an empty email to: jrobots-list-subscribe@tachyon.vekxed.net To unsubscribe, send an empty email to: jrobots-list-unsubscribe@tachyon.vekxed.net To send a message to the list, send an email to: jrobots-list@tachyon.vekxed.net Contact ======= You can contact us using the following: Drew Bowering ------------- email: drew@tachyon.vekxed.net Snail Mail: #411 9825 103st. Edmonton, Alberta Canada T5K 2M3 Telephone: 1(780)425-7193 ICQ: 26152645 Curtis Yallop ------------- email: cyallop@ualberta.ca ICQ: 19477581