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.