blob: 06745937176103e46970b73d60b960ebb1ee61ac [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +01001drink_alcohol()
2***************
MG Mud User88f12472016-06-24 23:31:02 +02003
MG Mud User88f12472016-06-24 23:31:02 +02004
Zesstra953f9972017-02-18 15:37:36 +01005FUNKTION
6========
MG Mud User88f12472016-06-24 23:31:02 +02007
Zesstra953f9972017-02-18 15:37:36 +01008 public varargs int drink_alcohol(int strength, int testonly, string mytext)
MG Mud User88f12472016-06-24 23:31:02 +02009
MG Mud User88f12472016-06-24 23:31:02 +020010
Zesstra953f9972017-02-18 15:37:36 +010011DEFINIERT IN
12============
MG Mud User88f12472016-06-24 23:31:02 +020013
Zesstra953f9972017-02-18 15:37:36 +010014 /std/living/life.c
MG Mud User88f12472016-06-24 23:31:02 +020015
MG Mud User88f12472016-06-24 23:31:02 +020016
Zesstra953f9972017-02-18 15:37:36 +010017ARGUMENTE
18=========
MG Mud User88f12472016-06-24 23:31:02 +020019
Zesstra953f9972017-02-18 15:37:36 +010020 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.
MG Mud User88f12472016-06-24 23:31:02 +020028
MG Mud User88f12472016-06-24 23:31:02 +020029
Zesstra953f9972017-02-18 15:37:36 +010030BESCHREIBUNG
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
41
42RUECKGABEWERT
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
49
50BEMERKUNG
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
62
63BEISPIEL
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 }
MG Mud User88f12472016-06-24 23:31:02 +020093 }
Zesstra953f9972017-02-18 15:37:36 +010094
95 return 1;
96 }
97
98
99SIEHE AUCH
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
MG Mud User88f12472016-06-24 23:31:02 +0200110
1119. August 2015 Gloinson