blob: 28ed1dd7ee50fa771372f01e32b0a571f1f96179 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001FUNKTION:
2 public varargs int drink_alcohol(int strength, int testonly, string mytext)
3
4DEFINIERT IN:
5 /std/living/life.c
6
7ARGUMENTE:
8 strength: wird zur aktuellen Saettigung P_ALCOHOL dazu addiert
9 testonly: Ist das Flag gesetzt, wird dem Spieler kein ALCOHOL zugefuehrt.
10 Darf nur zum Testen der Heilstelle verwendet werden und muss
11 im normalen Betrieb auf '0' stehen!
12 mytext: Wer selber einen Text bei Misserfolg ausgeben lassen moechte,
13 darf sich hier was nettes ausdenken.
14 Achtung: Das unterdrueckt nicht die "Nuechtern"-Meldung, die bei
15 negativem strength auftreten kann, wenn P_ALCOHOL wieder 0 ist.
16
17BESCHREIBUNG:
18 Es wird geprueft, ob dem Spieler der angegebene Wert fuer 'strength'
19 auf seine aktuelle P_ALCOHOL addiert werden kann oder nicht. Falls
20 das moeglich ist und testonly = 0, wird P_ALCOHOL entsprechend
21 aktualisiert.
22
23 Sollen neben P_ALCOHOL noch weitere Props manipuliert werden - bspw. zur
24 Heilung eines Lebewesens - bietet sich die Funktion consume() an.
25
26RUECKGABEWERT:
27 0 bei [potentiellem] Misserfolg (strength + P_ALCOHOL > P_MAX_ALCOHOL)
28 1 bei [potentiellem] Erfolg
29 * potentiell bezieht sich hier auf Nutzung mit 'testonly' != 0
30
31BEMERKUNG:
32 drink_alocohol() bitte anstatt eigener Manipulationen von P_ALCOHOL und
33 P_MAX_ALCOHOL verwenden.
34
35 Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen.
36
37 Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
38 dafuer eingerichteten Funktion check_and_update_timed_key realisiert
39 werden.
40
41BEISPIEL:
42 int heilstelle() {
43 if(this_player()->drink_alcohol(10, 0,
44 "Du prustest in den Schnaps. "
45 "Der passt nicht mehr rein.\n")) {
46 // Platz fuer 10 "Alkohol" war noch, diese sind jetzt bereits addiert
47 // Nachricht an den Spieler:
48 tell_object(this_player(),
49 break_string("Du trinkst den Schnaps aus.", 78));
50
51 // Nachricht an andere Livings im Raum
52 object ob = first_inventory(environment(this_player()));
53 do {
54 if(living(ob) && ob!=this_player())
55 ob->ReceiveMsg(this_player()->Name()+" trinkt einen Schnaps aus.",
56 MT_LOOK|MT_LISTEN,
57 MA_DRINK);
58 ob = next_inventory(ob);
59 } while(ob);
60
61 // Rassenabhaengige Heilung: Sofort oder in Schritten
62 // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
63 if(this_player()->QueryProp(P_REAL_RACE)=="Schnapsdrossel")
64 this_player()->heal_self(30);
65 else {
66 this_player()->buffer_hp(30,5);
67 this_player()->buffer_sp(30,5);
68 }
69 }
70
71 return 1;
72 }
73SIEHE AUCH:
74 Aehnlich: consume, eat_food, drink_soft
75 Heilung: heal_self, restore_spell_points, restore_hit_points,
76 buffer_hp, buffer_sp
77 Timing: check_and_update_timed_key
78 Enttanken: defuel_drink, defuel_food
79 Props: P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP,
80 P_DEFUEL_TIME_DRINK
81 Konzepte: heilung, enttanken, food
82
839. August 2015 Gloinson