Schicksalsklinge Wiki - Benutzerbeiträge [de]

BreakInventoryItem

2016-11-08T11:38:37Z

Mordbrenner:

[[Category:NLTScript Referenz]]
<syntaxhighlight lang="javascript">
breakInventoryItem(INVENTAR-SLOT,CHAR-ID);
</syntaxhighlight>

Zerbricht die Waffe im übergebenen Inventar-Slot des Charakters mit der übergebenen Char-ID.

Zulässige Slots:

"weapon","shield","ring","leg","underleg","shoe","rightarm","leftarm","upperarm","chest","belly","coat","neck","head"

sowie die Inventar Slots: "inventory01" bis "inventory21"

--lunatic 19:13, 1. Feb. 2015 (CET)

RollCheck

2016-09-14T21:16:40Z

Mordbrenner:

[[Category:NLTScript Referenz]]
Beispiel:

<syntaxhighlight lang="javascript">
var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0, "cost":10});
</syntaxhighlight>

Das Ergebnis der Funktion wird in die Variable "res" geschrieben. Für den Aufruf werden folgende Parameter übergeben:

''which:'' Talent/Zauber, auf das/den die Probe abgelegt werden soll (wie in skills.xml definiert)

''who:'' die ID des Chars, der die Probe ablegen soll. Der 1. Char hat die ID 0, der 6. Char die ID 5.
Beim Parameter "best" wird automatisch der beste Char für die Probe ausgewählt. Achtung: "best" funktioniert nicht bei Zaubern.

''type:'' "skill" oder "spell" - ist wohl selbsterklärend - oder "wskill" für ein Waffentalent, oder "attrib" für ein Attribut

''mod:'' eine mögliche Probenerschwernis oder -erleichterung, negative Zahlen erschweren, positive erleichtern (optional)

''cost:'' nur verwendbar bei Zaubern, um die AE-Kosten zu definieren.

'''Ergebnisfelder:'''

''id:'' ID des Chars, der die Probe durchgeführt hat (interessant bei "best")

''ok:'' Probe gelungen

''notok:'' Probe misslungen

''resrem:'' übrig behaltene TaP* bzw. ZfP*

'''Beispiel für die Weiterverarbeitung des Ergebnisses:'''

<syntaxhighlight lang="javascript">

if (res && res.ok) return 3;
</syntaxhighlight>
Wenn es ein Resultat gibt (wenn der Char nicht handlungsfähig ist, gibt es nämlich kein Resultat) UND die Probe gelungen ist, wird zu ID 3 verzweigt.

<syntaxhighlight lang="javascript">

if (res && res.notok) return 4;
</syntaxhighlight>

Bei Misslingen der Probe wird zu ID 4 verzweigt.

<syntaxhighlight lang="javascript">

if (res && res.ok && res.resrem > 4) return 5;
</syntaxhighlight>

Wenn die Probe gelungen ist und mehr als 4 TaP* übrig behalten wurden, wird zu ID 5 verzweigt.

--lunatic 15:46, 12. Mär. 2014 (CET)

RollCheck

2016-09-14T21:16:30Z

Mordbrenner:

[[Category:NLTScript Referenz]]
Beispiel:

<syntaxhighlight lang="javascript">
var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0, "cost":10});
</syntaxhighlight>

Das Ergebnis der Funktion wird in die Variable "res" geschrieben. Für den Aufruf werden folgende Parameter übergeben:

''which:'' Talent/Zauber, auf das/den die Probe abgelegt werden soll (wie in skills.xml definiert)

''who:'' die ID des Chars, der die Probe ablegen soll. Der 1. Char hat die ID 0, der 6. Char die ID 5.
Beim Parameter "best" wird automatisch der beste Char für die Probe ausgewählt. Achtung: "best" funktioniert nicht bei Zaubern.

''type:'' "skill" oder "spell" - ist wohl selbsterklärend - oder "wskill" für ein Waffentalent, oder "attrib" für ein Attribut

''mod:'' eine mögliche Probenerschwernis oder -erleichterung, negative Zahlen erschweren, positive erleichtern (optional)

''cost:'' nur Verwendbar bei Zaubern, um die AE-Kosten zu definieren.

'''Ergebnisfelder:'''

''id:'' ID des Chars, der die Probe durchgeführt hat (interessant bei "best")

''ok:'' Probe gelungen

''notok:'' Probe misslungen

''resrem:'' übrig behaltene TaP* bzw. ZfP*

'''Beispiel für die Weiterverarbeitung des Ergebnisses:'''

<syntaxhighlight lang="javascript">

if (res && res.ok) return 3;
</syntaxhighlight>
Wenn es ein Resultat gibt (wenn der Char nicht handlungsfähig ist, gibt es nämlich kein Resultat) UND die Probe gelungen ist, wird zu ID 3 verzweigt.

<syntaxhighlight lang="javascript">

if (res && res.notok) return 4;
</syntaxhighlight>

Bei Misslingen der Probe wird zu ID 4 verzweigt.

<syntaxhighlight lang="javascript">

if (res && res.ok && res.resrem > 4) return 5;
</syntaxhighlight>

Wenn die Probe gelungen ist und mehr als 4 TaP* übrig behalten wurden, wird zu ID 5 verzweigt.

--lunatic 15:46, 12. Mär. 2014 (CET)

ChooseSingleCharacter

2016-01-28T07:03:35Z

Mordbrenner:

<syntaxhighlight lang="javascript">
{
chooseSingleCharacter(getLangString("TEXTKEY", []), "charSel");
return 255; }
}

function charSel(id) {
...SCRIPT...
}
</syntaxhighlight>

Mit dieser Funktion wird das Fenster zum Auswählen eines Charakters aus der Gruppe geöffnet. Der übergebene Textkey wird in dem Fenster angezeigt, z.B. "Wer soll das Schloss knacken ?" o.ä.

Nach dem Textkey wird die Callback-Funktion angegeben, die nach erfolger Charakter-Auswahl aufgerufen werden soll. In der Funktion selbst kann ein beliebiges Script ausgeführt werden. Die Char-ID, die vom Spieler ausgewählt wurde, wird dann in der Variablen "id" an diese Funktion übergeben.

Damit die callback-Funktion auch bei Schließen des Fensters per "x" ausgeführt wird, muss der Name der Funktion auf "always" enden. Also z.B. "charSelalways".

--lunatic 20:04, 1. Feb. 2015 (CET)

RollCheck

2015-12-17T13:47:19Z

Mordbrenner:

[[Category:NLTScript Referenz]]
Beispiel:

<syntaxhighlight lang="javascript">
var res = rollCheck({"which":"ueberreden","who":"best","type":"skill", "mod":0});
</syntaxhighlight>

Das Ergebnis der Funktion wird in die Variable "res" geschrieben. Für den Aufruf werden folgende Parameter übergeben:

''which:'' Talent/Zauber, auf das/den die Probe abgelegt werden soll (wie in skills.xml definiert)

''who:'' die ID des Chars, der die Probe ablegen soll. Der 1. Char hat die ID 0, der 6. Char die ID 5.
Beim Parameter "best" wird automatisch der beste Char für die Probe ausgewählt. Achtung: "best" funktioniert nicht bei Zaubern.

''type:'' "skill" oder "spell" - ist wohl selbsterklärend - oder "wskill" für ein Waffentalent, oder "attrib" für ein Attribut

''mod:'' eine mögliche Probenerschwernis oder -erleichterung, negative Zahlen erschweren, positive erleichtern (optional)

'''Ergebnisfelder:'''

''id:'' ID des Chars, der die Probe durchgeführt hat (interessant bei "best")

''ok:'' Probe gelungen

''notok:'' Probe misslungen

''resrem:'' übrig behaltene TaP* bzw. ZfP*

'''Beispiel für die Weiterverarbeitung des Ergebnisses:'''

<syntaxhighlight lang="javascript">

if (res && res.ok) return 3;
</syntaxhighlight>
Wenn es ein Resultat gibt (wenn der Char nicht handlungsfähig ist, gibt es nämlich kein Resultat) UND die Probe gelungen ist, wird zu ID 3 verzweigt.

<syntaxhighlight lang="javascript">

if (res && res.notok) return 4;
</syntaxhighlight>

Bei Misslingen der Probe wird zu ID 4 verzweigt.

<syntaxhighlight lang="javascript">

if (res && res.ok && res.resrem > 4) return 5;
</syntaxhighlight>

Wenn die Probe gelungen ist und mehr als 4 TaP* übrig behalten wurden, wird zu ID 5 verzweigt.

--lunatic 15:46, 12. Mär. 2014 (CET)

Dungeon

2015-10-12T11:46:58Z

Mordbrenner:

[[Category:Modding]]
Ein Dungeon im Spielsinn von Schicksalsklinge HD ist ein Bereich, in dem sich sog. [[#Trigger]] befinden, also dreidimensional definierte Bereiche, die bei "Berührung" durch eine Party eine Aktion auslösen. Für jeden Dungeon existiert ein Skriptbereich, der für den gesamten Dungeon sog. [[#Callbacks]] beinhaltet, also Funktion mit bestimmtem Namen, die bei bestimmten Aktionen aufgerufen werden. Ein Dungeon enthält außerdem die Definition von [[#Tür|Türen]] und deren Widerstandsfähigkeit gegen bestimmte Öffnungsarten, sowie [[#Truhe Truhen]], mit ähnlichen Definitionen. Außerdem sind sog. [[#Itemset Itemsets]] definiert, die als Inhalt von Truhen verwendet werden können.

= Übersicht XML =
Das Dungeon-XML ist in Bereiche unterteilt, die die Definition des Dungeon ausmachen:
<syntaxhighlight lang="XML">
<dungeon intname="dngf046">
<floor id="0">
<tiles>
<tile cdoorid="1" state="open" type="door" />
<tile cdoorid="2" state="locked" foramenmod="6" lockpickmod="-2" runinmod="3" type="door" />

<tile chestid="1" foramenmod="-6" lockpickmod="2" type="chest" />
<tile chestid="2" foramenmod="-6" lockpickmod="2" type="chest" />
</tiles>
<fights>
<fight fightname="f04604" extraAP="0">
<escape dir="0" x="1" y="10" lookdir="0" floor="0" />
<escape dir="1" x="3" y="14" lookdir="3" floor="0" />
<escape dir="2" x="1" y="10" lookdir="0" floor="0" />
<escape dir="3" x="3" y="14" lookdir="3" floor="0" />
<fightdata id="89" name="F04604">
<enemy>
<monster id="6" startin="1" />
<monster id="6" startin="1" />
<monster id="16" startin="1" />
<monster id="16" startin="1" />
</enemy>
<loot />
</fightdata>
</fight>

</fights>
<triggers>
<trigger name="coolerroom" x="11" y="-16.5" width="4" height="4" />
<trigger name="deadwanderer" x="2.5" y="-42" width="3" height="4" />
<trigger name="f04604" x="7" y="-8.5" width="6" height="6" />

</triggers>
</floor>
<script></script>
<itemsets>
<itemset id="chest_0_2">
<item id="3" />
<item id="98" />
<item id="4" />
</itemset>
<itemset id="chest_1_1">
<item id="47" />
<item id="149" />
<item id="236" count="1" />
<item id="180" count="1" />
<item id="169" />
<item id="204" />
<item id="243" />
</itemset>

</itemsets>
</dungeon>
</syntaxhighlight>
Jeder Dungeon ist in sog. "'''floor'''s", also Ebenen, unterteilt. Diese dienen als Container für Kämpfe, Tür- und Kistendefinitionen sowie Trigger. Allgemein für den gesamten Dungeon werden dann noch Itemsets und das sog. "Dungeonscript" gesetzt.

=floor=
Die floor-IDs sind numerisch und müssen aufsteigend gesetzt werden, beginnend mit "0".
==Tür==
Eine Tür wird mittels <tile cdoorid="XX" type="door"> definiert, wobei die existenten Tür-IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Eine Tür kann folgende optionale Eigenschaften erhalten:
* '''state''': Der Status der Tür bei Erst-Betreten des Dungeons. Mögliche Werte sind "open", "closed", und "locked"
* '''foramenmod''': Der Modifikator auf einen Zauberspruch "foramen", der zum Öffnen der Tür verwendet werden soll. Positive Werte erleichtern, negative erschweren.
* '''lockpickmod''': Der Modifikator auf eine Probe zum Öffnen der Tür mittels "Schlösser knacken"
* '''runinmod''': Der Modifikator für das Eintreten der Tür mittels Stärkeprobe von zwei Charakteren

==Geheimtür==
Wird mittels <tile cdoorid="XX" state="closed" type="secretdoor"> definiert, wobei die möglichen IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Geheimtüren werden über Trigger und das Dungeonscript geöffnet, eine Geheimtür mit "state="opened"" ist zwar theoretisch möglich, wäre aber relativ sinnlos.

==Entfernbare Hindernisse==
Werden mittels <tile cdoorid="XX" type="removeablewall"> definiert, wobei die möglichen IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Entfernbare Hindernisse sind zB die eingestürzten Bereiche in der Mine von Prem, die mittels graben von der Party entfernt werden können. Auch diese werden ausschließlich über das Dungeonscript "geöffnet".

==Truhe==
Diese wird mittels <tile chestid="XX" type="chest"> definiert, wobei wie bei Türen die IDs der Kisten durch das Dungeondesign vorgegeben sind. Eine Kiste kann folgende optionale Eigenschaften erhalten:
* '''foramenmod''': Der Modifikator auf einen Zauberspruch "foramen", der zum Öffnen der Truhe verwendet werden soll
* '''lockpickmod''': Der Modifikator auf eine Probe zum Öffnen der Truhe mittels "Schlösser knacken"
* '''trap''': Eine Falle, die beim missglückten Knacken des Schlosses auslöst. Als Wert wird die Schadensart übergeben, zB "physical" oder "fire"
* '''diecnt''', '''dietype''', '''mod''': Wie viel Schaden die Falle verursachen soll, als Würfelwurf. Beispiel: 2W6+3 = diecnt="2" dietype="6" mod="3"

= Dungeon-Recycling =
Diese Modability erlaubt es, die bestehenden Dungeon-Szenen mit komplett neuen Inhalten zu befüllen und auch komplett von vorne Erforschbar zu machen, d.h. die Karte wird neu aufgedeckt, das Ganze wird wie ein neuer Dungeon behandelt, aber halt mit dem selben Szenen-Unterbau. Ich brauche Euch glaub ich nicht zu erklären, was sich ändern lässt und was nicht. Jedenfalls funktioniert das wie folgt:

•In einer Mod einen "new dungeon" anlegen

•Einen Namen für den Dungeon vergeben, der mit "dng" beginnt

•Ins Dungeon-XML einen neuen Eintrag "<scene>[dungeonname]</scene>" einfügen, der den zu ladenden Dungeon angibt, also z.B. "<scene>[dngverlies]</scene>"

•Restliches XML und Dungeonscript entsprechend umsetzen, als Basis kann man hier auch den Originaldungeon verwenden

•Im Spiel erreicht man den Dungeon ganz normal über den Befehl "jumpToLocation({"where":"dungeonname"});" oder über Konsole mit "jump <neuerdungeonname>"

Dungeon

2015-10-12T11:46:30Z

Mordbrenner:

[[Category:Modding]]
Ein Dungeon im Spielsinn von Schicksalsklinge HD ist ein Bereich, in dem sich sog. [[#Trigger]] befinden, also dreidimensional definierte Bereiche, die bei "Berührung" durch eine Party eine Aktion auslösen. Für jeden Dungeon existiert ein Skriptbereich, der für den gesamten Dungeon sog. [[#Callbacks]] beinhaltet, also Funktion mit bestimmtem Namen, die bei bestimmten Aktionen aufgerufen werden. Ein Dungeon enthält außerdem die Definition von [[#Tür|Türen]] und deren Widerstandsfähigkeit gegen bestimmte Öffnungsarten, sowie [[#Truhe Truhen]], mit ähnlichen Definitionen. Außerdem sind sog. [[#Itemset Itemsets]] definiert, die als Inhalt von Truhen verwendet werden können.

= Übersicht XML =
Das Dungeon-XML ist in Bereiche unterteilt, die die Definition des Dungeon ausmachen:
<syntaxhighlight lang="XML">
<dungeon intname="dngf046">
<floor id="0">
<tiles>
<tile cdoorid="1" state="open" type="door" />
<tile cdoorid="2" state="locked" foramenmod="6" lockpickmod="-2" runinmod="3" type="door" />

<tile chestid="1" foramenmod="-6" lockpickmod="2" type="chest" />
<tile chestid="2" foramenmod="-6" lockpickmod="2" type="chest" />
</tiles>
<fights>
<fight fightname="f04604" extraAP="0">
<escape dir="0" x="1" y="10" lookdir="0" floor="0" />
<escape dir="1" x="3" y="14" lookdir="3" floor="0" />
<escape dir="2" x="1" y="10" lookdir="0" floor="0" />
<escape dir="3" x="3" y="14" lookdir="3" floor="0" />
<fightdata id="89" name="F04604">
<enemy>
<monster id="6" startin="1" />
<monster id="6" startin="1" />
<monster id="16" startin="1" />
<monster id="16" startin="1" />
</enemy>
<loot />
</fightdata>
</fight>

</fights>
<triggers>
<trigger name="coolerroom" x="11" y="-16.5" width="4" height="4" />
<trigger name="deadwanderer" x="2.5" y="-42" width="3" height="4" />
<trigger name="f04604" x="7" y="-8.5" width="6" height="6" />

</triggers>
</floor>
<script></script>
<itemsets>
<itemset id="chest_0_2">
<item id="3" />
<item id="98" />
<item id="4" />
</itemset>
<itemset id="chest_1_1">
<item id="47" />
<item id="149" />
<item id="236" count="1" />
<item id="180" count="1" />
<item id="169" />
<item id="204" />
<item id="243" />
</itemset>

</itemsets>
</dungeon>
</syntaxhighlight>
Jeder Dungeon ist in sog. "'''floor'''s", also Ebenen, unterteilt. Diese dienen als Container für Kämpfe, Tür- und Kistendefinitionen sowie Trigger. Allgemein für den gesamten Dungeon werden dann noch Itemsets und das sog. "Dungeonscript" gesetzt.

=floor=
Die floor-IDs sind numerisch und müssen aufsteigend gesetzt werden, beginnend mit "0".
==Tür==
Eine Tür wird mittels <tile cdoorid="XX" type="door"> definiert, wobei die existenten Tür-IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Eine Tür kann folgende optionale Eigenschaften erhalten:
* '''state''': Der Status der Tür bei Erst-Betreten des Dungeons. Mögliche Werte sind "open", "closed", und "locked"
* '''foramenmod''': Der Modifikator auf einen Zauberspruch "foramen", der zum Öffnen der Tür verwendet werden soll. Positive Werte erleichtern, negative erschweren.
* '''lockpickmod''': Der Modifikator auf eine Probe zum Öffnen der Tür mittels "Schlösser knacken"
* '''runinmod''': Der Modifikator für das Eintreten der Tür mittels Stärkeprobe von zwei Charakteren

==Geheimtür==
Wird mittels <tile cdoorid="XX" state="closed" type="secretdoor"> definiert, wobei die möglichen IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Geheimtüren werden über Trigger und das Dungeonscript geöffnet, eine Geheimtür mit "state="opened"" ist zwar theoretisch möglich, wäre aber relativ sinnlos.

==Entfernbare Hindernisse==
Werden mittels <tile cdoorid="XX" type="removeablewall"> definiert, wobei die möglichen IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Entfernbare Hindernisse sind zB die eingestürzten Bereiche in der Mine von Prem, die mittels graben von der Party entfernt werden können. Auch diese werden ausschließlich über das Dungeonscript "geöffnet".

==Truhe==
Diese wird mittels <tile chestid="XX" type="chest"> definiert, wobei wie bei Türen die IDs der Kisten durch das Dungeondesign vorgegeben sind. Eine Kiste kann folgende optionale Eigenschaften erhalten:
* '''foramenmod''': Der Modifikator auf einen Zauberspruch "foramen", der zum Öffnen der Truhe verwendet werden soll
* '''lockpickmod''': Der Modifikator auf eine Probe zum Öffnen der Truhe mittels "Schlösser knacken"
* '''trap''': Eine Falle, die beim missglückten Knacken des Schlosses auslöst. Als Wert wird die Schadensart übergeben, zB "physical" oder "fire"
* '''diecnt''', '''dietype''', '''mod''': Wie viel Schaden die Falle verursachen soll, als Würfelwurf. Beispiel: 2W6+3 = diecnt="2" dietype="6" mod="3"

==Dungeon-Recycling==
Diese Modability erlaubt es, die bestehenden Dungeon-Szenen mit komplett neuen Inhalten zu befüllen und auch komplett von vorne Erforschbar zu machen, d.h. die Karte wird neu aufgedeckt, das Ganze wird wie ein neuer Dungeon behandelt, aber halt mit dem selben Szenen-Unterbau. Ich brauche Euch glaub ich nicht zu erklären, was sich ändern lässt und was nicht. Jedenfalls funktioniert das wie folgt:

•In einer Mod einen "new dungeon" anlegen

•Einen Namen für den Dungeon vergeben, der mit "dng" beginnt

•Ins Dungeon-XML einen neuen Eintrag "<scene>[dungeonname]</scene>" einfügen, der den zu ladenden Dungeon angibt, also z.B. "<scene>[dngverlies]</scene>"

•Restliches XML und Dungeonscript entsprechend umsetzen, als Basis kann man hier auch den Originaldungeon verwenden

•Im Spiel erreicht man den Dungeon ganz normal über den Befehl "jumpToLocation({"where":"dungeonname"});" oder über Konsole mit "jump <neuerdungeonname>"

Dungeon

2015-10-12T11:45:26Z

Mordbrenner:

[[Category:Modding]]
Ein Dungeon im Spielsinn von Schicksalsklinge HD ist ein Bereich, in dem sich sog. [[#Trigger]] befinden, also dreidimensional definierte Bereiche, die bei "Berührung" durch eine Party eine Aktion auslösen. Für jeden Dungeon existiert ein Skriptbereich, der für den gesamten Dungeon sog. [[#Callbacks]] beinhaltet, also Funktion mit bestimmtem Namen, die bei bestimmten Aktionen aufgerufen werden. Ein Dungeon enthält außerdem die Definition von [[#Tür|Türen]] und deren Widerstandsfähigkeit gegen bestimmte Öffnungsarten, sowie [[#Truhe Truhen]], mit ähnlichen Definitionen. Außerdem sind sog. [[#Itemset Itemsets]] definiert, die als Inhalt von Truhen verwendet werden können.

= Übersicht XML =
Das Dungeon-XML ist in Bereiche unterteilt, die die Definition des Dungeon ausmachen:
<syntaxhighlight lang="XML">
<dungeon intname="dngf046">
<floor id="0">
<tiles>
<tile cdoorid="1" state="open" type="door" />
<tile cdoorid="2" state="locked" foramenmod="6" lockpickmod="-2" runinmod="3" type="door" />

<tile chestid="1" foramenmod="-6" lockpickmod="2" type="chest" />
<tile chestid="2" foramenmod="-6" lockpickmod="2" type="chest" />
</tiles>
<fights>
<fight fightname="f04604" extraAP="0">
<escape dir="0" x="1" y="10" lookdir="0" floor="0" />
<escape dir="1" x="3" y="14" lookdir="3" floor="0" />
<escape dir="2" x="1" y="10" lookdir="0" floor="0" />
<escape dir="3" x="3" y="14" lookdir="3" floor="0" />
<fightdata id="89" name="F04604">
<enemy>
<monster id="6" startin="1" />
<monster id="6" startin="1" />
<monster id="16" startin="1" />
<monster id="16" startin="1" />
</enemy>
<loot />
</fightdata>
</fight>

</fights>
<triggers>
<trigger name="coolerroom" x="11" y="-16.5" width="4" height="4" />
<trigger name="deadwanderer" x="2.5" y="-42" width="3" height="4" />
<trigger name="f04604" x="7" y="-8.5" width="6" height="6" />

</triggers>
</floor>
<script></script>
<itemsets>
<itemset id="chest_0_2">
<item id="3" />
<item id="98" />
<item id="4" />
</itemset>
<itemset id="chest_1_1">
<item id="47" />
<item id="149" />
<item id="236" count="1" />
<item id="180" count="1" />
<item id="169" />
<item id="204" />
<item id="243" />
</itemset>

</itemsets>
</dungeon>
</syntaxhighlight>
Jeder Dungeon ist in sog. "'''floor'''s", also Ebenen, unterteilt. Diese dienen als Container für Kämpfe, Tür- und Kistendefinitionen sowie Trigger. Allgemein für den gesamten Dungeon werden dann noch Itemsets und das sog. "Dungeonscript" gesetzt.

=floor=
Die floor-IDs sind numerisch und müssen aufsteigend gesetzt werden, beginnend mit "0".
==Tür==
Eine Tür wird mittels <tile cdoorid="XX" type="door"> definiert, wobei die existenten Tür-IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Eine Tür kann folgende optionale Eigenschaften erhalten:
* '''state''': Der Status der Tür bei Erst-Betreten des Dungeons. Mögliche Werte sind "open", "closed", und "locked"
* '''foramenmod''': Der Modifikator auf einen Zauberspruch "foramen", der zum Öffnen der Tür verwendet werden soll. Positive Werte erleichtern, negative erschweren.
* '''lockpickmod''': Der Modifikator auf eine Probe zum Öffnen der Tür mittels "Schlösser knacken"
* '''runinmod''': Der Modifikator für das Eintreten der Tür mittels Stärkeprobe von zwei Charakteren

==Geheimtür==
Wird mittels <tile cdoorid="XX" state="closed" type="secretdoor"> definiert, wobei die möglichen IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Geheimtüren werden über Trigger und das Dungeonscript geöffnet, eine Geheimtür mit "state="opened"" ist zwar theoretisch möglich, wäre aber relativ sinnlos.

==Entfernbare Hindernisse==
Werden mittels <tile cdoorid="XX" type="removeablewall"> definiert, wobei die möglichen IDs durch das Dungeondesign und dessen Daten vorgegeben sind. Entfernbare Hindernisse sind zB die eingestürzten Bereiche in der Mine von Prem, die mittels graben von der Party entfernt werden können. Auch diese werden ausschließlich über das Dungeonscript "geöffnet".

==Truhe==
Diese wird mittels <tile chestid="XX" type="chest"> definiert, wobei wie bei Türen die IDs der Kisten durch das Dungeondesign vorgegeben sind. Eine Kiste kann folgende optionale Eigenschaften erhalten:
* '''foramenmod''': Der Modifikator auf einen Zauberspruch "foramen", der zum Öffnen der Truhe verwendet werden soll
* '''lockpickmod''': Der Modifikator auf eine Probe zum Öffnen der Truhe mittels "Schlösser knacken"
* '''trap''': Eine Falle, die beim missglückten Knacken des Schlosses auslöst. Als Wert wird die Schadensart übergeben, zB "physical" oder "fire"
* '''diecnt''', '''dietype''', '''mod''': Wie viel Schaden die Falle verursachen soll, als Würfelwurf. Beispiel: 2W6+3 = diecnt="2" dietype="6" mod="3"

Dungeon-Recycling:
Diese Modability erlaubt es, die bestehenden Dungeon-Szenen mit komplett neuen Inhalten zu befüllen und auch komplett von vorne Erforschbar zu machen, d.h. die Karte wird neu aufgedeckt, das Ganze wird wie ein neuer Dungeon behandelt, aber halt mit dem selben Szenen-Unterbau. Ich brauche Euch glaub ich nicht zu erklären, was sich ändern lässt und was nicht. Jedenfalls funktioniert das wie folgt:

•In einer Mod einen "new dungeon" anlegen
•Einen Namen für den Dungeon vergeben, der mit "dng" beginnt
•Ins Dungeon-XML einen neuen Eintrag "<scene>[dungeonname]</scene>" einfügen, der den zu ladenden Dungeon angibt, also z.B. "<scene>[dngverlies]</scene>"
•Restliches XML und Dungeonscript entsprechend umsetzen, als Basis kann man hier auch den Originaldungeon verwenden
•Im Spiel erreicht man den Dungeon ganz normal über den Befehl "jumpToLocation({"where":"dungeonname"});" oder über Konsole mit "jump <neuerdungeonname>"

StartDialogue

2015-10-10T12:34:00Z

Mordbrenner:

<syntaxhighlight lang="javascript">
startDialogue(DIALOG-ID);
</syntaxhighlight>
Startet den Dialog mit der übergebenen ID.

Am besten immer in einer function forward() verwenden mit anschließendem "return tobecontinued;", um Probleme z.B. mit Bildern im Folge-Dialog zu vermeiden.

--lunatic 19:42, 31. Jan. 2015 (CET)
[[Category:NLTScript Referenz]]

SetDialogueImage

2015-08-30T14:19:46Z

Mordbrenner:

[[Category:NLTScript Referenz]]
<syntaxhighlight lang="javascript">
setDialogueImage("bildname");
</syntaxhighlight>
Ein Dialog hat die Möglichkeit, ein (kleines) Bild anzuzeigen. Dieses kann entweder direkt beim Dialogpartner definiert werden (bildid im XML bzw. Spalte "img" im DSATool), und gilt dann für den gesamten Dialog. Zusätzlich kann mittels setDialogueImage dieses Bild direkt im Dialog verändert werden, zur Verfügung stehen die Vanilla Ressourcen-Bilder (resources.asset, zB item/alchemieset, item/araxgift oder images/magier_04) aber auch alle Bilder, die über imagedirectory per Mod eingebunden wurden. Letztere werden "lazy" geladen, d.h. bei der ersten Verwendung kann es zu einer kurzen Verzögerung bis zur Bildanzeige kommen, je nach Größe des Bildes und Zugriffsgeschwindigkeit.

Das Bild wird auf 64x64 Pixel resized, egal wie groß das Grundbild ist.

Hinweis: Um eigene Bilder einzubinden, müssen diese in einem Mod im Unterordner bilder liegen und dieser muss auch in der contentinfo.xml des entsprechenden Mods eingefügt sein:
<syntaxhighlight lang="javascript">
<imagedirectory name="bilder"/>
</syntaxhighlight>

SetDialogueImage

2015-08-30T14:19:24Z

Mordbrenner:

SetDialogueImage

2015-08-30T14:18:31Z

Mordbrenner:

[[Category:NLTScript Referenz]]
<syntaxhighlight lang="javascript">
setDialogueImage("bildname");
</syntaxhighlight>
Ein Dialog hat die Möglichkeit, ein (kleines) Bild anzuzeigen. Dieses kann entweder direkt beim Dialogpartner definiert werden (bildid im XML bzw. Spalte "img" im DSATool), und gilt dann für den gesamten Dialog. Zusätzlich kann mittels setDialogueImage dieses Bild direkt im Dialog verändert werden, zur Verfügung stehen die Vanilla Ressourcen-Bilder (resources.asset, zB item/alchemieset, item/araxgift oder images/magier_04) aber auch alle Bilder, die über imagedirectory per Mod eingebunden wurden. Letztere werden "lazy" geladen, d.h. bei der ersten Verwendung kann es zu einer kurzen Verzögerung bis zur Bildanzeige kommen, je nach Größe des Bildes und Zugriffsgeschwindigkeit.

Das Bild wird auf 64x64 Pixel resized, egal wie groß das Grundbild ist.

Hinweis: Um eigene Bilder einzubinden, müssen diese immer auch in der contentinfo.xml des entsprechenden Mods eingefügt sein:
<imagedirectory name="bilder"/>

GetEquipped

2015-08-29T23:02:29Z

Mordbrenner:

<syntaxhighlight lang="javascript">
var res = getEquipped(Slot, Char-ID);
</syntaxhighlight>

Liefert ein Array mit Informationen über das Item, das der Charakter mit der übergebenen Char-ID im übergebenen Slot trägt.

Zulässige Slots:

"weapon","shield","rightring", "leftring", "leg","underleg","shoe","rightarm","leftarm", "upperarm","chest","belly","coat","neck","head"

sowie die Inventar Slots: "inventory01" bis "inventory21"

Zurückgelieferte Werte (gültig ab V1.35):

id: 14
name: Dolch
count: 1
expires: 0
isMagical: false
isBroken: false
isPersonal: false
isStackable: false
isTwohanded: false
skill: stichwaffen
recognized: false
varusestype:
armor: 0
damage: 1W6+1
AT: 0
PA: -1
BF: -1
kkfrom: 17
kkevery: 5
kkmod: 0
uses: 0
level: 0
canuse: JKSTZHMAFW
val: 200
weight: 20
totalweight: 20

Beispiel: Die Item-ID ist dann zu finden in der Variablen <syntaxhighlight lang="javascript">
res.id
</syntaxhighlight>

--lunatic 19:28, 31. Jan. 2015 (CET)

[[Category:NLTScript Referenz]]

Bilder

2015-07-12T13:32:12Z

Mordbrenner:

[[Category:Modding]]

<big>'''Einbinden von eigenen Bildern'''</big>

=== Charakterportraits per charimage-Ordner===

Im Verzeichnis "BladeofDestiny" (Unterverzeichnis "Dokumente" oder "Eigene Dateien" je nach Betriebssystem, nicht zu verwechseln mit dem Ordner "charimg" im Installationsverzeichnis) befindet sich der Ordner "charimage". In diesem können eigene Bilder abgelegt werden, die im Spiel dann als Charakterportraits zu Verfügung stehen.

Unterstützte Formate: png, jpg, jpeg

Größe: 256x256 Pixel

Durch die Dateinamenerweiterung "_m" oder "_w" wird sicher gestellt, dass das betreffende Bild entsprechend nur bei männlichen oder weiblichen Charakteren (in der Generierung oder beim Durchklicken im Charakterbogen) zur Verfügung steht.

Möchte man einer Charakterdatei (.dsa1char) ein festes Bild aus diesem Verzeichnis zuordnen, geschieht dies wie folgt:

<syntaxhighlight lang="xml">
<charpic>user_BILDNAME</charpic>
</syntaxhighlight>

=== Bilder per Modul einbinden ===

In der Datei "contentinfo.xml" eines Moduls kann man einen Bilder-Ordner definieren, der einen beliebigen Namen tragen kann, z.B. so:

<syntaxhighlight lang="xml">
<imagedirectory name="eigenebilder" />
</syntaxhighlight>

Einen Ordner mit entsprechendem Namen legt man dann als Unterordner des Modulordners an und kopiert alle gewünschten Bilderdateien dort hinein.

Hierzu ist zu beachten, dass entsprechende Unterordner angelegt werden müssen. Um zB ein Monsterportrait mittels "lareslot" ansprechen zu können, muss es sich unterhalb des Bilderordners des Moduls im ordner "battle/monsterportrait" befinden. Die Ordner lauten:
Items: item
Kampfgegner: battle/monsterportrait
Götterflaggen (auch in den Dörfern draußen): godflag, name der Datei "fahne_<gottheit>" (zB fahne_firun oder fahne_rahja)
PlayerPortraits: charimgm und charimgw

Bei den Playerportraits bitte beachten, dass diese für Module OHNE Erweiterung referenziert werden müssen. Ein Beispiel:

Das Bild heißt bilder/charimgw/skalde03.jpg (wobei "bilder" der Imagefolder ist). D.h. in der Characterdefinition müsste es dann so angesprochen werden:

<charimg>
<f>skalde03</f>
</charimg>

===== Zugriff auf die Bilder im XML/Javascript =====

''Der Zugriff auf eine Bilddatei erfolgt immer ohne Angabe der Dateiendung!''

Im Tag "bildid" des Haupttags "dialogpartner" kann der Dateiname der Bilddatei direkt angegeben werden, so dass das Bild dann während des gesamten Dialogs angezeigt wird.

<syntaxhighlight lang="xml">
<partner>
<id>info7_1</id>
<name>info7_1_hl</name>
<bildid>eigenesbild</bildid>
</partner>
</syntaxhighlight>

Zusätzlich gibt es die JS-Funktion [[setDialogueImage]], die darüber hinaus den Vorteil bietet, auch im Laufe eines Dialogs (je nach gerade aktiver Dialog-ID) ein Bild anzuzeigen bzw. zu wechseln.

<syntaxhighlight lang="javascript">
setDialogueImage("eigenesbild2");
</syntaxhighlight>

Unterstützte Formate: png, jpg, jpeg

Größe: Die Bilder werden bis zu einer Größe von 256*256 Pixel in ihrer nativen Größe dargestellt, wenn sie größer sind, werden sie auf 256*256 Pixel skaliert.

==== Bilder aus den asset-Dateien des Spiels in Dialogen anzeigen ====

Über [[setDialogueImage]] kann man auch auf die Ressourcen-Bilder aus den Assets zugreifen und diese in einem Dialog anzeigen. Für Itembilder wird dem Namen des Bildes "item/" vorangestellt, für Charakterportraits "images/".

<syntaxhighlight lang="javascript">
setDialogueImage("item/hexenbesen");
</syntaxhighlight>

<syntaxhighlight lang="javascript">
setDialogueImage("images/druide_01");
</syntaxhighlight>

--lunatic 21:06, 1. Mai 2015 (CEST)

Bilder

2015-07-12T13:30:54Z

Mordbrenner:

[[Category:Modding]]

<big>'''Einbinden von eigenen Bildern'''</big>

=== Charakterportraits per charimage-Ordner===

Im Verzeichnis "BladeofDestiny" (Unterverzeichnis "Dokumente" oder "Eigene Dateien" je nach Betriebssystem, nicht zu verwechseln mit dem Ordner "charimg" im Installationsverzeichnis) befindet sich der Ordner "charimage". In diesem können eigene Bilder abgelegt werden, die im Spiel dann als Charakterportraits zu Verfügung stehen.

Unterstützte Formate: png, jpg, jpeg

Größe: 256x256 Pixel

Durch die Dateinamenerweiterung "_m" oder "_w" wird sicher gestellt, dass das betreffende Bild entsprechend nur bei männlichen oder weiblichen Charakteren (in der Generierung oder beim Durchklicken im Charakterbogen) zur Verfügung steht.

Möchte man einer Charakterdatei (.dsa1char) ein festes Bild aus diesem Verzeichnis zuordnen, geschieht dies wie folgt:

<syntaxhighlight lang="xml">
<charpic>user_BILDNAME</charpic>
</syntaxhighlight>

=== Bilder per Modul einbinden ===

In der Datei "contentinfo.xml" eines Moduls kann man einen Bilder-Ordner definieren, der einen beliebigen Namen tragen kann, z.B. so:

<syntaxhighlight lang="xml">
<imagedirectory name="eigenebilder" />
</syntaxhighlight>

Einen Ordner mit entsprechendem Namen legt man dann als Unterordner des Modulordners an und kopiert alle gewünschten Bilderdateien dort hinein.

Hierzu ist zu beachten, dass entsprechende Unterordner angelegt werden müssen. Um zB ein Monsterportrait mittels "lareslot" ansprechen zu können, muss es sich unterhalb des Bilderordners des Moduls im ordner "battle/monsterportrait" befinden. Die Ordner lauten:
Items: item
Kampfgegner: battle/monsterportrait
Götterflaggen (auch in den Dörfern draußen): godflag, name der Datei "fahne_<gottheit>" (zB fahne_firun oder fahne_rahja)
PlayerPortraits: charimgm und charimgw

Bei den Playerportraits bitte beachten, dass diese für Module OHNE Erweiterung referenziert werden müssen. Ein Beispiel:

Das Bild heißt bilder/charimgw/skalde03.jpg (wobei "bilder" der Imagefolder ist). D.h. in der Characterdefinition müsste es dann so angesprochen werden:

Quellcode

1
2
3

<charimg>
<f>skalde03</f>
</charimg>

===== Zugriff auf die Bilder im XML/Javascript =====

''Der Zugriff auf eine Bilddatei erfolgt immer ohne Angabe der Dateiendung!''

Im Tag "bildid" des Haupttags "dialogpartner" kann der Dateiname der Bilddatei direkt angegeben werden, so dass das Bild dann während des gesamten Dialogs angezeigt wird.

<syntaxhighlight lang="xml">
<partner>
<id>info7_1</id>
<name>info7_1_hl</name>
<bildid>eigenesbild</bildid>
</partner>
</syntaxhighlight>

Zusätzlich gibt es die JS-Funktion [[setDialogueImage]], die darüber hinaus den Vorteil bietet, auch im Laufe eines Dialogs (je nach gerade aktiver Dialog-ID) ein Bild anzuzeigen bzw. zu wechseln.

<syntaxhighlight lang="javascript">
setDialogueImage("eigenesbild2");
</syntaxhighlight>

Unterstützte Formate: png, jpg, jpeg

Größe: Die Bilder werden bis zu einer Größe von 256*256 Pixel in ihrer nativen Größe dargestellt, wenn sie größer sind, werden sie auf 256*256 Pixel skaliert.

==== Bilder aus den asset-Dateien des Spiels in Dialogen anzeigen ====

Über [[setDialogueImage]] kann man auch auf die Ressourcen-Bilder aus den Assets zugreifen und diese in einem Dialog anzeigen. Für Itembilder wird dem Namen des Bildes "item/" vorangestellt, für Charakterportraits "images/".

<syntaxhighlight lang="javascript">
setDialogueImage("item/hexenbesen");
</syntaxhighlight>

<syntaxhighlight lang="javascript">
setDialogueImage("images/druide_01");
</syntaxhighlight>

--lunatic 21:06, 1. Mai 2015 (CEST)

DamageCurrentWeapon

2015-06-12T13:50:17Z

Mordbrenner:

'''damageCurrentWeapon({"who":i,"mandatory":true})'''

Diese Funktion erhöht den BF der aktuell ausgerüsteten Waffe.

Wird '''"who"''' nicht definiert, so sind die ausgerüsteten Waffen der kompletten Gruppe betroffen.

'''"mandatory"''':true/false -> Bei true wird der BF bei der Waffe direkt erhöht ohne Bruchtest. Bei false wird eine BF-Probe gewürfelt (Waffe kann zerbrechen).

DamageCurrentWeapon

2015-06-12T07:16:16Z

Mordbrenner: Die Seite wurde neu angelegt: „'''damageCurrentWeapon({"who":i,"mandatory":true})''' Diese Funktion erhöht den BF der aktuell ausgerüsteten Waffe. Wird '''"who"''' nicht definiert, so s…“

'''damageCurrentWeapon({"who":i,"mandatory":true})'''

Diese Funktion erhöht den BF der aktuell ausgerüsteten Waffe.

Wird '''"who"''' nicht definiert, so sind die ausgerüsteten Waffen der kompletten Gruppe betroffen.

Zu prüfen:
'''"mandatory"''':true/false -> Bei true wird der BF bei der Waffe direkt erhöht ohne Bruchtest. Bei false wird eine BF-Probe gewürfelt (Waffe kann zerbrechen).