Gitiles
Code Review Sign In
gerrit.morgengrauen.info / mudlib-public / 4b56c2f8bb23d73472934996b217d553b865b9f9 / . / doc / lfun / eat_food
blob: 9cf54b3286cd4d34d29efac5afaee3945044e2c9 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]1
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]2eat_food()
3**********
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]4
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]5
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]6FUNKTION
7========
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]8
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]9 public varargs int eat_food(int food, int testonly, string mytext)
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]10
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]11
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]12DEFINIERT IN
13============
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]14
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]15 /std/living/life.c
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]16
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]17
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]18ARGUMENTE
19=========
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]20
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]21 food: Wird zu dem augenblicklichen Saettigungsgrad (P_FOOD) addiert.
22 testonly: Ist das Flag gesetzt, wird dem Spieler kein FOOD zugefuehrt.
23 Darf nur zum Testen der Heilstelle verwendet werden und muss
24 im normalen Betrieb auf '0' stehen!
25 mytext: Wer selber einen Text bei Misserfolg ausgeben lassen moechte,
26 darf sich hier was nettes ausdenken.
27 Achtung: Das unterdrueckt nicht die "Hunger"-Meldung, die bei
28 negativem food auftreten kann, wenn P_FOOD wieder 0 ist.
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]29
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]30
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]31BESCHREIBUNG
32============
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]33
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]34 Es wird geprueft, ob dem Spieler der angebene Wert "strength" auf seine
35 aktuelle P_FOOD addiert werden kann oder nicht. Ist dies moeglich, wird
36 wird es gemacht, es sei denn das testonly != 0.
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]37
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]38 Sollen neben P_FOOD noch weitere Props manipuliert werden - bspw. zur
39 Heilung eines Lebewesens - bietet sich die Funktion consume() an.
40
41
42RUECKGABEWERT
43=============
44
45 0, wenn strength + P_FOOD > P_MAX_FOOD.
46 >0, wenn Erfolg.
47
48
49BEMERKUNG
50=========
51
52 eat_food() bitte anstatt eigener Manipulationen von P_FOOD und
53 P_MAX_FOOD verwenden.
54
55 Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen.
56
57 Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens
58 dafuer eingerichteten Funktion check_and_update_timed_key realisiert
59 werden.
60
61
62BEISPIEL
63========
64
65 int heilstelle() {
66 // Wenn auf das P_FOOD des Spielers die angegebenen 10 nicht mehr addiert
67 // addiert werden koennen (weil sonst P_MAX_FOOD ueberschritten wird),
68 // wird die Fehlermeldung ausgegeben, dass der Spieler nichts mehr
69 // essen/trinken kann.
70 // Bei gesetztem 'mytext' wird 'mytext' an den Spieler ausgegeben.
71 // Ansonsten wird die Standardmeldung ausgegeben.
72 if (!this_player()->eat_food(10, 0, "Der Keks ist einfach "
73 "zuviel fuer Dich.\n") )
74 return 1;
75
76 // Spieler hatte noch ausreichend Spielraum bei P_FOOD. Die 10 sind
77 // schon addiert worden. Jetzt Nachricht ausgeben:
78 tell_object(this_player(), break_string("Du knabberst ein bisschen an "
79 "dem Keks herum und fuehlst Dich gleich viel besser.", 78));
80
81 // alle Lebewesen im Raum bekommen das auch mit
Arathorn99af0d22019-11-26 19:19:51 +0100[diff] [blame]82 tell_room(environment(this_player()),
83 this_player()->Name()+" knuspert einen Keks weg.\n",
84 ({this_player()}));
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]85
86 // Rassenabhaengige Heilung: Sofort oder in Schritten
87 // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen.
88 if(this_player()->QueryProp(P_REAL_RACE)=="Kruemelmonster")
89 this_player()->heal_self(30);
90 else {
91 this_player()->buffer_hp(30,5);
92 this_player()->buffer_sp(30,5);
93 }
94
95 return 1;
96 }
97
98
99SIEHE AUCH
100==========
101
102 Aehnlich: consume, drink_alcohol, 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 +0200[diff] [blame]110
1119. August 2015 Gloinson