JAFUFFY
=======

- Das Wichtigste in aller Krze -


Was ist JaFuffy?
----------------

JaFuffy ist ein Wrfelspiel mit drei Regelvarianten, abgeleitet von dem Spiel bekannt unter 
den Namen "Kniffel" oder "Yahtzee". Vorlage war das Spiel "Fuffy" auf dem Atari ST. JaFuffy 
kann sowohl als Applikation ("Stand-Alone") als auch als Applet (in einem Web-Browser) 
laufen, im letzteren Fall aber nur mit Einschrnkungen.

Eine genaue Anleitung zu den Spielregeln und dem Programm findet sich im 
Installationsunterverzeichnis "Anleitung". Diese kann auch in JaFuffy gelesen werden. 

Lizenz
------

JaFuffy ist freie Software und unterliegt der GNU General Public License. Mehr dazu findet 
sich im Programmmen "Hilfe" und im Installationsunterverzeichnis "Liesmich" in der Datei 
"GPL.html". 

Jeglicher Weiterverkauf ist untersagt, die kostenlose Weitergabe ist ausdrcklich erwnscht. 


Systemvoraussetzungen
----------------------

Fr den Betrieb ist eine Installation der Java-Laufzeitumgebung ("JRE") notwendig, und zwar 
mindestens Version 7. Diese ist ber https://www.java.com erhltlich. 

Ansonsten gibt es keine weiteren Anforderungen an das System.


Hinweise zur (De)Installation
-----------------------------

Kurzhinweise finden sich auch in "Installation.html".

Das JaFuffy-Paket besteht aus einer einzigen gepackten Datei. Diese kann in ein Verzeichnis 
der eigenen Wahl entpackt werden.

Eine Einstellungsdatei "JaFuffy.ini" wird in einem vom System erreichbaren Verzeichnis 
abgelegt. In der Regel wird dies das Heimverzeichnis des Benutzers sein. Bei lteren 
Windows-Versionen kann das aber auch z.B. das Systemverzeichnis "windows" sein.

Statistikdaten und Turnierstnde werden in einem Verzeichnis abgelegt, das unter dem Men 
"Einstellungen -> Pfad" ausgewhlt werden kann. Beim erstmaligen Programmstart jedoch wird 
der Benutzer automatisch danach gefragt. In das Verzeichnis muss von JaFuffy auch geschrieben 
werden drfen.

Zur vollstndigen Deinstallation mssen auer dem Programmverzeichnis noch die Datei 
"JaFuffy.ini" sowie das Verzeichnis der Statistikdaten und Turnierstnde gelscht werden.


Start
-----

Die Installationsroutinen tragen JaFuffy in die Menstruktur der Benutzeroberflche ein. 
Sollte dies nicht der Fall sein oder sollen die Installationsroutinen nicht verwendet werden, 
helfen die untenstehenden Tipps weiter.

Normalerweise sind Dateien mit der Endung ".jar" mit der Laufzeitumgebung von Java ("JRE") 
verknpft. Mit einem (Doppel)Klick auf "jafuffy.jar" sollte das Programm starten.

Ansonsten ist nach dem Auspacken der gepackten Datei in das Installationsverzeichnis 
"jafuffy" zu wechseln. Auf der Kommandozeile ist dann "javaw -jar jafuffy.jar" oder "java 
-jar jafuffy.jar" einzugeben.

Wird JaFuffy mit der Option "nolock" gestartet, knnen davon mehrere Instanzen auf einem 
Rechner oder Gert laufen.

Wird JaFuffy mit der Option "simulation" gestartet, werden die meisten Wartezeiten in der 
Benutzeroberflche auf Null gesetzt. 


Tipps
-----

* Werft doch mal einen Blick in das Men "Einstellungen".

* Die Fenstergre kann mit dem Menpunkt "Extras - Fenster anpassen"   optimiert werden.

* Ein Turnierstand kann abgespeichert werden. Das Turnier kann spter   mit diesem Stand 
  fortgesetzt werden. Indem man direkt nach einem   Turnierstart abspeichert, knnen auch 
  Turnierkonfigurationen   abrufbereit abgelegt werden.

* Eine leichte Verzgerung nach dem Mausklick beim Wrfeln? Das kann   daran liegen, dass die 
  Geruscheffekte aktiviert sind. Wenn der Ton   leise oder nicht zu hren ist, fllt diese 
  Verzgerung auf. Im anderen   Fall, bei Wrfelgeruschen, wirkt der Ton ohne Verzgerung   
  unecht. Also: Strt dieses Verhalten, einfach die Geruscheffekte   ausschalten.
   
* Darstellungsfehler beim Aufbau der Benutzeroberflche bzw. der   grafischen Elemente knnen 
  durch Drcken der Taste "N" (neu zeichnen)   behoben werden.
  
* Beachtet die Tasten "W" (wrfeln), "V" (Vorschlag geben lassen) und "T"   (Vorschlag setzen 
  lassen). Insbesondere knnt ihr damit erreichen, dass der   Computer als Gegenspieler
  fungiert.


Bekannte Fehler
---------------

* Speicherlecks durch die Verwendung der rumlichen Darstellung des Balkendiagramms zum 
  Turnierverlauf.


Kontakt
-------

Rckmeldungen, Kritik, Vorschlge und Verbesserungen sind ausdrcklich von mir erwnscht.

E-Mail: jafuffy@3kelvin.de
Homepage: http://jafuffy.3kelvin.de



=========================


VIEL SPASS!

Wolfgang


Stuttgart, 06. Juli 2019
