API1:Ereignisse

Aus AntMe! Wiki
Wechseln zu: Navigation, Suche

Ereignisse stellen verschiedene Auslöser im Leben einer einzelnen Ameise dar. Sie erlauben es Code zu hinterlegen, mit dem auf diese Ereignisse reagiert werden kann. Ein Ereignis könnte zum Beispiel "Sieht Zucker" sein. Darauf könnte die Ameise dann mit dem Befehl "Gehe zu Zucker" reagieren.

Fortbewegung

Um die Ameise grundsätzlich in Bewegung zu setzen, braucht es Ereignisse, die ohne Zusammenhang zur Umgebung auftreten.

Ereignis Kurzbeschreibung
Wartet Wenn die Ameise keinerlei Aufträge hat, wartet sie auf neue Aufgaben. Um dir das mitzuteilen, wird diese Methode hier aufgerufen.
WirdMüde Erreicht eine Ameise ein drittel ihrer Laufreichweite, wird diese Methode aufgerufen.
IstGestorben Wenn eine Ameise stirbt, wird diese Methode aufgerufen. Man erfährt dadurch, wie die Ameise gestorben ist. Die Ameise kann zu diesem Zeitpunkt aber keinerlei Aktion mehr ausführen.
Tick Diese Methode wird in jeder Simulationsrunde aufgerufen - ungeachtet von zusätzlichen Bedingungen. Dies eignet sich für Aktionen, die unter Bedingungen ausgeführt werden sollen, die von den anderen Methoden nicht behandelt werden.

Nahrung

Ereignisse, die im Zusammenhang mit Nahrungsmitteln eintreffen. Einerseits beim Erspähen von Dingen, andererseits beim Erreichen dieser.

Ereignis Kurzbeschreibung
Sieht(Obst) Sobald eine Ameise innerhalb ihres Sichtradius einen Apfel erspäht wird diese Methode aufgerufen. Als Parameter kommt das betroffene Stück Obst.
Sieht(Zucker) Sobald eine Ameise innerhalb ihres Sichtradius einen Zuckerhügel erspäht wird diese Methode aufgerufen. Als Parameter kommt der betroffene Zuckerghügel.
ZielErreicht(Obst) Hat die Ameise ein Stück Obst als Ziel festgelegt, wird diese Methode aufgerufen, sobald die Ameise ihr Ziel erreicht hat. Ab jetzt ist die Ameise nahe genug um mit dem Ziel zu interagieren.
ZielErreicht(Zucker) Hat die Ameise eine Zuckerhügel als Ziel festgelegt, wird diese Methode aufgerufen, sobald die Ameise ihr Ziel erreicht hat. Ab jetzt ist die Ameise nahe genug um mit dem Ziel zu interagieren.

Kommunikation

Diese Ereignisse behandeln Situationen, die mit der Interaktion mit anderen Ameisen zu tun haben.

Ereignis Kurzbeschreibung
RiechtFreund(Markierung) Markierungen, die von anderen Ameisen platziert werden, können von befreundeten Ameisen gewittert werden. Diese Methode wird aufgerufen, wenn eine Ameise zum ersten Mal eine befreundete Markierung riecht.
SiehtFreund(Ameise) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus dem eigenen Volk, so wird diese Methode aufgerufen.
SiehtVerbündeten(Ameise) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus einem befreundeten Volk (Völker im selben Team), so wird diese Methode aufgerufen.

Kampf

Leider muss manchmal auch gekämpft werden. Diese Ereignisse treffen ein, wenn Feinde erspäht werden oder die Ameise in einen Kampf verwickelt wird.

Ereignis Kurzbeschreibung
SiehtFeind(Ameise) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Ameise aus einem feindlichen Volk, so wird diese Methode aufgerufen.
SiehtFeind(Wanze) So wie Ameisen unterschiedliche Nahrungsmittel erspähen können, entdecken Sie auch andere Spielelemente. Entdeckt die Ameise eine Wanze, so wird diese Methode aufgerufen.
WirdAngegriffen(Ameise) Es kann vorkommen, dass feindliche Lebewesen eine Ameise aktiv angreifen. Sollte eine feindliche Ameise angreifen, wird diese Methode hier aufgerufen und die Ameise kann entscheiden, wie sie darauf reagieren möchte.
WirdAngegriffen(Wanze) Es kann vorkommen, dass feindliche Lebewesen eine Ameise aktiv angreifen. Sollte eine Wanze angreifen, wird diese Methode hier aufgerufen und die Ameise kann entscheiden, wie sie darauf reagieren möchte.

Kasten

Der Bereich der Kasten betrifft Methoden, die zur Auswahl und Steuerung der Kasten dienen.

Ereignis Kurzbeschreibung
BestimmeKaste Jedes mal, wenn eine neue Ameise geboren wird, muss ihre Berufsgruppe bestimmt werden. Das kannst du mit Hilfe dieses Rückgabewertes dieser Methode steuern.