blob: 40246aeb10e7fd3797e331546ea3f04612152df5 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001FUNKTION:
2 mapping QueryOpenMiniQuestsForPlayer(object player)
3
4DEFINIERT IN:
5 /secure/questmaster
6
7BESCHREIBUNG:
8 Diese Funktion gibt die Liste der offenen Miniquests des Spielers als
9 Mapping zurueck.
10
11ARGUMENTE:
12 player - das interessierende Spielerobjekt
13
14RUECKGABEWERTE:
15 Mapping mit der Liste der Miniquests, fuer die das abfragende Objekt
16 zustaendig ist, oder leeres Mapping, wenn der Spieler keine MQs mehr
17 offen hat.
18
19 Die Liste enthaelt die Miniquestnummer als Key. Diesem sind zwei Werte
20 zugeordnet: zum einen ein Miniquest-Aufgabentext, und zum anderen -
21 falls der Spieler eine der Vorbedingungen fuer die Miniquest nicht
22 erfuellt - ein Hinweistext, der Auskunft gibt, welche Bedingung noch
23 zu erfuellen ist ("Seherstatus fehlt"). Diese Hinweistexte entsprechen
24 denen aus check_restrictions() in /std/restriction_checker.c. Der
25 jeweils andere Text wird auf 0 gesetzt.
26
27 Die Struktur des Mappings ist daher folgende:
28 ([ MQ-Nummer : <Aufgabenstellung> ; <Hinderungsgrund> ])
29
30 Beispiel: ein Spieler hat die Miniquests 18 und 49 noch nicht geloest,
31 erfuellt aber nur fuer Miniquest 49 die Anforderungen. Miniquest 18
32 erfordert den Seherstatus. Dann saehe das Mapping so aus:
33 ([ 18 : 0 ; "Dazu musst Du erst Seher werden.\n",
34 49 : "Aufgabentext_zu_49" ; 0 ])
35
36 Jedes abfragende Objekt muss daher dieses Mapping zunaecht geeignet
37 auf seinen Inhalt pruefen, um zu ermitteln, welche Meldung jeweils
38 auszugeben ist.
39
40BEMERKUNGEN:
41 Das abfragende Objekt muss von einem Erzmagier oder Gott (z.B. dem
42 zustaendigen Quest-EM) im Questmaster als zugriffsberechtigt bei den-
43 jenigen Miniquests eingetragen sein, fuer die es die entsprechenden
44 Miniquest-Hinweise ausgeben darf. Diese Berechtigung ist mit dem
45 Quest-EM abzustimmen. Anderen Objekten wird ein leeres Mapping zurueck-
46 gegeben.
47
48SIEHE AUCH:
49 AddMiniQuest(L), ChangeMiniQuest(L)
50 P_RESTRICTIONS
51 erzmagier
52
53----------------------------------------------------------------------------
54Last modified: 6. Juni 2014, Arathorn.