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