ANIMALBOOST 1.0.3.1 - AUSFUEHRLICHE ANLEITUNG (DEUTSCH)
=======================================================

1. WAS IST ANIMALBOOST?
----------------------
AnimalBoost ist ein Lua-Skriptmod fuer den Landwirtschafts-Simulator 25 auf PC/Mac.
Er veraendert je Tierart den Verbrauch von Futter, Wasser und Stroh sowie die
Produktion von Mist, Guelle, Milch und Palettenerzeugnissen (z. B. Eier und Wolle).
Die Berechnungen erfolgen auf dem Server/Host, Lagerstaende synchronisiert das Spiel.
Die Multiplikatoren werden bei Multiplayerbeitritt per Client-Anfrage vom Server gesendet.

NEU IN VERSION 1.0.3.0:
- Wasserbueffel auch dann als eigene Tierart erkennen, wenn die Unterart
  als COW_WATERBUFFALO, BULL_WATERBUFFALO oder Breed WATER_BUFFALO vorliegt.
- Sie werden NICHT automatisch mit normalen Kuehen zusammengefasst.
- Futter, Stroh, Mist, Guelle und Bueffelmilch getrennt einstellbar.
- Befehl abAnimals listet alle im Spielstand erkannten Tier-Unterarten.
- Die Multiplayer-Event-Struktur bleibt unveraendert.

WICHTIG AUS VERSION 1.0.2.0:
- Vorher wurden vorhandene Werte nur multipliziert. Bei Huehnern ist Stroh im
  Originalspiel nicht vorhanden. 0 x beliebig = 0. Deshalb konnte Stroh im
  Huebnerstall trotz Straw-Spezialisierung ungenutzt bleiben.
- Es gibt jetzt zusaetzliche Grundraten pro Tier und Tag, die das Verhalten bei
  sehr kleinen oder fehlenden Tierkurven anpassen.
- Die Raten werden direkt NACH den Originalberechnungen der GIANTS-Tierstall-
  Spezialisierungen modifiziert. Das ist robuster als zusaetzliche Listener an
  bereits geladene Staelle anzumelden.
- Zusaetzlicher Server-Konsolenbefehl abStatus zur Diagnose.

WICHTIG: AnimalBoost ERZEUGT KEINEN neuen Stroh-Abladepunkt und KEIN neues
Strohlager. Er erhoeht nur Strohverbrauch in Staellen, die die regulaere
husbandryStraw-Spezialisierung und ein funktionsfaehiges STRAW-Lager besitzen.
Stallmods mit voellig eigenen Strohscripten benoetigen eine extra Integration.
Wenn ein Stall kein STRAW-Lager kennt, wird kein Stroh abgezogen.


KOMPATIBILITAET: FS25_Chicken_Fattening_Pack.zip (Version 1.0.0.1)
-------------------------------------------------------------------
Aus der Pruefung der 3 Stall-XMLs:
- 1250 Hühner: Strohlager 50.000 L, Futterlager 80.000 L
- 2500 Hühner: Strohlager 80.000 L, Futterlager 140.000 L
- 5000 Hühner: Strohlager 100.000 L, Futterlager 200.000 L
- Alle Ställe nutzen den Typ PoultryHusbandry mit husbandryStraw.
- Ihre Mistlager haben 0 Liter Kapazitaet im Hauptstall. Um Mist zu sammeln,
  muss ein kompatibler Misthaufen / der Mistausgabe-Anbau DIREKT am Stall
  stehen (und die Stall-Verbindung muss im Spiel funktionieren).
- Der Stall-Mod weist darauf hin, dass die Tierart CHICKEN normalerweise
  keine Stroh-/Mistkurven hat und darum mapseitige animals.xml-Anpassungen
  erwartet. AnimalBoost setzt die fehlenden Raten zur Laufzeit an den bereits
  vorhandenen Stroh-/Mist-Spezialisierungen. Die Map und der Stall-Mod selbst
  werden NICHT veraendert. Ein Ingame-Test ist weiterhin noetig.

BEISPIEL MIT DEN HUEHNER-VORGABEN (volle Stallkapazitaet, pro Spieltag):
  Tierzahl | Futter mindestens | Stroh mindestens | Mist mindestens*
     1250  |      6250 L       |      5625 L      |     1250 L
     2500  |     12500 L       |     11250 L      |     2500 L
     5000  |     25000 L       |     22500 L      |     5000 L
* Mist nur bei Strohversorgung, genug Futter und nutzbarem Mistlager;
  das Spiel kann reale Mengen aufgrund seiner Produktionsfaktoren reduzieren.
  Die Mindestangaben beziehen sich auf die berechnete Sollrate, nicht auf
  garantierte tatsaechliche Lagerstandsaenderungen.

FEHLERSUCHE BEI DIESEN STÄLLEN:
- Beide Mods muessen aktiviert sein. Der Server muss die neueste AnimalBoost
  nutzen. Alte modSettings/FS25_AnimalBoost.xml pruefen.
- 24 Spielstunden bei Fuellung vergleichen, oder einen groesseren Zeitraum
  vorspulen und vorher/nachher dokumentieren.
- Serverkonsole: abStatus. Bei chicken=true und straw>0 L/h ist die
  Berechnung aktiv. Steht straw=0 trotz Hühnern, log.txt einsenden.
- Ohne angebauten Misthaufen/Stall-Erweiterung kann Mist trotz positiver
  Sollrate nicht im Stall gesammelt werden.
- Dedizierter Server: Konfig auf dem Server aendern, abReload oder Neustart.
- MP: Client fordert beim Beitritt per SyncEvent die Serverkonfiguration an;
  nur der Server berechnet und verbucht die Raten.

2. INSTALLATION
---------------
- FS25_AnimalBoost.zip OHNE Entpacken in deinen FS25-mods-Ordner legen.
- In der Modauswahl beim Spielstand AnimalBoost aktivieren.
- Bei einem Dedicated Server muss derselbe Mod auf dem Server installiert sein;
  Mitspieler brauchen denselben Modstand wie der Server.
- Wenn eine aeltere FS25_AnimalBoost.zip vorhanden ist: ersetzen, nicht zwei
  Versionen gleichzeitig installieren.
- Bestehende Spielstaende koennen weiterbenutzt werden. Vorher Sicherung
  des Savegames anfertigen.

3. EINSTELLUNGEN: SERVER/LOCAL HOST
----------------------------------

AKTUELLE MITGELIEFERTE KONFIGURATION (Version 1.0.3.1):
Die Datei config/AnimalBoost.xml wurde aus der bereitgestellten XML uebernommen.
Diese Werte sind KEINE Festwerte: Sie koennen pro Tierart angepasst werden.
  COW:          food 5.0, water 2.0, straw 4.5, manure 5.0, slurry 5.0, milk 2.5
  WATERBUFFALO: food 5.5, water 3.0, straw 5.0, manure 5.5, slurry 5.5, buffaloMilk 2.5
  PIG:          food 4.0, water 2.0, straw 5.0, manure 5.5, slurry 5.0
  SHEEP:        food 3.0, water 1.0, straw 4.0, manure 4.5, wool 2.0, pallets 2.0
  GOAT:         food 2.0, water 1.0, straw 2.0, manure 2.0, goatMilk 2.0, pallets 2.0
  CHICKEN:      food 5.0, water 1.0, straw 3.0, manure 3.5, eggs 2.5, pallets 2.0
                foodMinimum 1.0, strawMinimum 1.5, manureMinimum 0.5
  HORSE:        food 2.0, water 1.0, straw 2.0, manure 2.0, pallets 2.0
  OTHER:        food 2.0, water 1.0, straw 2.0, manure 2.0, slurry 2.0,
                milk 2.0, goatMilk 2.0, buffaloMilk 2.0, eggs 2.0, wool 2.0, pallets 2.0

WICHTIG BEI BESTEHENDER SERVER-INSTALLATION:
Eine schon vorhandene modSettings/FS25_AnimalBoost.xml UEBERSCHREIBT immer
config/AnimalBoost.xml aus der ZIP. Die Werte aus der neuen ZIP gelten also
nur direkt, wenn keine eigene Server-Datei existiert. Um die neuen Werte
sicher zu aktivieren, vorhandene Server-Datei sichern und durch die
mitgelieferte/extra bereitgestellte FS25_AnimalBoost.xml ersetzen.
Danach den Server neu starten oder den Konsolenbefehl abReload ausfuehren.

Die Vorlage liegt INNERHALB der ZIP bei:
  config/AnimalBoost.xml

Fuer eigene Werte die Vorlage aus der ZIP herauskopieren und auf dem HOST nach
  modSettings/FS25_AnimalBoost.xml
legen. Das Verzeichnis 'modSettings' befindet sich unter dem FS25-Profilpfad
(neben dem mods-Ordner). Fehlt der Ordner, neu anlegen. Bei einem Dedicated
Server ist der Profilpfad des SERVER-PROZESSES entscheidend.

Wenn die Datei unter modSettings existiert, HAT SIE VORRANG vor der Vorlage
in der ZIP. Das gilt auch fuer eine alte Konfiguration aus v1.0.0.0.
Somit: Wenn zuvor in der alten Datei CHICKEN food="2.0" steht, ist auch in
der Wert 2.0 aktiv, bis DU ihn in der Serverdatei aenderst.

Die Felder einer Zeile lassen sich einzeln fuer jede Tierart setzen:
- food        Futterverbrauch-Faktor
- water       Wasserverbrauch-Faktor
- straw       Strohverbrauch-Faktor
- manure      Mistproduktions-Faktor (nur bei moeglicher Mistproduktion)
- slurry      Guelleproduktions-Faktor
- milk        normale Milch
- goatMilk    Ziegenmilch
- buffaloMilk Bueffelmilch
- eggs        Eier
- wool        Wolle
- pallets     andere Palettenerzeugnisse
- foodMinimum    Mindest-Grundrate Futter pro Tier und Spieltag in Litern
- strawMinimum   Mindest-Grundrate Stroh pro Tier und Spieltag in Litern
- manureMinimum  Mindest-Grundrate Mist pro Tier und Spieltag in Litern

Faktoren: 1.0 = unveraendert; 2.0 = doppelt; 5.0 = fuenffach; 0.0 = kein
Verbrauch/Output fuer diesen Kanal. Erlaubter Bereich 0 bis 100.
Mindest-Grundraten: 0 = nur Originalkurve; 1.5 = mind. 1.5 Liter je Tier/Tag
VOR Multiplikation. Minimum ist KEINE zusaetzliche Menge neben der Tierkurve.
Beispiel: Original 0.2, Minimum 1.0, Multiplikator 5.0 => 5.0 L/Tier/Tag.
Beispiel: Original 4.0, Minimum 1.0, Multiplikator 5.0 => 20.0 L/Tier/Tag.

4. WASSERBUEFFEL UND BUEFFELMILCH
-----------------------------------
Wasserbueffel sind im LS25 Unterarten der Rinder. Der Mod erkennt explizit
  COW_WATERBUFFALO, BULL_WATERBUFFALO, WATER_BUFFALO und BUFFALOMILK.
Auch bei gemischten Rinder-/Bueffelstaellen werden die Tierzahlen je nach
Unterart mit ihren eigenen Faktoren gewichtet, nicht nur nach Stalltyp.

Die Zeile fuer Wasserbueffel in der Serverkonfiguration lautet z. B.:
  <animal type="WATERBUFFALO" food="5.5" water="3.0" straw="5.0"
          manure="5.5" slurry="5.5" buffaloMilk="2.5" />
Diese Werte stammen aus der bereitgestellten Konfigurationsdatei.
In der mitgelieferten Konfiguration gelten fuer Wasserbueffel:
  food=5.5, water=3.0, straw=5.0, manure=5.5, slurry=5.5, buffaloMilk=2.5.
Es funktionieren type="WATERBUFFALO" und als Alias type="WATER_BUFFALO".

WICHTIG: Bereits vorhandene Dateien modSettings/FS25_AnimalBoost.xml haben
Vorrang vor der mitgelieferten Vorlage. Falls deine alte Datei keine Zeile
fuer Wasserbueffel enthaelt, diesen Eintrag ergaenzen.

Zur Diagnose nach dem Serverstart abAnimals in der SERVER-Konsole ausfuehren.
Die Server-log.txt zeigt erkannte Tier-Unterarten und ihre Kennungen.
Bei einem Wasserbueffelbestand soll 'erkannt=WATERBUFFALO' erscheinen.
Wenn dort nur COW oder OTHER steht, den entsprechenden Logauszug bereitstellen.

5. STANDARDEINSTELLUNGEN FUER HUEHNER
-----------------------------------
<animal type="CHICKEN" food="5.0" water="1.0" straw="3.0"
        manure="3.5" eggs="2.5" pallets="2.0"
        foodMinimum="1.0" strawMinimum="1.5" manureMinimum="0.5" />

Damit gilt fuer 100 Huehner (sofern der Stall die Fuelltypen unterstuetzt):
- Mindestens 500 Liter Futter pro Spieltag (100 x 1.0 x 5.0).
- Mindestens 450 Liter Stroh pro Spieltag (100 x 1.5 x 3.0).
- Mindestens 100 Liter Mist pro Spieltag, falls Mistlager und -produktion
  aktiv sind UND Stroh vorhanden ist (100 x 0.5 x 2.0).
Wenn die Tierkurve hoehere Grundwerte hat, fallen die Ergebnisse hoeher aus.
Futterverbrauch und Strohverbrauch haengen ausserdem von verfuegbaren Vorraten
und den normalen LS25-Produktionsbedingungen ab.

Mehrverbrauch einstellen:
- CHICKEN food="8.0" steigert Futter deutlich.
- CHICKEN foodMinimum="3.0" setzt ein groesseres Basismindestniveau.
- CHICKEN straw="5.0" und strawMinimum="3.0" => mindestens 15 L je
  Huhn und Spieltag, wenn der Stall die Strohfunktion besitzt.

6. STROH BEI MOD-HUEHNERSTAELLEN
-------------------------------
Das Grundspiel hat normalerweise keine Tierkurven fuer Huehnerstroh/-mist.
Damit AnimalBoost das vorhandene Stroh aus einem Mod-Stall verbrauchen kann:
 a) Der Stall benoetigt die regulaere husbandryStraw-Spezialisierung.
 b) Im Stall muss STRAW als echtes, nutzbares Lagergut eingetragen sein.
 c) Es muessen lebende Tiere im Stall sein; die Tierzahl wirkt auf den
    Verbrauch. Stroh muss im Lager vorhanden sein.
 d) Fuer Mist muss ausserdem ein MANURE-Lager bzw. Mist-Anbindung vorhanden
    und die Mistproduktion im Stall aktiviert sein.

AnimalBoost erhoeht nicht automatisch die Lagerkapazitaet und erfindet keinen
neuen Strohabladepunkt. Ohne Unterstuetzung im konkreten Stall hilft nur eine
gezielte Anpassung des jeweiligen Stallmods. Bitte zur Diagnose in diesem
Fall dessen ZIP oder die Stall-XML sowie die FS25-log.txt bereitstellen.

7. MEHRSPIELER UND DEDICATED SERVER
----------------------------------
- Die XML-Konfiguration wird nur auf Server/Host geladen.
- Der Client erhaelt die Einstellwerte beim Beitritt per Event.
- Der Verbrauch bzw. die Produktion wird nur vom Server berechnet.
- Die Veraenderungen der Fuellstaende werden vom normalen LS25 synchronisiert.
- Nach Aenderungen der XML den Server neu starten oder in der Hostkonsole
  den Befehl 'abReload' ausfuehren. Dadurch werden auch alle bereits
  verbundenen Clients ueber neue Multiplikatoren informiert.

8. PRUEFUNG INGAME / FEHLERSUCHE
--------------------------------
1) Ein Stall mit Huehnern und etwas Futter und Stroh ausstatten.
2) Konsole am SERVER/HOST aktivieren. Je nach Einstellung ueber game.xml:
     <development><controls>true</controls></development>
3) In Konsole 'abStatus' eingeben: Fuer jeden Stall werden aktuelle
   Futter- und Strohraten (L/h) und 'straw storage true/false' geloggt.
   'false' bedeutet: Dieser Stall bietet das benoetigte STRAW-Lager nicht an.
4) LS25 einige Ingame-Stunden laufen lassen. Bei ausreichend Vorrat sollte
   der Strohbestand in passenden Huehnerstaellen abnehmen.
5) Fuer Konfigurationsaenderungen 'abReload' ausfuehren.
6) Fuer Wasserbueffel auch 'abAnimals' ausfuehren, um die Zuordnung zu pruefen.
7) In log.txt nach '[AnimalBoost]' und eventuell 'Error' suchen.

Wenn gar kein Futter zusaetzlich verbraucht wird:
- Die Serverdatei modSettings/FS25_AnimalBoost.xml auf alte CHICKEN-Werte
  pruefen (die alte Datei ueberschreibt die neue Vorlage).
- Auf korrekten Tierarten-Eintrag (type="CHICKEN") achten.
- Bestehende Stallbestandswerte mit 'abStatus' pruefen.
- Manche Mod-Staelle verwenden eigene Futter-/Strohsysteme; dann kann eine
  Anpassung an den konkreten Mod erforderlich sein.

9. TIERARTEN UND EINSCHRAENKUNGEN
--------------------------------
Unterstuetzt werden COW, WATERBUFFALO, PIG, SHEEP, GOAT, CHICKEN, HORSE, OTHER.
Wasserbueffel und Ziegen werden vorrangig anhand Unterart, Breed oder Fuelltyp
und erst danach anhand der allgemeinen Tiergruppe zugeordnet.
Bei ungewoehnlichen Tierbezeichnungen wird OTHER verwendet.

Bei Mod-Staellen mit eigenen Spezialroutinen koennen die normalen LS25-Raten
umgangen werden. AnimalBoost kann unbekannte eigene Skripte nicht allgemein
beeinflussen. Dieser Mod erzeugt niemals Lagerkapazitaeten fuer neue Fuelltypen.
Fuer die Produktion gelten zusaetzlich die Spielbedingungen wie Futtervorrat,
Produktivitaet, vorhandene Lager, freien Platz und ggf. Anbau von Mistsilos.

10. TECHNIK, KOMPATIBILITAET UND VERSION
---------------------------------------
Moddateiname: FS25_AnimalBoost.zip
Modname: AnimalBoost
Version: 1.0.3.1
modDesc descVersion: 111
Lua: scripts/AnimalBoost.lua, scripts/AnimalBoostSyncEvent.lua
Konfigurations-Vorlage: config/AnimalBoost.xml
Keine Veraenderung an Tierbestaenden, keine zusaetzliche Lagerbefuellung,
keine neuen Stroh-Triggers oder automatische Veraenderung fremder Moddateien.

11. WICHTIG ZUM TESTSTATUS
--------------------------
Die Moddateien lassen sich strukturell und mit simulierten Lua-Objekten pruefen.
Ein echter Test in einer FS25-Partie und auf eurem Dedicated Server muss
anschliessend erfolgen. Erstelle daher eine Spielstand-Sicherung, kontrolliere
die Server-log.txt und teste euren konkreten Huehnerstall.

ModDesc: descVersion=111 (unveraendert).
Update 1.0.3.1: Konfigurationswerte aktualisiert, Multiplayer-Lua unveraendert.
