Vorbemerkungen / Module

Das Modding wird über „Moduldateien“ durchgeführt. Die Moduldatei enthält entsprechende Tags für die Bereiche des Spiels, die verändert werden sollen (z.B. <items>). Beim Einlesen der Moduldatei bei Spielstart werden dann die Einträge des Hauptspiels, die in der Moduldatei verändert wurden (z.B. Items, Monster, Text-Keys), überschrieben bzw. neue Einträge dem Spiel hinzugefügt.

Die Module werden im Ordner „Dokumente/BladeofDestiny/usermods“ abgelegt. Wenn ein Modul entfernt werden soll, genügt es, dieses aus dem Ordner zu löschen.

Pro Mod werden 2 Dateien benötigt:

– Die Moduldatei selbst und

– eine Datei „contentinfo.xml“

Diese verweist auf die zugehörige Moduldatei, so dass das Spiel weiß, welche Moduldatei zu laden ist.

Beide Dateien werden in einem entsprechenden Unterordner unter „usermods“ abgelegt.

Beispiel:

Ordner: usermods\testmod

Im Ordner „testmod“ dann:

– contentinfo.xml

– testmod.xml (= Moduldatei)

Contentinfo

Aufbau einer contentinfo.xml

<?xml version="1.0" encoding="utf-8"?>
<contentinfo>
	<loadversion>0</loadversion>
	<loadorder>2</loadorder>
	<combinedsettings>godgrace.xml</combinedsettings>
	<singlefile type="item">pictureofyou.jpg</singlefile>
	<singlefile type="character">runaway.jpg</singlefile>
	<singlefile>dumbatz.dsa1char</singlefile>
	<imagedirectory name="bilder" />
	<filedirectory name="dateien" />
</contentinfo>

loadorder gibt an, wie sich das Modul in Bezug auf andere Module in der Ladereihenfolge einreiht. Höher heißt später, und überschreibt etwaige frühere Einträge

combinedsettings die eigentliche Moduldatei, siehe unten

singlefile type=item ein Item-Bild, anzusprechen bei den Items mit image="pictureofyou", also ohne Erweiterung

singlefile type=character Ein Character-Image, anzusprechen mittels <charpic>user_runaway.jpg</charpic> in einem Character-File, also mit "user_" davor und Dateierweiterung danach. Enthält der Dateiname "_m", steht das Bild nur männlichen Chars zur Verfügung, analog mit "_w" für weibliche Chars. Enthält der Dateiname weder noch, steht das Bild beiden Geschlechtern zur Verfügung

singlefile Allgemeine Datei, für Character-Files (dsa1char) von etwaigen Companions und Voiceovers genutzt

imagedirectory name=<verzeichnis> Ein Verzeichnis namens "bilder" (parameter 'name') innerhalb des Moduls, das Bilddateien (jpg, jpeg, png) enthält. Diese sind dann mit dem selben Pfad (aber ohne Erweiterung) zB mittels setDialogueImage("<bildname>") ansprechbar

WICHTIG: imagedirectory durchsucht auch sämtliche Unterverzeichnisse nach Bildern, diese sind dann im Spiel als <unterverzeichnis>/<bildname> ansprechbar. So lassen sich zB auch die Standard-Charakterbilder überschreiben, indem ein Verzeichnis "images" angelegt wird, und dort eine Datei namens zB "magier_02.png" liegt, diese wäre dann im Spiel als "images/magier_02" ansprechbar.

filedirectory name=<verzeichnis> Filedirectory funktioniert analog zu singlefile, allerdings wird hier das gesamte Unterverzeichnis (inkl. Pfad) eingebunden. Dies kann zB verwendet werden, um Voiceovers hinzuzufügen oder zu überschreiben. Hierzu muss die übliche Voiceover-Verzeichnisstruktur eingehalten werden, d.h. die deutsche Sounddatei charcomment_1_f1.ogg muss im Pfad de/charcomment/charcomment_1_f1.ogg liegen.

Moduldatei

Aufbau einer Moduldatei

<?xml version="1.0" encoding="utf-8"?>
<combinedsettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<dungeons>
</dungeons>
	<routeevents />
	<buildingevents />
	<quests />
	<dialogpartner />
	<dialog />
	<monsters />
	<globalfights />
	<items />
	<texts language="de">
		<alltexts />
	</texts>
	<texts language="en">
		<alltexts />
	</texts>
</combinedsettings>