blob: c0945388ddc09e63243864ba695abfa142b0868d [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001defuel_drink()
2==============
3
4FUNKTION
5--------
6::
7
8 int defuel_drink();
9
10DEFINIERT IN
11------------
12::
13
14 /std/living/life.c
15
16ARGUMENTE
17---------
18::
19
20 Keine.
21
22
23
24BESCHREIBUNG
25------------
26::
27
28 Enttankt den Spieler automatisch um einen gewissen Fluessigkeits-Wert,
29 sofern der Spieler ueber einer bestimmten Enttank-Grenze liegt und seit
30 seinem letzten Enttanken eine gewisse Zeit vergangen ist.
31 Alle diese Werte sind rassenabhaengig.
32 Ausserdem wird dem Spieler eine gewisse Menge Alkohol entzogen. Er wird
33 also mit jedem fluessigen Enttanken etwas nuechterner.
34
35 Es ist also NICHT moeglich, Einfluss auf die Menge des Enttankens
36 zu nehmen. Das ist hier so gewollt.
37
38 Hat der Spieler mindestens
39 * P_DEFUEL_LIMIT_DRINK in P_DRINK
40 kann er alle
41 * P_DEFUEL_TIME_DRINK
42 um
43 * (x=P_DRINK*P_DEFUEL_AMOUNT_DRINK/2) + random(x)
44 (also um (50 bis 100 * P_DRINK) Prozent)
45 enttanken.
46
47RUECKGABEWERTE
48--------------
49::
50
51 DEFUEL_TOO_SOON: -2, wenn Enttankintervallzeiten zu kurz.
52 DEFUEL_TOO_LOW: -1, wenn Enttankgrenze noch nicht erreicht.
53 NO_DEFUEL: 0, wenn Enttanken nicht noetig war (Spieler war leer)
54 >0, wenn Erfolg (enttankte Wert wird zurueckgegeben).
55
56 (Konstanten kommen aus /sys/defuel.h)
57
58BEMERKUNG
59---------
60::
61
62 Bitte defuel_drink() benutzen und nicht P_DRINK oder P_MAX_DRINK des
63 manipulieren!
64
65 Es gibt keine eigene Methode fuer die Verringerung von P_ALCOHOL.
66
67 Achtung: Nur Toiletten sollten diese Funktion im Spieler aufrufen!
68
69BEISPIEL
70--------
71::
72
73 s. Bsp. zu defuel_food()
74
75SIEHE AUCH
76----------
77::
78
79 Aehnlich: defuel_food
80 Tanken: consume, drink_alcohol, drink_soft, eat_food
81 Heilung: heal_self, restore_spell_points, restore_hit_points,
82 buffer_hp, buffer_sp
83 Timing: check_and_update_timed_key
84 Props: P_DRINK, P_FOOD, P_ALCOHOL, P_SP, P_HP,
85 P_DEFUEL_TIME_FOOD, P_DEFUEL_TIME_DRINK
86 Konzepte: heilung, enttanken, food
87
889. August 2015 Gloinson
89