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