*************************************************************************
*                           Animal Breed Master                         *
*************************************************************************

Dieses Plugin ermglicht es dir, Tiere zu halten, zu fttern und zu zchten.
Dies ist eine Alpha-Version, noch nicht feature-complete, aber alle unten
aufgefhrten Aktionen funktionieren.


Installation:
------------
Extrahiere animalbreedmaster.zip im RisingWorld/plugins-Ordner.
(wenn der plugins-Ordner noch nicht existiert, dann erstelle ihn bitte)
Sollte bereits eine vorige Version existieren, dann die alten Dateien
einfach berschreiben.

Danach sollte folgende Ordnerstruktur vorliegen:
-- /RisingWorld
   |
   |-- /plugins
       |
       |-- /animalbreedmaster
           |--/data (Ordner wird beim ersten Start automatisch erzeugt,
           |         enthlt Datenbankdateien fr jede Welt)
           |- AnimalBreedMaster.jar
           |- AnimalBreedMaster.prefs.xml (wird automatisch erzeugt)
           |- changelog_de.txt
           |- changelog_en.txt
           |- readme_de.txt
           |- readme_en.txt


Einstellungen:
-------------
In der AnimalBreedMaster.prefs.xml kannst du die maximale Anzahl Tiere je Spieler einstellen.
Trage einen angemessenen Wert ein, erlaubter Bereich ist zwischen 1 und 1000, Standard ist 50:

  <entry key="max_animals_per_player">50</entry>

Auerdem kann das Belohnungssystem ein- bzw. ausgeschaltet werden.
true = eingeschaltet, false = deaktiviert:

  <entry key="reward_system_active">true</entry>

Seit Version 0.50 kannst du die Umbenennung (de)aktivieren (mit Papier in der Hand auf
Tier zielen).
Dies ist ntzlich, solltest du mal Probleme mit der Eingabebox haben.
true = aktiviert, false = deaktiviert

  <entry key="rename_action_active">true</entry>

Du kannst die Interaktion fr Unverwundbarkeit (de)aktivieren.
Dies ist ntzlich auf Multiplayer-Servern, wenn du nicht mchtest, dass deine Spieler mit unverwundbaren
Tieren Unfug treiben.
true = aktiviert, false = deaktiviert

  <entry key="invincible_action_active">true</entry>


Beschreibung:
------------
Du wolltest schon immer ein Farmer sein? Dann mal los!
Du hast nun die Mglichkeit, eigene Tiere zu halten, diese zu fttern
und fr Nachkommen zu sorgen!

Wie wirst du zum Viehzuchtmeister?
1. Zunchst musst du wilde Tiere einfangen:
   Fttere das Tier solange, bis es dir gehorcht!
   Halte dazu die entsprechende Leckerei (s. Liste unten) in der Hand und
   nhere dich. Dabei musst du auf ihn zeigen (das Fadenkreuz muss auf das
   Tier zeigen, der Name des Tieres erscheint dann).
   Sobald du dann die Interaktionstaste drckst (Standard: Taste <F>), beginnt es, dir aus der Hand zu fressen.
   Nach einigen Leckereien gehrt es dir!

2. Befehle das Tier, dir zu folgen:
   Halte ein Nudelholz in der Hand, zeige auf ihn und drcke die Interaktionstaste.
   Es beginnt, dir hinterherzulaufen.
   Wenn es dir nicht mehr folgen soll, dann interagiere erneut mit dem Nudelholz.
   Whrend es dir folgt, musst du das Nudelholz nicht in der Hand halten.
   Du kannst also in der Zwischenzeit andere Dinge erledigen, z.B. selbst was essen
   oder Bume fllen, etc.

3. Gib deinem Tier einen schnen Namen:
   Halte ein Stck Papier in der Hand, zeige auf ihn und drcke die Interaktionstaste.
   Es erscheint ein Eingabefeld. Gib den gewnschten Namen ein (ggf. vorher mit der Maus in das Feld klicken)
   und besttige mit der <Enter>-Taste.

4. Mach dein Tier paarungswillig:
   Fttere es erneut einige Male mit der entsprechenden Leckerei.
   Wenn es genug gefressen hat, dann mchte es gerne loslegen! :D
   Allerdings bentigt es dazu einen gleichgesinnten Partner!
   Du musst also mindestens zwei Tiere (der gleichen Gattung)
   paarungswillig machen!

5. Die Nachzucht:
   Wenn zwei Tiere paarungswillig sind, dann legen sie los!
   Eines davon wird trchtig und nach knapp anderthalb Stunden (Echtzeit)
   wird es ein Junges zur Welt bringen!
   Tipp: Du kannst die Dauer durch wiederholte Ftterung wesentlich reduzieren!


Zustzliche Interaktionen:
-------------------------
Leine dein Tier an:
  Halte ein Stck Holz in den Hnden, zeige auf ihn und drcke die Interaktionstaste.
  Dein Tier wird sich nicht mehr von der Stelle bewegen!
  Zum Losbinden drcke die Interaktionstaste erneut.

Mache dein Tier unverwundbar:
  Halte einen Goldstab in der Hand, zeige auf ihn und drcke die Interaktionstaste.
  Drckst du die Interaktionstaste erneut bei einem unverwundbaren Tier, dann wird es wieder sterblich.

Gib dein Tier wieder frei (es ist wieder wild):
  Halte einen Stock in der Hand, zeige auf ihn und drcke die Interaktionstaste.
  Das Tier gehrt dir nun nicht mehr.


Das Belohnungssystem:
--------------------
Fr einige Aktionen erhltst du Punkte, die du dann spter in "exotischere" Tiere
umwandeln kannst!


Wie erhlt man Punkte?
Fr folgende Aktionen bekommst du jeweils 1 Punkt:
- ein Tier einfangen
- ein Tier paarungswillig machen
- ein Tier wird trchtig
- ein Junges wird geboren

Welche Tiere kann ich erhalten und fr wieviele Punkte?
- Fuchs      :  60 Punkte
- Minischwein: 100 Punkte
- Pinguin    :  50 Punkte
- Kaninchen  :  40 Punkte
- Ratte      : 100 Punkte

Wie bekomme ich ein Belohnungstier?
- du musst einen bestimmten Gegenstand in der Hand halten und an der Stelle,
  wo es erscheinen soll, ablegen (mit Taste <Q>), der Gegenstand wird dann
  gegen das neue Tier ausgetauscht
- warte max. 10 Sekunden in der Nhe des abgelegten Gegenstandes (2-3 Meter) bis
  das Tier erscheint (oder ein Hinweis, falls nicht gengend Punkte vorhanden sind)
- Liste der Gegenstnde: s. unten

Wie erfahre ich meinen aktuellen Punktestand?
- gib im Chat "/abm help" ein oder
- zeige mit einem "Belohnungs"-Gegenstand auf eines deiner Tiere



Interagiere mit dem Tier, indem du mit einem bestimmten Gegenstand in
deiner Hand auf ihn zeigst.

Liste der Gegenstnde und die jeweilige Interaktion:
---------------------------------------------------
Maiskolben: Schwein fttern
Karotte: Kuh fttern
Setzling (Fichte): Ziege fttern
Zuckerrbe: Schaf fttern
Bacon (roh): Fuchs fttern
Kirschen: Br fttern
Erdbeeren: Kaninchen fttern
Wassermelonensamen: Huhn fttern
Krbissamen: Huhn fttern
Chilischote: Huhn fttern
Apfel: Elefanten fttern
Steak (roh): Jaguar fttern
Rippchen (roh): Tiger fttern
Stck Wassermelone: Minischwein fttern
Bacon (gegrillt): Ratte fttern
Kartoffel: sonstiges Tier fttern
Zitrone: sonstiges Tier fttern

Nudelholz: Tier folgt dir
Goldstab: Tier wird unverwundbar
Holz: Tier bleibt still stehen
Papier: Tier umbenennen
Stock: Tier freigeben

Aluminiumbarren: Anzahl der Belohnungspunkte in Erfahrung bringen
Goldbarren: Anzahl der Belohnungspunkte in Erfahrung bringen
Mithrilbarren: Anzahl der Belohnungspunkte in Erfahrung bringen
Silberbarren: Anzahl der Belohnungspunkte in Erfahrung bringen
Glhlampe: Anzahl der Belohnungspunkte in Erfahrung bringen


Lege einen der folgenden Gegenstnde auf den Boden ab, um eine Belohnung zu erhalten:
------------------------------------------------------------------------------------
Aluminiumbarren: Fuchs fr 60 Belohnungspunkte
Goldbarren: Pinguin fr 50 Belohnungspunkte
Glhlampe: Ratte fr 100 Belohnungspunkte
Mithrilbarren: Minischwein fr 100 Belohnungspunkte
Silberbarren: Kaninchen fr 40 Belohnungspunkte


Weitere Hinweise:
----------------
Der Name ber ein Tier erscheint in unterschiedlichen Farben, wobei:
- gelb = ein wildes Tier, welches du einfangen kannst
- grn = dies ist dein Tier
- blau = dieses Tier gehrt einem anderen Spieler

Aus Performanz-Grnden werden Interaktionen im Sekundentakt verarbeitet.
Wenn ein Tier mal nicht prompt reagiert, einfach fr ca. 1 Sekunde
nicht auf das Tier zielen.


Chat Kommandos:
--------------
ffne die Chat-Konsole (Standard Taste <T>) und gib folgendes ein:
/abm help
fr eine kurze Hilfeseite.
(Aktiviere den Chat und drcke <Bild hoch> <Bild runter> zum Scrollen)

Du kannst das Belohnungssystem on-the-fly umschalten,
zustzlich wird die Einstellung in AnimalBreedMaster.prefs.xml gespeichert:

/abm rewsys true
- aktiviert Belohnungssystem

/abm rewsys false
- deaktiviert Belohnungssystem

Du kannst die Namensetiketten aus- bzw. einschalten:
/abm showlabels off
/abm showlabels on

Du kannst Benachrichtigungen im Chat aus- bzw. einschalten:
/abm showchat off
/abm showchat on

Seit Version 0.50 kannst du die Umbenennung on-the-fly umschalten,
dies ist ntzlich, solltest du mal Probleme mit der Eingabebox haben.
Zustzlich wird die Einstellung in AnimalBreedMaster.prefs.xml gespeichert:

/abm rename true
/abm renaming true
- aktiviert Umbenennung

/abm rename false
/abm renaming false
- deaktiviert Umbenennung

Auf Multiplayer-Servern drfen nur Administratoren dieses Kommando verwenden.

Aufzhlung der Tiere:
/abm count all - Aufzhlung aller Tiere
/abm count TYPENAME - nur eine bestimmte Art aufzhlen:
  /abm count pig
  /abm count cow
  usw.

Auflistung der Tiere mit Zusatzdaten wie Position, Entfernung (distance) und Name:
/abm list all - alle Tiere auflisten
/abm list TYPENAME - bestimmte Art auflisten, z.B.:
  /abm list pig
  /abm list cow
  usw.

Rufe all deine Tiere zurck:
/abm warphome all (all deine Tiere zurckrufen)
/abm warphome ID (ein bestimmtes Tier zurckrufen - benutze /abm list, um die ID herauszufinden)
/abm warpallhome (nur Admins - alle Tiere von allen Spielern gleichzeitig zurckrufen)


Du kannst die Interaktion fr Unverwundbarkeit on-the-fly umschalten.
Dies ist ntzlich auf Multiplayer-Servern, wenn du nicht mchtest, dass deine Spieler mit unverwundbaren
Tieren Unfug treiben.
Auf Multiplayer-Servern drfen nur Administratoren dieses Kommando verwenden.
Zustzlich wird die Einstellung in AnimalBreedMaster.prefs.xml gespeichert:

/abm invincible true
- aktiviert Interaktion fr Unverwundbarkeit

/abm invincible false
- deaktiviert Interaktion fr Unverwundbarkeit


Weitere Kommandos nur fr Admins:
- /abm listranchers NAME(optional) - alle Rancher (Spieler mit Tieren) auflisten,
  wenn NAME angegeben, dann nur die, deren Name mit NAME beginnt
- /abm listanimals PLAYER_ID - alle Tiere vom Spieler PLAYER_ID auflisten
- /abm changeowner rancher OLD_ID NEW_ID - alle Tiere vom Spieler OLD_ID auf NEW_ID bertragen
  (setze NEW_ID = -1 um alle Tiere an die Wildnis zurckzugeben)
- /abm changeowner animal NPC_ID PLAYER_ID - Tier NPC_ID auf Spieler PLAYER_ID bertragen
  (setze PLAYER_ID = -1 um das Tier an die Wildnis zurckzugeben)
- /abm reset lock rancher ID - alle angeleinten Tiere des Spielers mit ID losbinden
- /abm reset lock animal ID - angeleintes Tier mit ID losbinden
- /abm reset invincible rancher ID - alle Tiere des Spielers mit ID wieder verwundbar machen
- /abm reset invincible animal ID - Tier mit ID wieder verwundbar machen
- /abm gotoanimal ID - teleportiert dich zum Tier mit ID
- /abm goback - bringt dich zur letzten Position zurck (nach ein- oder mehrmaligem Aufruf von gotoanimal)
