Gitiles
Code Review Sign In
gerrit.morgengrauen.info / mudlib-public / 70ea424b1ab825d72d87aa677546129fb1648f47 / . / doc / lfun / die
blob: b8ee872319db3ee37be193430cee39939de6fd87 [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]1
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]2die()
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]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 void die(int poisondeath,int extern);
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
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]21 poisondeath
22 Dieses Flag sollte bei einem Gifttod (P_POISON) gesetzt sein.
23
24 extern
25 Ex- oder interner Aufruf.
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]26
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]27
28BESCHREIBUNG
29============
30
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]31 Das Lebewesen stirbt, meist automatisch von do_damage() ausgeloest,
32 wenn 0 HP unterschritten werden. In diesem Fall wird der Kampf
33 beendet, Gift, Alkohol, Trink- und Esswerte, Blindheit, Taubheit
34 u.s.w. auf Null gesetzt oder geloescht.
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]35
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]36 Es wird automatisch eine Leiche (siehe auch P_CORPSE, P_NOCORPSE)
37 nebst Todesmeldungen (siehe auch P_DIE_MSG) erzeugt, und fuer
38 Spieler werden Killstupse vergeben, sofern notwendig.
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]39
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]40 Ueber den Hook H_HOOK_DIE kann man jedoch auf den Automatismus
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]41 Einfluss nehmen, z.B. koennte ein temporaerer Todesbann-Zauber das
42 Sterben fuer kurze Zeit verhindern.
43
44
45RUeCKGABEWERT
46=============
47
48 keiner
49
50
51BEMERKUNGEN
52===========
53
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]54 Diese Funktion sollte nur selten direkt verwendet werden. Meist ist
55 der uebliche Weg ueber Defend() -> do_damage() -> die() die logisch
56 bessere und balancetechnisch guenstigere Loesung.
57
58 Diese Funktion sollte nur ueberschrieben werden, wenn tatsaechlich
59 einfluss auf das Sterben genommen werden soll. Wird nur ein Item
60 hinzugefuegt, ist es sinnvoller second_life() zu verwenden.
61
62 Wird die() ueberschrieben, sollte man nicht nur das Argument extern
63 uebergeben, sondern mit extern_call() verodern (siehe Beispiel),
64 weil das geerbte die() den externen Aufruf nicht mehr erkennen
65 kann.
66
67
68BEISPIEL
69========
70
71 public varargs void die(int poisondeath, int extern)
72 {
73 // Dieser NPC soll nicht an Gift sterben.
74 if(poisondeath) return;
75
76 // Das geerbte die() aufrufen, dabei die Argumente uebergeben und ggf.
77 // extern setzen.
78 ::die(poisondeath, extern||extern_call());
79 }
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]80
81
82SIEHE AUCH
83==========
84
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]85 Defend(), do_damage(), second_life(), P_POISON, P_DEADS,
86 P_KILL_NAME, P_KILL_MSG, P_MURDER_MSG, P_DIE_MSG, P_ZAP_MSG,
87 P_ENEMY_DEATH_SEQUENCE, P_CORPSE, P_NOCORPSE, extern_call,
88 /std/corpse, /std/hooks
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]89
Zesstra70ea4242019-06-27 20:51:52 +0200[diff] [blame^]90Letzte Aenderung: 17.03.2019, Bugfix