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 
http://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.


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
---------------

* Bei Verwendung des Erscheinungsbildes "Nimbus" (Look & Feel) wird die
  Rcknahme der Wrfelauswahl nicht richtig dargestellt.

* Das Soundsystem kann Schwierigkeiten bereiten, bei neueren
  Java-Versionen sollte dies jedoch nicht mehr vorkommen. Bei der
  Applikation kann jedenfalls ein Parameter "nosound" bergeben werden,
  der den Sound von JaFuffy vollstndig abstellt. Aufruf z.B. mit "java
  -jar jafuffy.jar nosound".


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, 04. Januar 2015
