blob: 58c7d575313ff8506fbe001a0bc101a8de5fe4d6 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001drink_soft()
2============
3
4FUNKTION
5--------
6::
7
8 public varargs int drink_soft(int strength, int testonly, string mytext)
9
10DEFINIERT IN
11------------
12::
13
14 /std/living/life.c
15
16ARGUMENTE
17---------
18::
19
20 strength: Wird zu dem augenblicklichen Saettigungsgrad (P_DRINK) addiert.
21 testonly: Ist das Flag gesetzt, wird dem Spieler kein DRINK zugefuehrt.
22 Darf nur zum Testen der Heilstelle verwendet werden und muss
23 im normalen Betrieb auf '0' stehen!
24 mytext: Wer selber einen Text bei Misserfolg ausgeben lassen moechte,
25 darf sich hier was nettes ausdenken.
26 Achtung: Das unterdrueckt nicht die "Durst"-Meldung, die bei
27 negativem strength auftritt, wenn P_DRINK wieder 0 ist.
28
29BESCHREIBUNG
30------------
31::
32
33 Es wird geprueft, ob dem Spieler der angebene Wert "strength" auf
34 aktuelle P_DRINK addiert werden kann oder nicht. Ist dies moeglich,
35 wird es gemacht, es sei denn das testonly != 0.
36
37 Sollen neben P_DRINK noch weitere Props manipuliert werden - bspw. zur
38 Heilung eines Lebewesens - bietet sich die Funktion consume() an.
39
40RUECKGABEWERT
41-------------
42::
43
44 0, wenn strength + P_DRINK > P_MAX_DRINK
45 >0, wenn Erfolg
46
47BEMERKUNG
48---------
49::
50
51 drink_soft() bitte anstatt eigener Manipulationen von P_DRINK und
52 P_MAX_DRINK verwenden.
53
54 Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen.
55
56 Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
57 dafuer eingerichteten Funktion check_and_update_timed_key realisiert
58 werden.
59
60BEISPIEL
61--------
62::
63
64 int heilstelle() {
65 if(this_player()->drink_soft(10, 0, "Du blubberst nicht ueberzeugt "
66 "in der Limonade. Das ist zu viel.\n")) {
67 // Platz fuer 10 "Trinken" war noch, diese sind jetzt bereits addiert
68 // Nachricht an den Spieler:
69 tell_object(this_player(), break_string("Du nimmst einen grossen "
70 "Schluck zuckersuesse Limonade.", 78));
71
72 // alle anderen im Raum bekommen es ggf auch mit:
73 // 1) filter(..., #'living) ergibt die Lebewesen im Raum
74 // 2) filter_objects(..., "ReceiveMsg") ruft ReceiveMsg an jedem
75 // 3) ReceiveMsg(...) bekommt die Folgeparameter
76 filter_objects(filter(all_inventory(environment(this_player())),
77 #'living) - ({this_player()}),
78 "ReceiveMsg",
79 this_player()->Name()+
80 " trinkt einen Schluck Limonade.",
81 MT_LOOK|MT_LISTEN,
82 MA_DRINK);
83
84 // Rassenabhaengige Heilung: Sofort oder in Schritten
85 // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
86 if(this_player()->QueryProp(P_REAL_RACE)=="Saufziege")
87 this_player()->heal_self(30);
88 else {
89 this_player()->buffer_hp(30,5);
90 this_player()->buffer_sp(30,5);
91 }
92 }
93
94 return 1;
95 }
96
97SIEHE AUCH
98----------
99::
100
101 Aehnlich: consume, drink_alcohol, eat_food
102 Heilung: heal_self, restore_spell_points, restore_hit_points,
103 buffer_hp, buffer_sp
104 Timing: check_and_update_timed_key
105 Enttanken: defuel_drink, defuel_food
106 Props: P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP,
107 P_DEFUEL_TIME_DRINK
108 Konzepte: heilung, enttanken, food
109
1109. August 2015 Gloinson
111