blob: dbab5f7d7b7200a4c24ce0dccac1931fea3dcb8c [file] [log] [blame]
P_TMP_MOVE_HOOK
***************
********************* VERALTETE PROPERTY
****************************** * Diese Property ist veraltet. Bitte
nicht mehr in neuem Code nutzen. * **********************************
*************************************
NAME
====
P_TMP_MOVE_HOOK "move_hook"
DEFINIERT IN
============
/sys/new_skills.h
BESCHREIBUNG
============
Mindestens 3-elementiges Array ({zeitpunkt, objekt, funktion, ...}).
Die Funktion wird im 'objekt' mit den gleichen Parametern wie move()
nach der Abfrage auf P_NO_TPORT aufgerufen, wenn der 'zeitpunkt'
noch nicht ueberschritten ist. Wenn die Funktion etwas anderes als ein
5-elementiges Array ({dest, methods, direction, textout, textin})
oder -1 zurueckgibt, wird move() normal ausgefuehrt, ansonsten werden die
5 move-Parameter durch die Array-Eintraege ersetzt bzw. wird bei einem
Rueckgabewert von -1 das move() abgebrochen. In letzterem Fall ist
die Funktion dafuer verantwortlich, eine entspr. Meldung an den
Spieler auszugeben!
HINWEIS
=======
Falls man einem Spieler einen Move-Hook setzt, ist es ratsam, im
Move-Hook zu pruefen, ob das Spielerobjekt nach Abarbeitung der Hook-
Funktion noch lebt. Ansonsten wird ein doppeltes move() ausgefuehrt:
in den Todesraum und direkt wieder zurueck zur Leiche.
BEMERKUNGEN
===========
- Bitte das neuere Hooksystem (s. Manpage std/hooks) benutzen.
- falls die Zeit abgelaufen oder das Objekt zerstoert ist, wird die
Property auf 0 gesetzt
- vor dem Setzen immer auf die Existenz eines gueltigen Hooks
pruefen, einfaches Ueberschreiben fuehrt einerseits zu Fehlern
im Code anderer und ist andererseits unfair gegenueber ihnen
SIEHE AUCH
==========
Bewegung: move(L), NotifyMove(), PreventMove()
Hooks: P_TMP_DIE_HOOK, P_TMP_DEFEND_HOOK, P_TMP_ATTACK_HOOK
neue Hooks: std/hooks
08.12.2008, Zesstra