blob: 573fee6cd0911296b988f4f0307a70038c571b10 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001WearFunc()
2==========
3
4FUNKTION
5--------
6::
7
8 int WearFunc(object ruest, int silent, object user);
9
10DEFINIERT IN
11------------
12::
13
14 eigenen Objekten (fuer /std/clothing/wear)
15
16ARGUMENTE
17---------
18::
19
20 ruest (object)
21 Die Ruestung/Kleidung, die angezogen werden soll.
22 silent (int)
23 Ob dabei eine Meldung ausgegeben wird.
24 user (object)
25 Das Lebewesen, welches die Ruestung/Kleidung anziehen will.
26
27BESCHREIBUNG
28------------
29::
30
31 Mit dieser Funktion kann man pruefen, ob sich das Kleidungsstueck bzw.
32 Ruestung <ruest> von this_player() anziehen laesst oder nicht.
33 Kann die Ruestung angezogen werden, so muss ein Wert ungleich 0
34 zurueckgegeben werden.
35
36RUeCKGABEWERT
37-------------
38::
39
40 0, wenn sich die Ruestung nicht anziehen laesst, ansonsten ungleich 0.
41
42BEMERKUNGEN
43-----------
44::
45
46 Bitte nicht darauf verlassen, dass der Spieler das Objekt auch wirklich
47 anzieht, wenn man hier 1 zurueckgibt.
48 Speziell bei Schilden kann das Anziehen trotz eines Rueckgabewertes
49 != 0 immer noch schief gehen, wenn der Spieler keine Hand mehr frei hat.
50 Wenn ihr sicher sein wollt, dass der Spieler ein Objekt angezogen hat,
51 benutzt bitte InformWear().
52 Bitte nicht drauf verlassen, dass this_player() das ausziehende Lebewesen
53 ist.
54 Die Reihenfolge der Argumente ist etwas unschoen, aber leider wurde <user>
55 erheblich spaeter hinzugefuegt und es war unmoeglich, einige hundert
56 Objekte zu aendern.
57
58BEISPIELE
59---------
60::
61
62 Ein Helm, der nur von Elfen getragen werden kann:
63
64 inherit "std/armour.c";
65
66 #include <properties.h>
67
68 create()
69 {
70 ::create();
71
72 SetProp(P_ARMOUR_TYPE, AT_HELMET);
73 /* zig weitere SetProp's, um den Helm zu konfigurieren */
74
75 /* WearFunc() ist im Helm selbst zu finden */
76 SetProp(P_WEAR_FUNC, this_object());
77 }
78
79 int WearFunc(object me, int silent, object user)
80 {
81 if (user->QueryProp(P_RACE) == "Elf")
82 return 1; /* Elfen duerfen den Helm tragen */
83
84 /* Die anderen Rassen sollten zumindest erfahren koennen, wieso
85 sie den Helm nicht tragen koennen... */
86 if (!silent)
87 write( "Der Helm rutscht Dir immer ueber Deine runden "
88 +"Ohren.\n" );
89 return 0;
90 }
91
92 Gibt jetzt ein Nicht-Elf "trage helm" ein, so bekommt er die Meldung
93 "Der Helm rutscht Dir immer ueber Deine runden Ohren.", Elfen dagegen
94 passt das Teil wie angegossen.
95
96SIEHE AUCH
97----------
98::
99
100 P_WEAR_MSG, P_UNWEAR_MSG, P_WIELD_MSG, P_UNWIELD_MSG
101 DoWear(), DoUnwear(), InformUnwear(), InformWear()
102 /std/clothing/wear.c
103
104
10502.02.2009, Zesstra
106