blob: cf43274da26a50c5edddb5978c0c75d48999e281 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001ChangeMiniQuest()
2=================
3
4FUNKTION
5--------
6::
7
8 int ChangeMiniQuest(mixed questgeber, int parameter, mixed newvalue)
9
10DEFINIERT IN
11------------
12::
13
14 /secure/questmaster
15
16BESCHREIBUNG
17------------
18::
19
20 Diese Funktion aendert einen Parameter einer Miniquest im Questmaster,
21 schreibt fuer diese Aktion einen Log-Eintrag und erstellt das Miniquest-
22 Dumpfile neu.
23
24ARGUMENTE
25---------
26::
27
28 questgeber - Ladename des Objekts (string), das die Miniquest vergibt,
29 oderdie Indexnummer (int) der Miniquest in der MQ-Liste
30 parameter - Angabe des zu aendernen Parameters (Position des Values
31 im Miniquests-Mapping):
32 0 : Miniquest-Stufenpunkte, mind. 1
33 2 : Aufgabenbeschreibung der Miniquest (string)
34 3 : Sichtbarkeit der Miniquest (0/1), default ist 1
35 4 : aktiv/inaktiv (1/0)
36 5 : Titel der Miniquest
37 6 : "geschafft"-Beschreibung nach Abschluss der MQ
38 7 : Voraussetzungen, Mapping im Format von P_RESTRICTIONS
39 8 : zugeordnete Region, String wie z.B."polar", "gebirge"
40 9 : erlaubte Abfrageobjekte, Array von Ladenamen, z.B.
41 ({"/d/region/magier/npc/infonpc"}), es koennen mehrere
42 Objekte eingetragen sein
43 newvalue - neuer Wert fuer den angegebenen Parameter
44
45RUECKGABEWERTE
46--------------
47::
48
49 1: hat geklappt
50 0: Zugriff verweigert
51 -2: ungueltiger Datentyp eines der Argumente, bei Parameter 9 wird
52 ein uebergebenes Array zusaetzlich auf Leerstrings und Elemente
53 geprueft, die keine Strings sind. Wenn das Array ausschliesslich
54 aus solchen Elementen besteht, wird ebenfalls -2 zurueckgegeben.
55
56BEMERKUNGEN
57-----------
58::
59
60 Das Flag "active" laesst sich bequemer ueber die Questmaster-Funktion
61 SwitchMiniQuestActive() umschalten.
62 Der Miniquest-Titel darf kein "in" oder "im" enthalten, weil dann die
63 Eintraege in der Fraternitas-Bibliothek nicht gelesen werden
64 koennen.
65
66SIEHE AUCH
67----------
68::
69
70 AddMiniQuest(L)
71 P_RESTRICTIONS
72