blob: f468cd32c901547a34c086ceb8323a69d4e96dd9 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001drink_alcohol()
2===============
3
4FUNKTION
5--------
6::
7
8 public varargs int drink_alcohol(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 zur aktuellen Saettigung P_ALCOHOL dazu addiert
21 testonly: Ist das Flag gesetzt, wird dem Spieler kein ALCOHOL 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 "Nuechtern"-Meldung, die bei
27 negativem strength auftreten kann, wenn P_ALCOHOL wieder 0 ist.
28
29BESCHREIBUNG
30------------
31::
32
33 Es wird geprueft, ob dem Spieler der angegebene Wert fuer 'strength'
34 auf seine aktuelle P_ALCOHOL addiert werden kann oder nicht. Falls
35 das moeglich ist und testonly = 0, wird P_ALCOHOL entsprechend
36 aktualisiert.
37
38 Sollen neben P_ALCOHOL noch weitere Props manipuliert werden - bspw. zur
39 Heilung eines Lebewesens - bietet sich die Funktion consume() an.
40
41RUECKGABEWERT
42-------------
43::
44
45 0 bei [potentiellem] Misserfolg (strength + P_ALCOHOL > P_MAX_ALCOHOL)
46 1 bei [potentiellem] Erfolg
47 * potentiell bezieht sich hier auf Nutzung mit 'testonly' != 0
48
49BEMERKUNG
50---------
51::
52
53 drink_alocohol() bitte anstatt eigener Manipulationen von P_ALCOHOL und
54 P_MAX_ALCOHOL verwenden.
55
56 Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen.
57
58 Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
59 dafuer eingerichteten Funktion check_and_update_timed_key realisiert
60 werden.
61
62BEISPIEL
63--------
64::
65
66 int heilstelle() {
67 if(this_player()->drink_alcohol(10, 0,
68 "Du prustest in den Schnaps. "
69 "Der passt nicht mehr rein.\n")) {
70 // Platz fuer 10 "Alkohol" war noch, diese sind jetzt bereits addiert
71 // Nachricht an den Spieler:
72 tell_object(this_player(),
73 break_string("Du trinkst den Schnaps aus.", 78));
74
75 // Nachricht an andere Livings im Raum
76 object ob = first_inventory(environment(this_player()));
77 do {
78 if(living(ob) && ob!=this_player())
79 ob->ReceiveMsg(this_player()->Name()+" trinkt einen Schnaps aus.",
80 MT_LOOK|MT_LISTEN,
81 MA_DRINK);
82 ob = next_inventory(ob);
83 } while(ob);
84
85 // Rassenabhaengige Heilung: Sofort oder in Schritten
86 // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
87 if(this_player()->QueryProp(P_REAL_RACE)=="Schnapsdrossel")
88 this_player()->heal_self(30);
89 else {
90 this_player()->buffer_hp(30,5);
91 this_player()->buffer_sp(30,5);
92 }
93 }
94
95 return 1;
96 }
97
98SIEHE AUCH
99----------
100::
101
102 Aehnlich: consume, eat_food, drink_soft
103 Heilung: heal_self, restore_spell_points, restore_hit_points,
104 buffer_hp, buffer_sp
105 Timing: check_and_update_timed_key
106 Enttanken: defuel_drink, defuel_food
107 Props: P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP,
108 P_DEFUEL_TIME_DRINK
109 Konzepte: heilung, enttanken, food
110
1119. August 2015 Gloinson
112