blob: d4606c60649939363ae8d78fd92dc5aeeb0718e4 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001QueryUser()
2===========
3
4FUNKTION
5--------
6::
7
8 public object QueryUser()
9
10DEFINIERT IN
11------------
12::
13
14 /std/npc/combat.c
15 /std/clothing/wear.c
16 /std/weapon/combat.c
17 alle Objekte, in denen es darueber hinaus noetig ist
18
19ARGUMENTE
20---------
21::
22
23 keine
24
25BESCHREIBUNG
26------------
27::
28
29 Liefert den aktuellen Nutzer (Lebewesen) eines Items oder NPCs.
30
31
32
33 Diese Funktion wird z.B. von get_killing_player() benutzt, um
34 herauszufinden, zu welchem Spieler denn das Objekt gehoert, was den
35 toedlichen Schaden verursacht hat.
36
37 Im Falle eines NPCs ist dies standardmaessig der Spieler, bei dem der
38 NPC als Helfer-NPC eingetragen ist (s. RegisterHelperNPC).
39 Im Falle einer Ruestung ist es das Lebewesen, welches sie gerade traegt.
40 Im Falle einer Waffe ist es das Lebewesen, welches sie gerade gezueckt
41 hat.
42 Alle anderen Objekte enthalten keinen Default fuer diese Funktion.
43
44RUeCKGABEWERT
45-------------
46::
47
48 Das nutzende Lebewesen, falls es ermittelt werden konnte, sonst 0.
49
50BEMERKUNGEN
51-----------
52::
53
54 Sollte in allen Objekten definiert werden, welche Lebewesen Schaden
55 zufuegen, ohne dass das verursachende Lebewesen dabei als Feind im
56 Defend() angeben wird.
57 Der gelieferte Nutzer muss explizit kein Spieler sein. Es waere z.B.
58 moeglich, dass von einem Spieler kontrollierter NPC einen Bumerang nutzt.
59
60BEISPIELE
61---------
62::
63
64 Ein von einem Spieler beschworenes Wesen wirft einen Bumerang nach einem
65 Feind.
66 Dann liefert QueryUser() im Bumerang den NPC als Nutzer und
67 QueryUser() im NPC wiederum den Spieler.
68
69
70
71SIEHE AUCH
72----------
73::
74
75 RegisterHelperNPC(), get_killer_player()
76 P_WORN, P_WIELDED
77
7812.11.2013, Zesstra
79