blob: daedc6c53ab662c740726b2f8a089da79cbc9e29 [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +01001
MG Mud User88f12472016-06-24 23:31:02 +02002GiveQuest()
Zesstra953f9972017-02-18 15:37:36 +01003***********
MG Mud User88f12472016-06-24 23:31:02 +02004
MG Mud User88f12472016-06-24 23:31:02 +02005
Zesstra953f9972017-02-18 15:37:36 +01006FUNKTION
7========
MG Mud User88f12472016-06-24 23:31:02 +02008
Zesstra953f9972017-02-18 15:37:36 +01009 varargs int GiveQuest(string questname, string message)
MG Mud User88f12472016-06-24 23:31:02 +020010
MG Mud User88f12472016-06-24 23:31:02 +020011
Zesstra953f9972017-02-18 15:37:36 +010012DEFINIERT IN
13============
MG Mud User88f12472016-06-24 23:31:02 +020014
Zesstra953f9972017-02-18 15:37:36 +010015 /std/player/quests.c
MG Mud User88f12472016-06-24 23:31:02 +020016
MG Mud User88f12472016-06-24 23:31:02 +020017
Zesstra953f9972017-02-18 15:37:36 +010018ARGUMENTE
19=========
MG Mud User88f12472016-06-24 23:31:02 +020020
Zesstra953f9972017-02-18 15:37:36 +010021 questname
22 Questname, wie er im Questmaster eingetragen wurde.
23 message
24 Optionale Meldung, die auf dem Abenteuer-Kanal statt der
25 Standardmeldung gesendet wird.
26 Dabei wird @@name@@ durch den Spielernamen ersetzt.
MG Mud User88f12472016-06-24 23:31:02 +020027
MG Mud User88f12472016-06-24 23:31:02 +020028
Zesstra953f9972017-02-18 15:37:36 +010029RUeCKGABEWERT
30=============
MG Mud User88f12472016-06-24 23:31:02 +020031
Zesstra953f9972017-02-18 15:37:36 +010032 (Die Defines fuer den Rueckgabewert finden sich in
33 /secure/questmaster.h)
34 1 : Hat geklappt (OK)
35 -1 : Spieler hat die Quest bereits geloest (GQ_ALREADY_SET)
36 -2 : Ungueltiger Questname (GQ_KEY_INVALID)
37 -3 : Unbefugter Zugriff (GQ_ILLEGAL_OBJ)
38 -4 : Quest zur Zeit inaktiv (GQ_IS_INACTIVE)
39
40
41BESCHREIBUNG
42============
43
44 Mit dieser Funktion wird nach dem erfolgreichen Loesen einer
45 Quest die Quest im Spieler eingetragen. Dabei muss der Aufruf
46 in dem Objekt erfolgen, welches im Questmaster eingetragen ist.
47 Zusaetzlich wird der Zeitpunkt eingetragen, an dem die Quest
48 bestanden wurde.
49
50
51
52 Wer sich da nicht sicher ist, kann mit dem Questtool
53 (/obj/tools/questtool) nachsehen.
54
55 Nachdem eine Quest als geloest markiert wurde, ist dies in einem
56 Logfile fuer die Quest im Verzeichnis /log/quest einzutragen. Dazu
57 wird write_file verwendet.
58
59
60BEISPIEL
61========
62
63 int quest;
64
65 quest = this_player()->GiveQuest("Zacharias Eispalast");
66
67 if (quest == 1)
68 {
69 write("Du fuehlst, wie Deine Erfahrung ansteigt.\n");
70 write_file("/log/quest/eispalast",
71 dtime(time())+" Aufgabe geloest von "
72 +this_player()->name()+"\n");
73 }
74 else if (quest != -1)
75 write( "Die Weltenmaschine will Dir Deine Arbeit "
76 +"nicht anerkennen.\n"
77 +"Frage einen Erzmagier um Hilfe.\n" );
78
79
80SIEHE AUCH
81==========
82
83 /secure/questmaster.h, /obj/tools/questtool
84 QueryQuest(), write_file(), ModifyQuestTime()
85
MG Mud User88f12472016-06-24 23:31:02 +020086Zuletzt geaendert: Son, 27. Apr 2014, Arathorn