Jutta's Vorlage Tutorial für Anfänger

Hier gibt es ein kleines Tutorial für Programmierunerfahrene um Vorlage als kleinen Helfer einzusetzen:

Um Vorlage zu benutzen sollte man sich auf dieser Seite informieren: Vorlage starten

Dieses Tutorial richtet sich hauptsächlich an Magellan Benutzer.

---

Task One: Unterhalter sollen die Klappe halten

Als erstes ist es für mich als Magellanbenutzer am wichtigsten, dass nicht mehr alle Einheiten bestätigt werden müssen.
Zum Beispiel brauche ich dringend einen Unterhalter der Geld ranschafft und sich ansonsten ruhig verhält.

Um Einheiten automatisch zu bestätigen kann ich in die Befehle der Einheit einen tag einfügen der dann durch Magellan erkannt wird:

Befehle der EINHEIT gobo

unterhalten
// #tag EINHEIT ejcOrdersconfirmed 1 

Alle Vorlage Befehle die man direkt in die Befehle der Einheiten schreibt starten mit //

Wenn ich nun Vorlage über meine cr Datei laufen lasse wird diese Einheit in Magellan schon bestätigt.
Da das aber viel zu viel zu viel zu tippen ist müssen wir das ganze wohl noch etwas verbessern.

Bestimmte Prozeduren, die man immer wieder verwenden möchte speichert man in einer externen Datei und lässt Vorlage dann über die Option '-o file' diese Datei benutzen. Das ganze geht auch direkt in Magellan in den Vorlageoptionen, dort kann man ebenfalls die verwendete Datei angeben.

Ich nenne meine Datei jvorlage.txt und füge dort mal eine Prozedur ein um das leidige Bestätigen los zu werden:

jvorlage.txt

#proc j 
{ 
    #tag EINHEIT ejcOrdersconfirmed 1 
}

'#proc' bezeichnet eine Prozedur, der Name der Prozedur lautet in diesem fall j und es werden keine Parameter erwartet, dazu später mehr. Wichtig ist es dabei auf die Zeilen zu achten. #proc steht in der ersten Zeile und dann kommen in der nächsten Zeile die Klammern und der Programmtext.

Oder so...:

#proc j
{ #tag EINHEIT ejcOrdersconfirmed 1 }

Dann hat man etwas Platz gespart.

Nun kann ich diese Prozedur, die dafür sorgt, dass meine Einheiten bestätigt werden in allen Einheiten benutzen die das brauchen können. Aufgerufen werden Prozeduren mit #call:

EINHEIT gobo

// #call j
unterhalten

Das ganze lässt sich aber sicher nochmal verbessern. Eine Prozedur aus der jvorlage.txt Datei kann in der selben Datei auch wieder benutzt werden.

Also warum schreiben wir nicht gleich eine Prozedur die sich nur um das Unterhalten kümmert:

jvorlage.txt

#proc ju
{
    unterhalten
    #call j
}

#proc j
{ #tag EINHEIT ejcOrdersconfirmed 1 }

und verwenden die in unseren Befehlen

EINHEIT gobo

#call ju
lernen unterhaltung

Diese Einheit lernt jetzt einmal Unterhaltung und wird dann immer bestätigt und unterhält. Na sauber. Endlich Ruhe vor diesen nervigen Unterhaltern.

Nur was machen, wenn diese Einheit so viel Silber anhäuft, dass sie versucht ist nach Vegas abzuhauen. Da muss man was machen...

jvorlage.txt

#proc jug $gibsmir
{
    #call ju
    gib $gibsmir alles silber
}

#proc j
{ #tag EINHEIT ejcOrdersconfirmed 1 }

oder jvorlage.txt

#proc jug $gibsmir
{
    unterhalten
    #call j
    gib $gibsmir alles silber
}

Ich lasse das #proc j ab jetzt mal weg... oki!

Hier benutzen wir das erste mal einen Parameter. Die Parameter sind durch das Dollarzeichen gekennzeichnet. Passt hier ja sehr gut, geht ja um Knete. Beim Aufruf in den Befehlen gebe ich als Parameter dann die gewünschte Einheit an. In der Prozedur jug rufe ich ju wieder auf, ju sorgt für das Unterhalten und das Bestätigen

EINHEIT gobo

#call jug gob1
unterhalten

Die Einheit wird nun Bestätigt, Unterhält und gibt alles Silber an gob1 ab. Sehr löblich das Ganze.

Was passiert aber nun wenn gob1 gerade woanders ist? Ich glaube wir ändern das nochmal...

jvorlage.txt

#proc jug $gibsmir
{
    #ifunit $gibsmir { gib $gibsmir alles silber }
    #call ju
}

Jetzt wird mit dem Befehle #ifunit überprüft ob die gewünschte Einheit überhaupt da ist... (oder genauer ob sie gesehen wird...) erst dann wird der Teil in der Klammer ausgeführt. Der Aufruf ist natürlich gleich geblieben... Gut ne... muss ich in den Befehlen gar nix ändern.

Machen wir das nochmal besser. Ich will auch noch angeben wieviel Silber die Einheit behält. Die muss ja auch leben...

jvorlage.txt

#proc jugb $gibsmir $behalten
{
    ;wir rechnen mal aus was die Einheit so über hat
    $silberueber=unit.silber-$behalten
    #ifunit $gibsmir { #if $silberueber>0 { gib $gibsmir $silberueber } }
    #call ju
}

Zuerst habe ich mal einen Kommentar eingefügt damit ich in 2 Jahren noch weiss was ich da gemacht habe...
Das Silber was ich über habe ist genau das Silber was ich habe (unit.silber) minus den Teil den ich behalten möchte.
Wenn das ganze negativ sein sollte habe ich wohl nix zu verschenken.
Dieses mal verwende ich zwei if-Bedingungen. Einmal wird getestet ob die Einheit gibsmir da ist und zweitens ob die Einheit die jugb aufruft selber 'silberueber' hat ;)
Mit dem Aufruf von UNIT kann ich ziemlich viele Dinge über eine Einheit rausfinden. Die Silbermenge rauszufinden war nur eine kleine Sache.

EINHEIT gobo

#call jugb gob1 100
unterhalten

gobo wird Bestätigt, Unterhält und gibt alles Silber über 100 an gob1 (wenn gob1 gesehen wird)

Ich hoffe das war hilfreich... Jutta

EINHEIT