
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.