Gitiles
Code Review Sign In
gerrit.morgengrauen.info / mudlib-public / 4b56c2f8bb23d73472934996b217d553b865b9f9 / . / doc / lfun / drink_soft
blob: 0f030f670948ce03b082e6a80128fbe295c54094 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]1
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]2drink_soft()
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 drink_soft(int strength, 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 strength: Wird zu dem augenblicklichen Saettigungsgrad (P_DRINK) addiert.
22 testonly: Ist das Flag gesetzt, wird dem Spieler kein DRINK 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 "Durst"-Meldung, die bei
28 negativem strength auftritt, wenn P_DRINK 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============
33
34 Es wird geprueft, ob dem Spieler der angebene Wert "strength" auf
35 aktuelle P_DRINK addiert werden kann oder nicht. Ist dies moeglich,
36 wird es gemacht, es sei denn das testonly != 0.
37
38 Sollen neben P_DRINK 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_DRINK > P_MAX_DRINK
46 >0, wenn Erfolg
47
48
49BEMERKUNG
50=========
51
52 drink_soft() bitte anstatt eigener Manipulationen von P_DRINK und
53 P_MAX_DRINK 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 if(this_player()->drink_soft(10, 0, "Du blubberst nicht ueberzeugt "
67 "in der Limonade. Das ist zu viel.\n")) {
68 // Platz fuer 10 "Trinken" war noch, diese sind jetzt bereits addiert
69 // Nachricht an den Spieler:
70 tell_object(this_player(), break_string("Du nimmst einen grossen "
71 "Schluck zuckersuesse Limonade.", 78));
72
73 // alle anderen im Raum bekommen es ggf auch mit:
74 // 1) filter(..., #'living) ergibt die Lebewesen im Raum
75 // 2) filter_objects(..., "ReceiveMsg") ruft ReceiveMsg an jedem
76 // 3) ReceiveMsg(...) bekommt die Folgeparameter
77 filter_objects(filter(all_inventory(environment(this_player())),
78 #'living) - ({this_player()}),
79 "ReceiveMsg",
80 this_player()->Name()+
81 " trinkt einen Schluck Limonade.",
82 MT_LOOK|MT_LISTEN,
83 MA_DRINK);
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)=="Saufziege")
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 +0200[diff] [blame]93 }
94
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]95 return 1;
96 }
97
98
99SIEHE AUCH
100==========
101
102 Aehnlich: consume, drink_alcohol, eat_food
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