QueryOpenMiniQuestsForPlayer()

FUNKTION

mapping QueryOpenMiniQuestsForPlayer(object player)

DEFINIERT IN

/secure/questmaster

BESCHREIBUNG

Diese Funktion gibt die Liste der offenen Miniquests des Spielers als
Mapping zurueck.

ARGUMENTE

player - das interessierende Spielerobjekt

RUECKGABEWERTE

Mapping mit der Liste der Miniquests, fuer die das abfragende Objekt
zustaendig ist, oder leeres Mapping, wenn der Spieler keine MQs mehr
offen hat.

Die Liste enthaelt die Miniquestnummer als Key. Diesem sind zwei Werte
zugeordnet: zum einen ein Miniquest-Aufgabentext, und zum anderen -
falls der Spieler eine der Vorbedingungen fuer die Miniquest nicht
erfuellt - ein Hinweistext, der Auskunft gibt, welche Bedingung noch
zu erfuellen ist ("Seherstatus fehlt"). Diese Hinweistexte entsprechen
denen aus check_restrictions() in /std/restriction_checker.c. Der
jeweils andere Text wird auf 0 gesetzt.

Die Struktur des Mappings ist daher folgende:
  ([ MQ-Nummer : <Aufgabenstellung> ; <Hinderungsgrund> ])



Beispiel: ein Spieler hat die Miniquests 18 und 49 noch nicht geloest,
erfuellt aber nur fuer Miniquest 49 die Anforderungen. Miniquest 18
erfordert den Seherstatus. Dann saehe das Mapping so aus:
  ([ 18 : 0                    ; "Dazu musst Du erst Seher werden.\n",
     49 : "Aufgabentext_zu_49" ; 0 ])

Jedes abfragende Objekt muss daher dieses Mapping zunaecht geeignet
auf seinen Inhalt pruefen, um zu ermitteln, welche Meldung jeweils
auszugeben ist.

BEMERKUNGEN

Das abfragende Objekt muss von einem Erzmagier oder Gott (z.B. dem
zustaendigen Quest-EM) im Questmaster als zugriffsberechtigt bei den-
jenigen Miniquests eingetragen sein, fuer die es die entsprechenden
Miniquest-Hinweise ausgeben darf. Diese Berechtigung ist mit dem
Quest-EM abzustimmen. Anderen Objekten wird ein leeres Mapping zurueck-
gegeben.

SIEHE AUCH

AddMiniQuest(L), ChangeMiniQuest(L)
P_RESTRICTIONS
erzmagier

Last modified: 6. Juni 2014, Arathorn.