Quelltext der Seite GetGeneralState / setGeneralState

[[Category:NLTScript Referenz]]
GeneralStates sind "komplexere Variablen", die in der Party abgelegt werden können. Anders als "special" States sind General States nicht ortsgebunden.

<syntaxhighlight lang="javascript">
var mystate = getGeneralState("NAME_DES_STATES");
</syntaxhighlight>

In Object sind dann folgende Werte enthalten:
<syntaxhighlight lang="javascript">
mystate =
{"val": 0
"sval": ""
"fval": 0
"time": 0
"items": [array]}</syntaxhighlight>

'''val''' ist ein Ganzzahliger Zahlenwert<br>
'''sval''' ist eine Zeichenkette<br>
'''fval''' ist ein Gleitkomma Zahlenwert<br>
'''time''' ist ein Datums- und Uhrzeitwert, im üblichen "Tage seit 1. Praios 1008BF"<br>
'''items''' ist ein Itemset, das eine beliebige Anzahl an Items speichern kann<br>

Diese Werte können beliebig manipuliert werden, zum Beispiel:
<syntaxhighlight lang="javascript">
mystate.val = 27;
mystate["sval"] = "Heute ist ein schöner Tag"; // Der Zugriff mittels . oder [""] ist identisch
mystate.fval = 25.5;
mystate.time = 365.5; // = 1. Praios 1009BF, 12 Uhr
</syntaxhighlight>

Items enthalten pro Eintrag im Array ein vollständiges Itemobjekt, wie es zB aus [[getEquipped]] zurückgeliefert wird. Um den State zu aktualisieren, wird das Objekt selben Formats, egal ob direkt aus einem vorherigen getGeneralState oder im Code erzeugt, verwendet, also:
<syntaxhighlight lang="javascript">
setGeneralState("NAME_DES_STATES",mystate);
</syntaxhighlight>
Alternativ dazu, eine Liste vollständiger Itemobjekte zu übergeben, kann auch das ''list'' bzw. ''doublelist''-Format aus [[showItemsetList]] verwendet werden:
<syntaxhighlight lang="javascript">
var newstate = {"val":27,"list":[14,14,14,15,16,17]}; // = 3x Itemid 14, je 1x Itemid 15, 16 und 17
var newstate2 = {"sval":"Anderer GeneralState","doublelist":[14,3,28,5]}; // = 3x Itemid 14, 5x Itemid 28
setGeneralState("NEUER_STATE_1",newstate);
setGeneralState("NEUER_STATE_2",newstate2);
</syntaxhighlight>