blob: 2b9212e07f78e9b3c46df77ba62818bc91fa18b4 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001P_TMP_MOVE_HOOK
2===============
3
4********************* VERALTETE PROPERTY ******************************
5* Diese Property ist veraltet. Bitte nicht mehr in neuem Code nutzen. *
6***********************************************************************
7
8NAME
9----
10::
11
12 P_TMP_MOVE_HOOK "move_hook"
13
14DEFINIERT IN
15------------
16::
17
18 /sys/new_skills.h
19
20BESCHREIBUNG
21------------
22::
23
24 Mindestens 3-elementiges Array ({zeitpunkt, objekt, funktion, ...}).
25 Die Funktion wird im 'objekt' mit den gleichen Parametern wie move()
26 nach der Abfrage auf P_NO_TPORT aufgerufen, wenn der 'zeitpunkt'
27 noch nicht ueberschritten ist. Wenn die Funktion etwas anderes als ein
28 5-elementiges Array ({dest, methods, direction, textout, textin})
29 oder -1 zurueckgibt, wird move() normal ausgefuehrt, ansonsten werden die
30 5 move-Parameter durch die Array-Eintraege ersetzt bzw. wird bei einem
31 Rueckgabewert von -1 das move() abgebrochen. In letzterem Fall ist
32 die Funktion dafuer verantwortlich, eine entspr. Meldung an den
33 Spieler auszugeben!
34
35HINWEIS
36-------
37::
38
39 Falls man einem Spieler einen Move-Hook setzt, ist es ratsam, im
40 Move-Hook zu pruefen, ob das Spielerobjekt nach Abarbeitung der Hook-
41 Funktion noch lebt. Ansonsten wird ein doppeltes move() ausgefuehrt:
42 in den Todesraum und direkt wieder zurueck zur Leiche.
43
44BEMERKUNGEN
45-----------
46::
47
48 - Bitte das neuere Hooksystem (s. Manpage std/hooks) benutzen.
49 - falls die Zeit abgelaufen oder das Objekt zerstoert ist, wird die
50 Property auf 0 gesetzt
51 - vor dem Setzen immer auf die Existenz eines gueltigen Hooks
52 pruefen, einfaches Ueberschreiben fuehrt einerseits zu Fehlern
53 im Code anderer und ist andererseits unfair gegenueber ihnen
54
55SIEHE AUCH
56----------
57::
58
59 Bewegung: move(L), NotifyMove(), PreventMove()
60 Hooks: P_TMP_DIE_HOOK, P_TMP_DEFEND_HOOK, P_TMP_ATTACK_HOOK
61 neue Hooks: std/hooks
62
63
6408.12.2008, Zesstra
65