USAGE

// script Rekrutieren <AnzahlPersonen> [optionen]

DESCRIPTION

Früh im Scriptablauf wird der Einheit der Befehl REKRUTIEREN AnzahlPersonen gegeben und das dafür benötigte Silber als Rekrutierungskosten beim Materialpool beantragt.

Die dabei verwendete Prio ist default=900 (20070622) und kann per scripterOption gesetzt werden.

Bei nicht ausreichendem Silber zum vollständigen Rekrutieren bleibt die Unit unbestätigt.

OPTIONS

Soll maximal rekrutiert werden, kann statt <AnzahlPersonen> auch "max" angegeben werden. Es wird dann versucht, das Regionsmaximum an Rekruten zu rekrutieren. Dabei wird bei Orks auf die Verdopplung der möglichen Rekruten rücksicht genommen. (ab version 0.46)
Eine Prüfung des Silberbestandes und eine Rekrutierung in Abhängigkeit vom verfügbaren Silber ist nicht vorgesehen.

Option Wert Beschreibung
"regionsBestand" <Bauernanzahl> Es wird nur soweit rekrutiert, dass die angegebene Bauernanzahl als Regionsbestand nicht durch das Rekrutieren unterschritten wird.
// script Rekrutieren max regionsBestand=4001
"maxPersonen" <Anzahl> Es wird nur dann rekrutiert, wenn die Personenanzahl der Einheit am Anfang der Runde unter der angegebenen Anzahl liegt.
// script Rekrutieren max maxPersonen=100
"ConfirmLessRecruitment" <Wahrheitswert> Sollte nicht genügend Silber zur Verfügung stehen, wird eine reduzierte Anzahl an Rekruten angeworben, die Einheit bleibt aus diesem Grund nicht unbestätigt.
// script Rekrutieren max ConfirmLessRecruitment=ja
"tempAB" <Personenzahl> Überschreitet die Personenzahl in der Einheit am Anfang einer Runde den tempAB-Wert, wird eine neue TEMP Einheit erzeugt und dieser diese Personenzahl übergeben. Zusätzlich werden dieser TEMP-Einheit Befehle gegeben, die in den Kommentaren der REKRUTIERUNGseinheit mit // tempunit: gekennzeichnet sind.

// script Rekrutieren max regionsBestand=4000 tempAB=200
// tempunit:nach no
// tempunit:Benennen Einheit "Rekruten"
// tempUnit:// script GoTo -2,1

Der neuen TEMP Unit werden die 3 Befehle hinter // tempunit: gegeben.

Wichtig: FFTools2-script-Befehle können von der neu erstellten TEMP-Unit NICHT ausgeführt werden, aber für nächste Runde "mitgegeben" werden, wie oben der GOTO-Befehl.
Wichtig 2: Eressea verbietet das übergeben von Personen aus hungernden Einheiten. Soll eine neue TEMP-Einheit erstellt werden, aber die Einheit hungert, bleibt sie unbestätigt.
"tempSingleUnit" <Wahrheitswert> Neue Temp-Einheiten werden nich in der Stärke tempAB-Angabe erstellt, sondern maximal groß gewählt, sodaß mindestens eine Person in der Eineit erhalten bleibt
// script rekrutieren max RegionsBestand=2000 tempAB=1 tempSingleUnit=ja

"prio" <Priorität - Zahl> Die Priorität der Silberanforderung ist per default=900, kann per setScripterOption geändert werden und natürlich auch direkt als Parameter beim script-Befehl:
// script rekrutieren 100 prio=400

(ab Version 0.92 vom 11.02.2024)
"mode" <Schlüsselwort> Das Skript kann auf sehr spezielle vordefinierte Verhaltensmuster mit dem Parameter mode angepasst werden
EON
Mode=EON
Ein sehr seltsamer Modus, an dessen Existenz EON die Schuld trägt. Es wird versucht, die Anzahl an Personen in der Einheit um 2/3 der aktuellen Personenzahl zu erhöhen ohne dabei die Anzahl an Personen, die von den Bauern ernährt werden kann, zu überschreiten. Befindet sich die Einheit in einer Burg wird verhindert, dass diese durch Rekrutieren überfüllt wird. Hintergrund dieses Modus ist die Kombination mit ifSkill, da damit eine Verwässerung eines Talentwertes automatisiert werden kann. Wird auf einen Talentwert von 4 (ohne Rassenmodifikation) geprüft so hat die Einheit nach der Verwässerung auf jeden Fall noch einen Talentwert von 3. EON wollte dies nutzen, um Zwerge (Unterhaltung -1) die durch Anwendung von effektiv T2 (dem effizentesten Talentwert) auf effektiv T3 aufgestiegen sind automatisch zu verwässern.
Hinweis: der notwendige Parameter Anzahl muss aus formalen Gründen mit angegeben werden, obwohl sich die Anzahl tatsächlich anderweitig bestimmt (siehe oben).
// script rekrutieren 1 mode=EON

(ab Version 0.975 vom 28.04.2024)