| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame^] | 1 | eat_food() |
| 2 | ========== |
| 3 | |
| 4 | FUNKTION |
| 5 | -------- |
| 6 | :: |
| 7 | |
| 8 | public varargs int eat_food(int food, int testonly, string mytext) |
| 9 | |
| 10 | DEFINIERT IN |
| 11 | ------------ |
| 12 | :: |
| 13 | |
| 14 | /std/living/life.c |
| 15 | |
| 16 | ARGUMENTE |
| 17 | --------- |
| 18 | :: |
| 19 | |
| 20 | food: Wird zu dem augenblicklichen Saettigungsgrad (P_FOOD) addiert. |
| 21 | testonly: Ist das Flag gesetzt, wird dem Spieler kein FOOD 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 "Hunger"-Meldung, die bei |
| 27 | negativem food auftreten kann, wenn P_FOOD wieder 0 ist. |
| 28 | |
| 29 | BESCHREIBUNG |
| 30 | ------------ |
| 31 | :: |
| 32 | |
| 33 | Es wird geprueft, ob dem Spieler der angebene Wert "strength" auf seine |
| 34 | aktuelle P_FOOD addiert werden kann oder nicht. Ist dies moeglich, wird |
| 35 | wird es gemacht, es sei denn das testonly != 0. |
| 36 | |
| 37 | Sollen neben P_FOOD noch weitere Props manipuliert werden - bspw. zur |
| 38 | Heilung eines Lebewesens - bietet sich die Funktion consume() an. |
| 39 | |
| 40 | RUECKGABEWERT |
| 41 | ------------- |
| 42 | :: |
| 43 | |
| 44 | 0, wenn strength + P_FOOD > P_MAX_FOOD. |
| 45 | >0, wenn Erfolg. |
| 46 | |
| 47 | BEMERKUNG |
| 48 | --------- |
| 49 | :: |
| 50 | |
| 51 | eat_food() bitte anstatt eigener Manipulationen von P_FOOD und |
| 52 | P_MAX_FOOD verwenden. |
| 53 | |
| 54 | Achtung: Immer erst VOR einer Heilung ausfuehren und bei Erfolg heilen. |
| 55 | |
| 56 | Bei Heilstellen sollte eine evtl. Heilung des Spielers mit der eigens |
| 57 | dafuer eingerichteten Funktion check_and_update_timed_key realisiert |
| 58 | werden. |
| 59 | |
| 60 | BEISPIEL |
| 61 | -------- |
| 62 | :: |
| 63 | |
| 64 | int heilstelle() { |
| 65 | // Wenn auf das P_FOOD des Spielers die angegebenen 10 nicht mehr addiert |
| 66 | // addiert werden koennen (weil sonst P_MAX_FOOD ueberschritten wird), |
| 67 | // wird die Fehlermeldung ausgegeben, dass der Spieler nichts mehr |
| 68 | // essen/trinken kann. |
| 69 | // Bei gesetztem 'mytext' wird 'mytext' an den Spieler ausgegeben. |
| 70 | // Ansonsten wird die Standardmeldung ausgegeben. |
| 71 | if (!this_player()->eat_food(10, 0, "Der Keks ist einfach " |
| 72 | "zuviel fuer Dich.\n") ) |
| 73 | return 1; |
| 74 | |
| 75 | // Spieler hatte noch ausreichend Spielraum bei P_FOOD. Die 10 sind |
| 76 | // schon addiert worden. Jetzt Nachricht ausgeben: |
| 77 | tell_object(this_player(), break_string("Du knabberst ein bisschen an " |
| 78 | "dem Keks herum und fuehlst Dich gleich viel besser.", 78)); |
| 79 | |
| 80 | // alle Lebewesen im Raum bekommen das auch mit |
| 81 | foreach(object ob: |
| 82 | (filter(all_inventory(environment(this_player())), #'living) - |
| 83 | ({this_player()}))) |
| 84 | ob->ReceiveMsg(this_player()->Name()+" knuspert einen Keks weg.", |
| 85 | MT_LOOK|MT_LISTEN, |
| 86 | MA_EAT); |
| 87 | |
| 88 | // Rassenabhaengige Heilung: Sofort oder in Schritten |
| 89 | // Tragbare Heilungen sollten auch eher buffer_hp/_sp benutzen. |
| 90 | if(this_player()->QueryProp(P_REAL_RACE)=="Kruemelmonster") |
| 91 | this_player()->heal_self(30); |
| 92 | else { |
| 93 | this_player()->buffer_hp(30,5); |
| 94 | this_player()->buffer_sp(30,5); |
| 95 | } |
| 96 | |
| 97 | return 1; |
| 98 | } |
| 99 | |
| 100 | SIEHE AUCH |
| 101 | ---------- |
| 102 | :: |
| 103 | |
| 104 | Aehnlich: consume, drink_alcohol, drink_soft |
| 105 | Heilung: heal_self, restore_spell_points, restore_hit_points, |
| 106 | buffer_hp, buffer_sp |
| 107 | Timing: check_and_update_timed_key |
| 108 | Enttanken: defuel_drink, defuel_food |
| 109 | Props: P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP, |
| 110 | P_DEFUEL_TIME_DRINK |
| 111 | Konzepte: heilung, enttanken, food |
| 112 | |
| 113 | 9. August 2015 Gloinson |
| 114 | |