JAFUFFY
=======

- Das Wichtigste in aller Kürze -


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

JaFuffy ist ein Würfelspiel 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
Einschränkungen.

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
ausdrücklich erwünscht.


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

Für den Betrieb ist eine Installation der Java-Laufzeitumgebung ("JRE")
notwendig, und zwar mindestens Version 7. Diese ist über 
http://www.java.com erhältlich.

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 Turnierstände werden in einem Verzeichnis abgelegt,
das unter dem Menü "Einstellungen -> Pfad" ausgewählt werden kann. Beim
erstmaligen Programmstart jedoch wird der Benutzer automatisch danach
gefragt. In das Verzeichnis muss von JaFuffy auch geschrieben werden
dürfen.

Zur vollständigen Deinstallation müssen außer dem Programmverzeichnis
noch die Datei "JaFuffy.ini" sowie das Verzeichnis der Statistikdaten
und Turnierstände gelöscht werden.


Start
-----

Die Installationsroutinen tragen JaFuffy in die Menüstruktur der
Benutzeroberfläche 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") verknüpft. 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 Fenstergröße kann mit dem Menüpunkt "Extras - Fenster anpassen"
  optimiert werden.

* Ein Turnierstand kann abgespeichert werden. Das Turnier kann später
  mit diesem Stand fortgesetzt werden. Indem man direkt nach einem
  Turnierstart abspeichert, können auch Turnierkonfigurationen
  abrufbereit abgelegt werden.

* Eine leichte Verzögerung nach dem Mausklick beim Würfeln? Das kann
  daran liegen, dass die Geräuscheffekte aktiviert sind. Wenn der Ton
  leise oder nicht zu hören ist, fällt diese Verzögerung auf. Im anderen
  Fall, bei Würfelgeräuschen, wirkt der Ton ohne Verzögerung
  unecht. Also: Stört dieses Verhalten, einfach die Geräuscheffekte
  ausschalten.
   
* Darstellungsfehler beim Aufbau der Benutzeroberfläche bzw. der
  grafischen Elemente können durch Drücken der Taste "N" (neu zeichnen)
  behoben werden.
  
* Beachtet die Tasten "W" (würfeln), "V" (Vorschlag geben lassen) und "T"
  (Vorschlag setzen lassen). Insbesondere könnt ihr damit erreichen, dass der
  Computer als Gegenspieler fungiert.


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

* Bei Verwendung des Erscheinungsbildes "Nimbus" (Look & Feel) wird die
  Rücknahme der Würfelauswahl 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 vollständig abstellt. Aufruf z.B. mit "java
  -jar jafuffy.jar nosound".


Kontakt
-------

Rückmeldungen, Kritik, Vorschläge und Verbesserungen sind ausdrücklich
von mir erwünscht.

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



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


VIEL SPASS!

Wolfgang


Stuttgart, 04. Januar 2015
