doc/lfun/HitFunc

HitFunc()

FUNKTION:
     int HitFunc(object enemy);

DEFINIERT IN:
     eigenen Objekten, fuer /std/weapon/combat.c

ARGUMENTE:
     enemy
          Der Gegner, gegen den die Waffe eingesetzt wird.

BESCHREIBUNG:
     Die Waffe kann anhand des Gegners enemy entscheiden, ob ein
     Schadensbonus oder auch ein Schadensmalus wirksam wird. Dieser Bonus
     wird zu dem normalen Schaden der Waffe hinzuaddiert.

RUeCKGABEWERT:
     Der Schadensbonus bzw. der Abschlag.

BEMERKUNGEN:
     Wenn durch den Bonus die Genehmigungsgrenzen der Balance
     ueberschritten werden koennen, muss man seinen Regionsmagier und
     die Objekt-Balance konsultieren!

     Werte der HitFunc sollten immer ueber ein random() zurueckgegeben 
     werden!

     Diese Funktion sollte die Waffe nicht zerstoeren! Falls ihr im Kampf eine
     Waffe (ggf. in Abhaengigkeit vom Gegner) zerstoeren wollt, nutzt dazu
     bitte TakeFlaw(). 

BEISPIELE:
     Eine Waffe, die gegen Orks besonders gut wirkt:

     inherit "std/weapon";

     #include <properties.h>
     #include <combat.h>
     #include <class.h>

     create(){
       if(!clonep(this_object())) {
           set_next_reset(-1);
           return;
       }
       ::create();
       /* 
       zig SetProp's, um die Waffe zu konfigurieren
       HitFunc() ist in der Waffe selbst definiert 
       */
       SetProp(P_HIT_FUNC, this_object());
     }

     int HitFunc(object enemy)
     {
       /* laesst sich der Gegner als Ork ansprechen? */
       if (enemy->is_class_member(CL_ORC))
         return random(10+random(50)); /* Ja => Schaden erhoehen */

       return 0;   /* ansonsten keinen zusaetzlichen Schaden anrichten */
     }

SIEHE AUCH:
     QueryDefend(), /std/weapon.c
     TakeFlaw()
----------------------------------------------------------------------------
11.08.2007, Zesstra