blob: ec0102dc41ce6360b07d25af04e0b1e8f10fd0ba [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001FUNKTION:
2 public varargs int eat_food(int food, int testonly, string mytext)
3
4DEFINIERT IN:
5 /std/living/life.c
6
7ARGUMENTE:
8 food: Wird zu dem augenblicklichen Saettigungsgrad (P_FOOD) addiert.
9 testonly: Ist das Flag gesetzt, wird dem Spieler kein FOOD 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 "Hunger"-Meldung, die bei
15 negativem food auftreten kann, wenn P_FOOD wieder 0 ist.
16
17BESCHREIBUNG:
18 Es wird geprueft, ob dem Spieler der angebene Wert "strength" auf seine
19 aktuelle P_FOOD addiert werden kann oder nicht. Ist dies moeglich, wird
20 wird es gemacht, es sei denn das testonly != 0.
21
22 Sollen neben P_FOOD noch weitere Props manipuliert werden - bspw. zur
23 Heilung eines Lebewesens - bietet sich die Funktion consume() an.
24
25RUECKGABEWERT:
26 0, wenn strength + P_FOOD > P_MAX_FOOD.
27 >0, wenn Erfolg.
28
29BEMERKUNG:
30 eat_food() bitte anstatt eigener Manipulationen von P_FOOD und
31 P_MAX_FOOD 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 // Wenn auf das P_FOOD des Spielers die angegebenen 10 nicht mehr addiert
42 // addiert werden koennen (weil sonst P_MAX_FOOD ueberschritten wird),
43 // wird die Fehlermeldung ausgegeben, dass der Spieler nichts mehr
44 // essen/trinken kann.
45 // Bei gesetztem 'mytext' wird 'mytext' an den Spieler ausgegeben.
46 // Ansonsten wird die Standardmeldung ausgegeben.
47 if (!this_player()->eat_food(10, 0, "Der Keks ist einfach "
48 "zuviel fuer Dich.\n") )
49 return 1;
50
51 // Spieler hatte noch ausreichend Spielraum bei P_FOOD. Die 10 sind
52 // schon addiert worden. Jetzt Nachricht ausgeben:
53 tell_object(this_player(), break_string("Du knabberst ein bisschen an "
54 "dem Keks herum und fuehlst Dich gleich viel besser.", 78));
55
56 // alle Lebewesen im Raum bekommen das auch mit
57 foreach(object ob:
58 (filter(all_inventory(environment(this_player())), #'living) -
59 ({this_player()})))
60 ob->ReceiveMsg(this_player()->Name()+" knuspert einen Keks weg.",
61 MT_LOOK|MT_LISTEN,
62 MA_EAT);
63
64 // Rassenabhaengige Heilung: Sofort oder in Schritten
65 // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
66 if(this_player()->QueryProp(P_REAL_RACE)=="Kruemelmonster")
67 this_player()->heal_self(30);
68 else {
69 this_player()->buffer_hp(30,5);
70 this_player()->buffer_sp(30,5);
71 }
72
73 return 1;
74 }
75
76SIEHE AUCH:
77 Aehnlich: consume, drink_alcohol, drink_soft
78 Heilung: heal_self, restore_spell_points, restore_hit_points,
79 buffer_hp, buffer_sp
80 Timing: check_and_update_timed_key
81 Enttanken: defuel_drink, defuel_food
82 Props: P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP,
83 P_DEFUEL_TIME_DRINK
84 Konzepte: heilung, enttanken, food
85
869. August 2015 Gloinson