vorlage.pl

ein Perl-Script von Georg Edelmayer und Frank Wolkwitz
_{Copyright 1998/2000/2001}

vorlage.pl erstellt eine erweiterte Zugvorlage aus dem normalen Eressea-Report (inklusive der darin enthaltenen Zugvorlage).

Verwendung:

perl vorlage.pl zugreport > ausgabefile

Erstellt aus der Auswertung zugreport eine erweiterte Zugvorlage und schreibt diese in die Datei ausgabefile.
zugreport kann beispielsweise die Datei ausw0711.txt sein, ausgabefile zum Beispiel zug0811.txt .

Voraussetzung: die Optionen VORLAGE und STATISTIK müssen im Report aktiviert sein (wie man das macht erfährt man aus der Eressea Dokumentation - Option Statistik - Option Zugvorlage).

Features

Es werden sowohl am Regionsanfang als auch bei den einzelnen Einheiten mehr Informationen geschrieben als sie die normale Vorlage enthält. Einheiten, die sich in Gebäuden oder Schiffen befinden werden durch Einrücken gekennzeichnet.
Zur einfacheren Verwaltung der Einheiten gibt es einige sogenannte Metabefehle, die das Script versteht und entsprechend interpretiert.

Copyright etc.

Das Skript ist Freeware im Sinne der Perl Definition. Teile der Gewichtsberechnung stammen aus einem Skript von Benni Bärmann, Henning Peters half bei der Reichweitenberechnung..
Ich danke Katharina, Harry und Frank Wolkwitz für ihre Ideen und Fehlermeldungen. Frank schrieb einen Teil dieser Dokumentation, auch dafür sei ihm gedankt.

Georg Edelmayer

Wir sind für Fehlermeldungen, Anregungen sowie jede andere Art von Rückmeldung an frank@vorlon.ruhr.de (insbesondere Nachricht, dass ihr das Skript verwendet) dankbar.

Frank Wolkwitz

_{letzte Änderung 19.10.2003 fwo -
letzte in dieser Anleitung berücksichtigte Version von Vorlage.pl: 70f8}

Regionsinformationen

Es wird eine kleine Karte der Umgebung (ca. 3x3 Felder) dargestellt. Sollte in der jeweils aktuellen Runde keine Einheit in einer der Nachbarregionen sein bzw. eine solche wurde nicht durchfahren, dann gibt es auch keine Anzeige der entsprechenden Region. Diese Minikarten ersparen zwar keine Gesamtkarte, erleichtern jedoch einen Zug leicht ohne ressourcenfressenden grafischen Client zu erstellen.
Es werden sowohl die im Report angegebene Anzahl von Luxusgütern zu konstanten Preisen als auch die sichere Menge (nach Abzug möglicher Rekrutierungen) ausgegeben.
Anzahl der in der Region vorhandenen Bauern, Pferde, des Bewuchses und des Silbers, Angabe des Lohnes für ECheck.

Beispiel:

REGION 111,-111 ; Wolkenheim , Ebene --------------------------------------
;                    D . .      Luxusgueter: 13, angegeben: 14
; ECheck Lohn 12    . + B       1405 Bauern, 80 Pferde, 22 Bäume, 206990 $,
;                  G W S

Schiffe

Es werden sowohl eigene als auch fremde Schiffe mit allen verfügbaren Informationen (Gewicht der eigenen Ladung, Bauzustand, Küste, Beschädigung) ausgegeben.
Sollte ein Schiff beschädigt sein, dann gibt es eine Zusatzauskunft über die verbleibenden Reichweiten.

Die Abkürzungen bedeuten folgendes:

m:

mm:

Beispiel:

;~~~ Titanik (7777), Karavelle, (50/3000), im Bau (50%)

EINHEIT 72; Schlemiel und seine Nasen [2,10$,S7777,KV,20.1GE,10.7GE]

// #rotate2 lern segeln

// #rotate1 unter

LERN SEGELN

; ~~~~~~~~~~~~~~~~~

Beispiel für Reichweite:

;~~~ Titanik (7777), Karavelle, (1759/2700), 10% beschädigt, Südostküste
;    m5 mm6
     ...........
;    ~~~~~~~~~~~~~~~~~

Einheiten

Jede Einheit bekommt Anzahl der Personen, Silber, eventuell Unterhaltspflicht bzw. Schiffsnummer, Kampfstatus, Erschöpfungsgrad, Eigengewicht und Transportkapazität und angezeigt.
Die private Beschreibung sowie alles was die Einheit hat wird ebenfalls vermerkt.
Die Kampfstati sind: KV, KH, KN, F
Sofern eine Einheit physisch durch Kampf oder Magie beeinflusst ist gibt es Angaben dazu:

MG, Ers,Ver, eVer,

magisch gestärkt, erschöpf, verwundet, ernsthaft (schwer) verwundet

Die Transportkapazität (Freie Kapazität) wird wird folgendermaßen angegeben:

10 GE Es sind 10GE frei. Die gilt für Fussgänger (1 Region) oder für Reiter mit genügend Pferden, um 2 Regionen weit zu reisen.
-10GE!! Die Einheit kann nicht weiter, weil sie 10GE zuviel geladen hat. Eine Einheit, die Pferde und Wagen hat und reiten kann, aber überladen ist wird auch so angegeben. Es wird nicht geprüft, ob die Einheit gehen könnte.
-50GE! Die Einheit hat Pferde und kann reiten, aber es sind so viele Pferde, daß man nur eine Region weit reisen kann.
!!Pf Die Einheit hat zuviele Pferde, um sich bewegen zu können.
Das Gewicht von Trollen sowie ihre Größere Tragkraft wird berücksichtigt, nicht aber die Tatsache, dass sie Wagen auch ziehen können

Ist eine Einheit Kapitän eines Schiffes, dann wird zusätzlich angegeben in welche Richtung das Schiff ablegen/weiterfahren kann. Hier wird berücksichtigt ob die Region einen Hafen hat, an welcher Kueste das Schiff liegt (oder ob es Ozean ist) und in welcher Nachbarregion Ozean ist (also ein weiterfahren überhaupt Sinn macht).

Beispiele:

EINHEIT 1111; Faehrmann [1,0$,S333,KN,Ers,50GE, -34.6GE!!]
; hat: 8 Hlz,

Die Einheit ist Kapitän des Schiffes 333, Kämpft nicht und ist 50 GE schwer, weil sie 8 Holzstämme hat. Gehen (reiten) ist nicht möglich, da sie um 34.6 GE überladen ist. Irgendwie kam es auch dazu, dass die Einheit erschöpft ist (wohl kaum vom rudern).

EINHEIT 7777;       Schmied [2,3727$,>U300+<,KV,159.27GE, -128.47GE!!]
;        hat: 16 Ei, 3 Khmd, 16 Sch,
Die Einheit ist die Erste in einer Schmiede, deshalb muss sie auch 300$ für den Unterhalt zahlen. Da außer Geld (in diesem Fall Holz) noch etwas zu zahlen ist, steht ein +.

EINHEIT 72;     Schlemiel und seine Nasen [2,10$,S7777,KV,20.1GE,10.7GE]
;Ablegen nach sw w nw möglich
// #rotate2 lern segeln
// #rotate1 unter
LERN SEGELN
Die Einheit ist Kapitän des Schiffes 7777 und das Schiff kann in die angegebenen Richtungen ablegen.

Metabefehle

Aus der Sicht des Eressea Auswertungsprogrammes sind die Metabefehle persistente Kommentare (die mit // eingeleitet werden).
Achtung, es gibt keinen Syntaxcheck der Metabefehle.

Ein Metabefehl wird immer mit // # eingeleitet. (Ausnahme #Tresor, Erklärung dazu siehe unten.)
Befehl ist einen langer Befehl, wenn in [] dann kann es auch kurzer Befehl sein.
Alternativbefehl ist ein langer Befehl.
In [] eingeschlossenes ist optional.
<n> bedeutet eine Zahl (nicht optional).
Je Einheit darf nur eine Metabefehlsart vorkommen.

Die Metabefehle und Beispiele

// #immer Befehl [:Befehl]...[:Befehl] Befehle werden jeden Monat ausgeführt - Einsatz z.B. bei regelmässiger Rekrutierung, aber auch um einfach zu sehen, dass hier dauernd was passiert.
// #immer arbeite : rekrutiere 10

// #mal<n> Befehl [:Befehl]...[:Befehl] Befehle werden n Monate ausgeführt, dann eine Hinweis generiert, neuen Befehl zu setzen.
// #mal3 lerne steuer

// #next<n> Befehl [:Befehl]...[:Befehl] Befehle werden in n Monaten ausgeführt. Anzuwenden falls die Aktionen für spätere Monate festliegen.
// #next2 mache speere
// #next3 mache schwerter : gib 12 15 speere
// #next4 mache lanzen : gib 21 10 schwerter

// #rotate<n> Befehl [:Befehl]...[:Befehl] Zirkulierende monatsweise Abarbeitung, nicht nur als Ersatz des route Befehls
// #rotate2 nach o s o s o s
// #rotate3 nach n n n : gib 12 15 speere
// #rotate4 nach s w s w s w
// #rotate5 arbeite
// #rotate1 nach o n n n w : gib 21 10 schwerter

// #forst <n> [n2][Alternativbefehl] Einheiten versuchen Baumbestand bei n bzw. zwischen n und n2 zu halten - nur sinnvoll mit Talent Holzfaellen.
// #forst 200 arbeite

// #herde <n> [n2][Alternativbefehl] Einheiten versuchen den Pferdebestand in einer Region bei n bzw. zwischen n und n2 zu halten - nur sinnvoll mit Talent Pferdedressur.
// #herde 0 arbeite

// #study<n> Talent [Alternativbefehl] Einheiten gleichem n in einer Region bilden eine Lernpyramide. Wenn nicht mit Lehrer gelernt werden kann, wird der Alternativbefehl ausgeführt. Gibt es keinen Alternativbefehl, wird ohne Lehrer gelernt. n muss pro Region einzigartig sein.
// #study123 hiebwaffen treibe

// #study Talent [Alternativbefehl] Einheiten innerhalb einer Region bilden Lernpyramiden für ein Talent. Eine Lehrer-Schüler Beziehung wird nur aufgebaut, falls sich die Einheitengrößen um den Faktor 10 unterscheiden.
Wenn nicht mit Lehrer gelernt werden kann, wird der Alternativbefehl ausgeführt. Gibt es keinen Alternativbefehl, wird ohne Lehrer gelernt.
// #study hiebwaffen lerne ausdauer

// #liefere <normale Angabe> Kein eigentlicher Metabefehl. Wenn sich eine zu beliefernde Einheit nicht in der aktuellen Region befindet, dann wird aus einem @gib ein // #liefere. Umgekehrt wird aus // #liefere wieder ein normales @gib sobald die Einheit in der gleichen Region ist. Das erspart Fehlermeldungen und erhöht die Übersichtlichkeit.

#forst, #herde und #study dürfen genau einmal (und auch nur eines davon), #rotate sollte mehr als einmal pro Einheit angegeben sein.
#liefere darf beliebig oft, auch in Kombination mit anderen Metabfehlen vorkommen.

Der #Tresor Metabefehl wird in die private Beschreibung eingefügt. Dies hat den Sinn, dass man auch im Report eine solche Einheit schnell erkennt. Bei Einheiten mit diesem Befehl wird eine Änderung in der Silbermenge registriert und entsprechend gemeldet. (Es handelt sich also eher um eine Art 'Metaberuf' als um einen 'Metabefehl'. Ist ganz nützlich wenn man irgendwo Botschafter hat und man nicht jedesmal kontrollieren will ob beklaut wurde.

#Tresor [Silber]# Bei der erstmaligen Definition kann man beschreibe privat "#Tresor#" verwenden, in den Folgemonaten wird immer die aktuelle Silbermenge eingesetzt. Es kann zusätzlich etwas vor und nach diesem Befehl in der privaten Beschreibung stehen.

`// #immer Befehl [:Befehl]...[:Befehl]`	Befehle werden jeden Monat ausgeführt - Einsatz z.B. bei regelmässiger Rekrutierung, aber auch um einfach zu sehen, dass hier dauernd was passiert. `// #immer arbeite : rekrutiere 10`
`// #mal<n> Befehl [:Befehl]...[:Befehl]`	Befehle werden `n` Monate ausgeführt, dann eine Hinweis generiert, neuen Befehl zu setzen. `// #mal3 lerne steuer`
`// #next<n> Befehl [:Befehl]...[:Befehl]`	Befehle werden in `n` Monaten ausgeführt. Anzuwenden falls die Aktionen für spätere Monate festliegen. `// #next2 mache speere` `// #next3 mache schwerter : gib 12 15 speere` `// #next4 mache lanzen : gib 21 10 schwerter`
`// #rotate<n> Befehl [:Befehl]...[:Befehl]`	Zirkulierende monatsweise Abarbeitung, nicht nur als Ersatz des `route` Befehls `// #rotate2 nach o s o s o s` `// #rotate3 nach n n n : gib 12 15 speere` `// #rotate4 nach s w s w s w` `// #rotate5 arbeite` `// #rotate1 nach o n n n w : gib 21 10 schwerter`
`// #forst <n> [n2][Alternativbefehl]`	Einheiten versuchen Baumbestand bei `n` bzw. zwischen `n` und `n2` zu halten - nur sinnvoll mit Talent `Holzfaellen`. `// #forst 200 arbeite`
`// #herde <n> [n2][Alternativbefehl]`	Einheiten versuchen den Pferdebestand in einer Region bei `n` bzw. zwischen `n` und `n2` zu halten - nur sinnvoll mit Talent `Pferdedressur`. `// #herde 0 arbeite`
`// #study<n> Talent [Alternativbefehl]`	Einheiten gleichem `n` in einer Region bilden eine Lernpyramide. Wenn nicht mit Lehrer gelernt werden kann, wird der Alternativbefehl ausgeführt. Gibt es keinen Alternativbefehl, wird ohne Lehrer gelernt. `n` muss pro Region einzigartig sein. `// #study123 hiebwaffen treibe`
`// #study Talent [Alternativbefehl]`	Einheiten innerhalb einer Region bilden Lernpyramiden für ein Talent. Eine Lehrer-Schüler Beziehung wird nur aufgebaut, falls sich die Einheitengrößen um den Faktor 10 unterscheiden. Wenn nicht mit Lehrer gelernt werden kann, wird der Alternativbefehl ausgeführt. Gibt es keinen Alternativbefehl, wird ohne Lehrer gelernt. `// #study hiebwaffen lerne ausdauer`
`// #liefere <normale Angabe>`	Kein eigentlicher Metabefehl. Wenn sich eine zu beliefernde Einheit nicht in der aktuellen Region befindet, dann wird aus einem `@gib` ein `// #liefere`. Umgekehrt wird aus `// #liefere` wieder ein normales `@gib` sobald die Einheit in der gleichen Region ist. Das erspart Fehlermeldungen und erhöht die Übersichtlichkeit.