README_DE

Jake2 README
============

Jake2 ist eine Java Portierung der Quake2 Engine von id Software. Id Software
hat den Sourcecode der Quake2 Engine unter den Bedingungen der GPL
veröffentlicht. Dementsprechend wird auch Jake2 unter der GPL (siehe LICENSE)
lizensiert.

Jake2 ist eine reine Java Anwendung. Als native Library kommen im Moment nur
jogl für die OpenGL Anbindung und joal für OpenAudio Soundunterstützung zum
Einsatz. Seit Version 0.9.4 ist auch ein lwjgl Treiber als Alternative zur
jogl/joal Kombination enthalten. Die komplette Funktionalität der Engine wurde
ausschliesslich mit Java realisiert.

Jake2 befindet sich noch im Entwicklungsstadium. Die Kontaktaddresse für 
Bugreports und Rückmeldungen ist jake2@bytonic.de.

Jake2 läuft unter Linux, Windows2000/XP sowie Mac OS X. Als reiner Server ohne
grafische Oberfläche läuft Jake2 auf jeder Plattform mit JRE1.4.

Mindestanforderungen:
400 MHz CPU
Geforce2 MX oder bessere Grafikkarte
JRE 1.4.2
JDK 1.5 zum Übersetzen der Jake2 Quellen

Installation
------------

ausgehend von der Binärdistribution:
- Installationsprogramm mit "java -jar Jake2-0.9.5-install.jar" starten
- den Anweisungen folgen
- ins Installationsverzeichnis wechseln
- Jake2 mit "jake2.sh" oder "jake2.bat" aus dem Installationsverzeichnis starten
- um den lwjgl OpenGL/OpenAL Treiber zu nutzen Jake2 mit "jake2_lwjgl.sh" oder
  "jake2_lwjgl.bat" aus dem Installationsverzeichnis starten

ausgehend von Sourcedistribution:
- jake2src-version.tar.gz oder jake2src-version.zip entpacken
- JAVA_HOME Umgebungsvariable auf JDK1.5 Installationsverzeichnis setzen
- "build.sh installer" oder "build.bat installer" erzeugt den Installer

Quake2 Leveldaten installieren:
- Wenn die Quake2 Leveldaten beim Start von Jake2 nicht gefunden werden,
  besteht die Möglichkeit ein baseq2 Verzeichnis einer bestehenden Quake2
  Installation (Demo oder Vollversion) auszuwählen oder die Leveldaten der
  Demo herunterzuladen und zu installieren

Zum Testen neuer und experimenteller Features kann der aktuelle Jake2 
Sourcetree per anonymous CVS ausgecheckt werden.
- "cvs -d:pserver:anonymous@jake2.cvs.sourceforge.net:/cvsroot/jake2 login"
- bei der Frage nach dem Passwort einfach Enter drücken
- "cvs -d:pserver:anonymous@jake2.cvs.sourceforge.net:/cvsroot/jake2 co jake2"
- dann gehts weiter wie oben für die Sourcedistribution beschrieben

externe Komponenten
-------------------

Jake2 benutzt:
jogl     OpenGL bindings                https://jogl.dev.java.net
joal     OpenAL bindings                https://joal.dev.java.net
lwjgl    Light Weight Java Game Library http://www.lwjgl.org
openal   Audio library                  http://www.openal.org
izpack	 Installer                      http://www.izforge.com/

the source distribution comes with:
ant      build tool                     http://ant.apache.org
xerces   XML library                    http://xml.apache.org

<jake2@bytonic.de> für Bugreports und Rückmeldungen.

have fun!

bytonic Software
----------------
Holger Zickner <hoz@bytonic.de>
Carsten Weisse <cwei@bytonic.de>
Rene Stoeckel  <rst@bytonic.de>

Top-Contributors
----------------
David Sanders				       	lwjgl Unterstützung
Kenneth Russell	(Sun Microsystems)	jogl Verbesserungen und Optimierungen
Scott Franzyshen					3rd Person Camera, CD Player emulation (MP3), Console Patch