Version 0.9 - May 1, 1997
Mark Tacchi, mtacchi@hipbone.com




The Gamelet Toolkit Version 0.9 is a powerful, robust, scalable, object oriented framework of classes and interfaces used for developing arcade style video games and entertainment applets. It provides classes for the management of several key functions i ncluding sprite animation, display optimization, and scoring.

Because the Gamelet Toolkit is built on object oriented principles, developing fast action gamelets is quick and easy. A simple gamelet needs only to subclass the Actor class for as many Actors desired, and the Gamelet class which defines gamelet behavio ur.

Actor objects, which are sprite objects displayable on the screen, require very little programming to get started. The Actors that the developer designs will inherit from the Actor superclass and take on a default behaviour. This behaviour can be modifi ed if the developer chooses to do so.

The main control of the game is centered around an abstract superclass called Gamelet which is subclassed to build game specific behaviour. Gamelet is a subclass of Applet and is responsible for maintaining the main game thread. The Gamelet also acts as a distributor of timed ticks to all the manager objects.

The Gamelet Toolkit distribution contains example source code and documentation to help get started.





The entire Gamelet Toolkit distribution can be downloaded in either of two convenient formats. Select one that's easiest for you:


If you wish to mirror this distribution on your site:
  1. select a convenient compressed file from those listed above,
  2. unpack this file and place the entire Gamelet Toolkit directory on your web server somewhere under the document root,
  3. download the other compressed copy of the Gamelet Toolkit,
  4. copy both of these compressed files to the Gamelet Toolkit directory on your web server,
  5. send email to mtacchi@hipbone.com saying that yoou have created a mirror site.





You can run the examples here from your browser if it supports the JDK 1.02, but if you are doing gamelet development you'll have to install the Gamelet Toolkit class files locally.

    To install the Gamelet Toolkit locally,

  1. Download and install the JDK 1.02
  2. After downloading and unpacking the compressed Gamelet Toolkit, you'll want to copy everything under the GameletToolkit directory to somewhere in your CLASSPATH; /jdk/lib/classes is probably a good place to stick it.
    		% cp -r GameletToolkit /jdk/lib/classes   (on UNIX)

		C> xcopy GameletToolkit \jdk\lib\classes  (on
Win32)
  3. Be sure that your CLASSPATH is set to something similar to the following:
    		% setenv CLASSPATH /jdk/lib/classes:.:$CLASSPATH  (on
UNIX)

		C> set CLASSPATH=C:\jdk\lib\classes;.;%CLASSPATH%  (on
Win32)
    You'll probably want to put this information in your rc file, autoexec.bat, or registry so that you don't have to type it in every time you restart your computer.











Following are some examples of gamelets written with the Gamelet Toolkit. Although these can be run from any Java 1.1 capable browser, higher frame rates can be achieved by running them with a JIT VM.

Depending on the number of actors and the virtual machine these gamelets are run on, expected maximum frame rate on a Pentium Pro 200MHz, 96MB RAM, running NT can reach 100 frames per second.

The examples are located in the examples directory in the Gamelet Toolkit distribution.




I sincerely hope that you find the Gamelet Toolkit useful in creating fast action arcade style games and entertainment applets. This project consumed copious amounts of my spare time for several months and it represents an icon of human obsession. I cou ld not have accomplished this without the support of my peers.

The Gamelet Toolkit was inspired by a game engine called Xox which was written under NEXTSTEP by Sam Streeper. Many thanks to all others for advice and encouragement.

Mark Tacchi