blob: 4ab6e070b8f043b4800e7e275817c9f916090dd0 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001FUNKTION:
2 public varargs int drink_soft(int strength, int testonly, string mytext)
3
4DEFINIERT IN:
5 /std/living/life.c
6
7ARGUMENTE:
8 strength: Wird zu dem augenblicklichen Saettigungsgrad (P_DRINK) addiert.
9 testonly: Ist das Flag gesetzt, wird dem Spieler kein DRINK 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 "Durst"-Meldung, die bei
15 negativem strength auftritt, wenn P_DRINK wieder 0 ist.
16
17BESCHREIBUNG:
18 Es wird geprueft, ob dem Spieler der angebene Wert "strength" auf
19 aktuelle P_DRINK addiert werden kann oder nicht. Ist dies moeglich,
20 wird es gemacht, es sei denn das testonly != 0.
21
22 Sollen neben P_DRINK noch weitere Props manipuliert werden - bspw. zur
23 Heilung eines Lebewesens - bietet sich die Funktion consume() an.
24
25RUECKGABEWERT:
26 0, wenn strength + P_DRINK > P_MAX_DRINK
27 >0, wenn Erfolg
28
29BEMERKUNG:
30 drink_soft() bitte anstatt eigener Manipulationen von P_DRINK und
31 P_MAX_DRINK verwenden.
32
33 Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen.
34
35 Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
36 dafuer eingerichteten Funktion check_and_update_timed_key realisiert
37 werden.
38
39BEISPIEL:
40 int heilstelle() {
41 if(this_player()->drink_soft(10, 0, "Du blubberst nicht ueberzeugt "
42 "in der Limonade. Das ist zu viel.\n")) {
43 // Platz fuer 10 "Trinken" war noch, diese sind jetzt bereits addiert
44 // Nachricht an den Spieler:
45 tell_object(this_player(), break_string("Du nimmst einen grossen "
46 "Schluck zuckersuesse Limonade.", 78));
47
48 // alle anderen im Raum bekommen es ggf auch mit:
49 // 1) filter(..., #'living) ergibt die Lebewesen im Raum
50 // 2) filter_objects(..., "ReceiveMsg") ruft ReceiveMsg an jedem
51 // 3) ReceiveMsg(...) bekommt die Folgeparameter
52 filter_objects(filter(all_inventory(environment(this_player())),
53 #'living) - ({this_player()}),
54 "ReceiveMsg",
55 this_player()->Name()+
56 " trinkt einen Schluck Limonade.",
57 MT_LOOK|MT_LISTEN,
58 MA_DRINK);
59
60 // Rassenabhaengige Heilung: Sofort oder in Schritten
61 // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
62 if(this_player()->QueryProp(P_REAL_RACE)=="Saufziege")
63 this_player()->heal_self(30);
64 else {
65 this_player()->buffer_hp(30,5);
66 this_player()->buffer_sp(30,5);
67 }
68 }
69
70 return 1;
71 }
72
73SIEHE AUCH:
74 Aehnlich: consume, drink_alcohol, eat_food
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