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