Vorbemerkungen / Module: Unterschied zwischen den Versionen
Aus Sternenschweif Wiki
(→Contentinfo) |
|||
| (12 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| + | [[Category:Modding]] | ||
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. | 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. | ||
| Zeile 25: | Zeile 26: | ||
| − | + | =Contentinfo= | |
'''Aufbau einer contentinfo.xml''' | '''Aufbau einer contentinfo.xml''' | ||
| − | + | <syntaxhighlight lang="xml"> | |
<?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | ||
| − | |||
<contentinfo> | <contentinfo> | ||
| − | |||
<loadversion>0</loadversion> | <loadversion>0</loadversion> | ||
| − | + | <loadorder>2</loadorder> | |
| − | <loadorder> | + | |
| − | + | ||
<combinedsettings>godgrace.xml</combinedsettings> | <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> | </contentinfo> | ||
| + | </syntaxhighlight> | ||
| + | * ''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<br>'''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''' | '''Aufbau einer Moduldatei''' | ||
| − | + | <syntaxhighlight lang="xml"> | |
<?xml version="1.0" encoding="utf-8"?> | <?xml version="1.0" encoding="utf-8"?> | ||
| − | |||
<combinedsettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> | <combinedsettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> | ||
| − | |||
<dungeons> | <dungeons> | ||
| − | |||
</dungeons> | </dungeons> | ||
| − | |||
<routeevents /> | <routeevents /> | ||
| − | |||
<buildingevents /> | <buildingevents /> | ||
| − | |||
<quests /> | <quests /> | ||
| − | |||
<dialogpartner /> | <dialogpartner /> | ||
| − | |||
<dialog /> | <dialog /> | ||
| − | |||
<monsters /> | <monsters /> | ||
| − | |||
<globalfights /> | <globalfights /> | ||
| − | |||
<items /> | <items /> | ||
| − | |||
<texts language="de"> | <texts language="de"> | ||
| − | |||
<alltexts /> | <alltexts /> | ||
| − | |||
</texts> | </texts> | ||
| − | |||
<texts language="en"> | <texts language="en"> | ||
| − | |||
<alltexts /> | <alltexts /> | ||
| − | |||
</texts> | </texts> | ||
| − | |||
| − | |||
</combinedsettings> | </combinedsettings> | ||
| − | + | </syntaxhighlight> | |
| − | + | ||
| − | + | ||
Aktuelle Version vom 25. Juli 2017, 13:44 Uhr
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>
