doc/lfun/FindGroup

FindGroup()

FUNKTION:
    object*FindGroup(object pl,int who);

DEFINIERT IN:
    /std/spellbook.c

ARGUMENTE:
    pl
      Lebewesen, von welchem die Freunde oder Feinde in der Umgebung
      gefunden werden sollen.
    who
      Flag, welches anzeigt, ob Freunde oder Feinde gefunden werden
      sollen (Konstanten definiert in '/sys/new_skills.h'):
        FG_ENEMIES - (Wert -1) Feinde sollen gefunden werden
        FG_FRIENDS - (Wert  1) Freunde sollen gefunden werden
        FG_ALL     - (Wert  0) alle Lebewesen sollen gefunden werden

RUeCKGABEWERT:
    Array mit gefundenen Lebewesen

BESCHREIBUNG:
    Bei Spells, die sich auf mehrere Gegner auswirken oder bei denen man
    per Hand ein Opfer auswaehlen moechte, laesst sich mittels der
    Funktion FindGroup() eine Liste von Lebewesen ermitteln, welche in
    der Umgebung von <pl> zu finden sind.
    Je nachdem, was man denn genau vorhat, kann man sich von der
    Funktion freundlich oder feindlich gesinnte Lebewesen heraussuchen
    lassen.
    Will man die freundlich gesinnten Lebewesen ermitteln, so uebergibt
    man in <who> die Konstante FG_FRIENDS, bei feindlich gesinnten die
    Konstante FG_ENEMIES, und wenn man alle Lebewesen bekommen moechte
    schliesslich FG_ALL.
    Bei der Auswahl gelten folgende Regeln:
      (1) Lebewesen, mit denen <pl> im Kampf ist, sind grundsaetzlich
          feindlich gesinnt.
      (2) Teammitglieder von <pl> sind grundsaetzlich freundlich
          gesinnt.
      (3) Spieler sind gegenueber Spielern freundlich gesinnt, NPCs
          gegenueber NPCs. NPCs kann man hierbei mit Hilfe der Property
          P_FRIEND den Spielern zuordnen.
      (4) Daraus folgt natuerlich, dass Spieler und NPCs grundsaetzlich
          eine feindliche Einstellung gegenueber haben, sofern die NPCs
          nicht die Property P_FRIEND gesetzt haben
           (was standardmaessig natuerlich nicht der Fall ist).
      (5) Netztote werden nicht erkannt.
      (6) Magier werden nicht erkannt, wenn sie unsichtbar sind.
      (7) Ein Magier wird als feindlich gesinnt nur dann erkannt, wenn
          <pl> mit ihm im Kampf ist.
      (6) Sucht man feindlich gesinnte Lebewesen, so werden die, welche
          eine von den Properties P_NO_ATTACK oder P_NO_GLOBAL_ATTACK
          gesetzt haben, nicht erkannt.
    Die Property P_FRIEND sollte man in NPCs setzen, die dem Spieler
    hilfreich beiseite stehen, z.B. vom Spieler beschworene HilfsNPCs.

BEISPIELE:
    Wenn man einen Feuerball nach jemandem wirft, so trifft dieser unter
    Umstaenden auch andere, wenn er gross genug ist. Man nimmt hierbei
    an, dass sich die freundlich gesinnten Lebewesen des Gegners auch
    naeher bei ihm befinden als die feindlich gesinnten:
      victim->Defend(500,DT_FIRE,([SP_SHOW_DAMAGE:1]),caster);
      victimList=FindGroup(victim,FG_FRIENDS);
      map_objects(victimList,
                      "Defend",
                      100,
                      DT_FIRE,
                      ([SP_SHOW_DAMAGE:1]),
                      caster);
    Hiermit trifft man also auch die Freunde von <victim>.

SIEHE AUCH:
    FindGroupN(), FindGroupP(), P_FRIEND, P_NO_GLOBAL_ATTACK

----------------------------------------------------------------------------
Last modified: Mon Jan 28 21:45:00 2002 by Tiamak