Customlog – editierbares Spielerlogbuch (v1.0.1)
Das Customlog – editierbares Spielerlogbuch fügt dem Spiel ein neues Spielerlogbuch hinzu, das es dem Spieler ermöglicht Nachrichten in verschiedene Kategorien zu schreiben, sie zu löschen und zu verwalten. Auch bietet es anderen Scriptern die Möglichkeit, Nachrichten von ihren Scripten in das Customlog zu schreiben.

Index
Informationen für Spieler: Installation, Funktion, Kompatibilität
Download und Liste der Änderungen
Informationen für Scripter

1. Die Installation
Lade das Script-Archiv herunter und entpacke es in dein Spielverzeichnis.
Für X3: Terran Conflict findet sich dieses standardmäßig unter
C:\Programme\Egosoft\X3 Terran Conflict oder
C:\Programme\Steam\steamapps\common\X3 Terran Conflict
Für X3: Albion Prelude findet sich dieses standardmäßig unter
C:\Programme\Steam\steamapps\common\X3 Terran Conflict\addon
Nach dem Entpacken sollten sich alle Dateien des Archivs – sie sind weiter unten aufgelistet – in ihren entsprechenden Ordnern im X3TC-Verzeichnis oder dessen "addon"-Ordner befinden.
Beachte: Nur zur Sicherheit solltest du vor der Installation des Scripts auch eine Sicherungskopie deiner Spielstände anlegen. Das Standardverzeichnis der Spielstände lautet
C:\Benutzer\[Beutzername]\Dokumente\Egosoft\X3TC\save für X3TC oder
C:\Benutzer\[Benutzername]\Dokumente\Egosoft\X3AP\save für X3AP.
(C: entspricht hier dem Buchstaben deines Betriebssystemlaufwerks.)
2. Die Funktion
Das Customlog kann über die Zusätzlichen Schiffskommandos über die Kommandokonsole deiner Schiffe geöffnet werden.
Customlog Hauptmenü
Das Hauptmenü zeigt alle verfügbaren Kategorien des Customlogs an sowie Optionen, um diese zu verwalten.
[ external image ]
(Zum Vergrößern bitte klicken.)
- Neue Nachricht hinzufügen
Wählt man diese Option aus, so wird man gebeten eine Nachrichten in ein Textfeld einzugeben. Anschließend muss man aus den verfügbaren Kategorien eine Kategorie auswählen, zu der die Nachricht dann hinzugefügt wird. Ist keine Kategorie passend, drücke ‘Esc’ und du wirst nach dem Namen einer neuen Kategorie gefragt, die dann erstellt wird. - Neue Kategorie hinzufügen
Wählt man diese Option aus, so wird man nach dem Namen für eine neue Kategorie gefragt. Existiert eine Kategorie mit gleichem Namen bereits, so muss man die Erstellung der neuen Kategorie zusätzlich noch bestätigen. Eine neue Kategorie wird immer ans Ende der Liste aller Kategorien gesetzt. - Position von Kategorie ändern
Mit dieser Option lässt sich die Position einer Kategorie in der Liste aller Kategorien ändern.
Wählt man diese Option wird man zuerst nach der zu verschiebenden Kategorie und an-schließend nach ihrer neuen Position gefragt. - Kategorie löschen
Wählt man diese Option, so muss man eine Kategorie aus der Liste der verfügbaren Kategorien auswählen, die dann gelöscht wird. Vor der Ausführung dieser Aktion, muss man eine zusätzliche Abfrage bestätigen. Bitte beachte, dass bei der Löschung einer Kategorie alle Nachrichten in ihr ebenfalls gelöscht werden. - Optionen
Hier können verschiedene Optionen eingestellt werden, die dann in allen Menüs Anwendung finden. Klicke einfache auf eine Option, um die verfügbaren Eingabewerte durchzuschalten oder das zugehörige Eingabefeld aufzurufen.
[ external image ]
(Zum Vergrößern bitte klicken.)
(Bitte beachte: Die einzelnen Optionen werden in der Customlog_LiesMich.pdf Datei, die sich nach der Installation des Scripts im Documents-Ordner findet.) - Schließen
Dies schließt das Customlog. (Das Gleiche passiert, wenn man "Esc" drückt.)
Kategoriemenü
Das Kategoriemenü zeigt alle Nachrichten der gewählten Kategorie an sowie Funktionen, um diese zu verwalten.
[ external image ]
(Zum Vergrößern bitte klicken.)
- Neue Nachricht hinzufügen
Wählt man diese Option aus, so wird man gebeten eine Nachrichten in ein Textfeld einzugeben. Diese Nachricht wird dann zur aktuellen Kategorie hinzugefügt. - Kategorie wechseln
Hiermit kann man einfach zu einer anderen Kategorie wechseln, ohne zum Hauptmenü zu-rückkehren zu müssen. - Kategorie umbenennen
Wählt man diese Option aus, so wird man nach einem neuen Namen für die aktuelle Kategorie gefragt. Existiert eine gleichnamige Kategorie, so muss man noch eine zusätzliche Abfrage bestätigen, ehe die Kategorie erstellt wird. - Alle Nachrichten in Logdatei schreiben
Dies schreibt alle Nachrichten der aktuellen Kategorie in die Logdatei, deren ID in den Optionen des Hauptmenüs angegeben ist. Bevor der Befehl ausgeführt wird, wird man gefragt, ob man die Nachrichten an die bereits existierende Datei anhängen möchte. Klickt man auf "Ja" und eine Logdatei mit der gewählten ID existiert bereits, so werden die Nachrichten zu den in der Datei vorhandenen hinzugefügt. Klickt man auf "Nein", so werden alle bestehenden Nachrichten in der Logdatei zunächste gelöscht, ehe die neuen Nachrichten hineingeschrieben werden. Ist noch keine Datei vorhanden, so wird sie in beiden Fällen erstellt. Außerdem wird man gefragt, ob man anschließend alle Kategorien aus der gewählten Kategorie löschen möchte. - Die Logdatei wird unter folgendem Pfad gespeichert
C:\Benutzer\[Benutzername]\Documente\Egosoft\X3TC oder
C:\Benutzer\[Benutzername]\Dokumente\Egosoft\X3AP
(C: entspricht hier dem Buchstaben deines Betriebssystemlaufwerks.) - Alle Nachrichten aus dieser Kategorie löschen
Dies löscht alle Nachrichten aus der aktuellen Kategorie. Die Ausführung dieses Befehls muss über eine zusätzliche Abfrage bestätigt werden. - <Anzahl> neueste Nachrichten löschen
Dies löscht die angezeigte Anzahl neuester Nachrichten (d.h. die, die zuletzt hinzugefügt wurden) aus der aktuellen Kategorie. Die Anzahl kann in den Optionen des Hauptmenüs geändert werden. Die Ausführung dieses Befehls muss über eine zusätzliche Abfrage bestätigt werden. - <Anzahl> älteste Nachrichten löschen
Dies löscht die angezeigte Anzahl ältester Nachrichten (d.h. die, die als erstes zur Kategorie hinzugefügt wurde) aus der aktuellen Kategorie. Die Anzahl kann in den Optionen des Hauptmenüs geändert werden. Die Ausführung dieses Befehls muss über eine zusätzliche Abfrage bestätigt werden. - Zurück zum Hauptmenü
Dies bringt dich zurück zum Hauptmenü. (Das Gleiche passiert, wenn man "Esc" drückt.)
In der Nachrichtenliste werden alle Nachrichten zusammen mit der Zeit, zu der sie ins Logbuch geschrieben wurden, angezeigt. Ist die Nachricht zu lang, um in einer Zeile angezeigt zu werden, wird nur der erste Teil der Nachricht dargestellt. Die komplette Nachricht kann im Nachrichtenmenü gelesen werden, welches man über einen Klick auf die Nachricht öffnet.
Nachrichtenmenü
Das Nachrichtenmenü zeigt die vollständige Nachricht an sowie Funktionen, um diese zu verwalten.
[ external image ]
(Zum Vergrößern bitte klicken.)
- Nachricht editieren
Die öffnet das Nachrichten editieren-Menü.
[ external image ]
(Zum Vergrößern bitte klicken.)
Zunächst wählt man die Zeile aus der Originalnachricht, die man editieren möchte. Anschlie-ßend kann man die geänderte Zeile eingeben. In der Zwischenzeit wird die Originalzeile als Untertitel angezeigt. Ist man mit seinen Änderungen zufrieden, wählt man die "Änderungen anwenden"-Optionen, um seine Änderungen zu speichern und zum Nachrichtenmenü zurückzukehren.
Bitte beachte: Aufgrund der Größenbegrenzung von Custom-Menüs werden lange Nachrichten in mehrere Zeilen aufgeteilt. Solche Nachrichten können nicht als Ganzes, sondern immer nur zeilenweise editiert werden. Es gibt zudem keine Möglichkeit, Text bereits in einer Eingabezeile anzuzeigen, wodurch man – selbst bei kleinen Änderungen – die ganze Zeile noch einmal abtippen muss. - Nachricht in andere Kategorie verschieben
Hierüber kann man eine Nachricht in eine andere Kategorie verschieben. Hierzu wählt man die Zielkategorie aus, in die die Nachricht verschoben werden soll. Drückt man "Esc" oder ist die Nachricht bereits in der gewählten Kategorie enthalten, bleibt die Nachricht, wo sie ist. - Nachricht in Logdatei schreiben
Dies schreibt die Nachricht in die Logdatei, deren ID in den Optionen des Hauptmenüs angegeben ist. Vor Ausführung des Befehls wird man gefragt, ob die Nachricht an die existierende Datei angehängt werden soll. Klickt man auf "Ja" und eine Logdatei mit gleicher ID existiert bereits, so wird die Nachricht an den Inhalt dieser Datei angehängt. Drückt man auf "Nein" so wird der Inhalt der bestehenden Logdatei gelöscht und die Nachricht alleine hineingeschrieben. Ist noch keine Datei vorhanden, so wird sie in beiden Fällen erstellt. Die Logdatei wird unter folgendem Pfad gespeichert:
C:\Benutzer\[Benutzername]\Dokumente\Egosoft\X3TC oder
C:\Benutzer\[Benutzername]\Dokumente\Egosoft\X3AP
(C: entspricht hier dem Buchstaben deines Betriebssystemlaufwerks.) - Nachricht löschen
Dies löscht die Nachricht. Die Ausführung dieses Befehls muss über eine zusätzliche Abfrage bestätigt werden. - Zurück zum Kategoriemenü.
Dies bringt dich zurück zum Kategoriemenü. (Das Gleiche passiert, wenn man "Esc" drückt.)
Weitere Informationen
Einfärben von Texten
Beim Hinzufügen oder Editieren von Nachrichten können einzelne Wörter oder auch die gesamte Nachricht eingefärbt werden. Hierzu stehen verschiedene HTML oder BB-Code ähnliche Tags zur Verfügung. Die Farbtags bestehen jeweils aus einem öffnenden und schließenden Farbtag und einem Farbcode: <c=F></c>. Dabei werden die folgenden Farbcodes und Farben unterstützt:
[ external image ]
(Zum Vergrößern bitte klicken.)
Die Farbtags lassen sich auf verschiedene Arten anwenden:
1. Ein einzelnes Wort einfärben.
Das zu färbende Wort befindet sich zwischen dem öffnenden und schließenden Farbtag.
[ external image ]
(Zum Vergrößern bitte klicken.)
[ external image ]
(Zum Vergrößern bitte klicken.)
2. Mehrere Wörter oder eine ganze Zeile einfärben.
Alle Wörter zwischen dem öffnenden Farbtag und dem nächsten schließenden oder öffnenden Farbtag oder bis zum Nachrichten-/Zeilenende werden in der angegebenen Farbe eingefärbt.
[ external image ]
(Zum Vergrößern bitte klicken.)
[ external image ]
(Zum Vergrößern bitte klicken.)
[ external image ]
(Zum Vergrößern bitte klicken.)
[ external image ]
(Zum Vergrößern bitte klicken.)
3. (In)kompatibilitäten und Grenzen
Dieses Script ist mit allen X3: Terran Conflict Versionen größer gleich 2.5 und mit allen X3: Albion Prelude Versionen größer gleich 1.0 kompatibel. Es ist ebenso mit allen Scripts und Mods kompatibel, die nicht den gleichen Kommandoslot (COMMAND_TYPE_SHIP_26) und die gleiche Textdatei / Textseite (7330) nutzen.
Da das Customlog sogenannte Custom-Menüs nutzt, hat es einige Limitierungen – speziell im Hinblick auf die Textdarstellungen und -eingabe. Ich werde versuchen, die Funktionen wo möglich zu verbessern. Jedoch gibt es diverse Dinge, wie die Eingabe von Text, die einfach durch die Script-Engine begrenzt sind und nicht weiter verbessert werden können. Davon abgesehen habe ich versucht, die Anzahl an Menüs – und damit auch die Anzahl der Klicke, um eine bestimmte Funktion zu erreichen – möglichst gering zu halten, und trotzdem mehr Funktionen als das normale Logbuch einzubauen.
Was das Script nicht tun wird, ist alle Nachrichten, die ins normale Logbuch geschrieben werden, ins Customlog umzuleiten. Nur Nachrichten von Scripten, die das Customlog unterstützen und natürlich alle Nachrichten, die man selbst hinzufügt, werden ins Customlog geschrieben.
Ich weiß, dass es einen (treiberbezogenen) Bug mit AMD-Grafikkarten gibt, der die Navigation (das Scrollen) in Menüs extrem verlangsamt. Da ich keine aktuelle AMD-Grafikkarte habe, kann ich nicht testen, inwiefern dieser Bug auch in diesem Script auftritt. Sollte der Bug auftreten, empfehle ich, die Anzahl an angezeigten Nachrichten zu reduzieren. (Siehe hierzu die Optionen des Customlog Hauptmenüs.)
4. Bekannte Bugs
- - Zurzeit keine (v1.0)
- - Funktion zum Verschieben alle Nachrichten von einer in eine ander Kategorie hinzufügen
- Funktion zum Sortieren von Nachrichten hinzufügen
- Anzeige von Nachrichten verbessern
- Nachrichteneditierfunktion verbessern
- Aufräumarbeiten
Öffne die Sprachdatei des Customlog für die Sprache, in der du spielst, mit einem beliebigen Text- oder XML-Editor: 7330-L0xx.xml (xx steht für den Sprachcode, 49 = Deutsch, 44 = Englisch). Die Datei findet sich im t-Ordner deines Spielverzeichnisses.
Für X3: Terran Conflict findet sich dieser standardmäßig unter
C:\Programme\Egosoft\X3 Terran Conflict\t oder
C:\Programme\Steam\steamapps\common\X3 Terran Conflict\t
Für X3: Albion Prelude findet sich dieser standardmäßig unter
C:\Programme\Steam\steamapps\common\X3 Terran Conflict\addon\t
Ändere die "Deinstallationsvariable" von 0 zu 1 und speichere die Datei. Anschließend starte/lade dein Spiel.
Das Script fragt dich nun, ob du das Customlog wirklich deinstallieren möchtest. Du wirst ebenfalls gefragt, ob du die Nachrichten des Customlogs in der angegebenen Logdatei sichern möchtest. Anschließend wird das Customlog deinstalliert und du erhälst eine Nachricht darüber.
Gehe nun zu deinem scripts.uninstall-Ordner in deinem X3TC-Spielverzeichnis oder dessen addon-Ordner (für X3AP) und doppelklicke auf die Datei "uninstall.X2I.customlog.bat". Dies wird alle Customlog-Dateien aus den Ordnern Documents, scripts und t entfernen. Lösche nun die uninstall.X2I.Customlog.bat und, vorausgesetzt es sind keine weiteren Dateien darin vorhanden, auch den scripts.uninstall-Order.
7. Danksagungen
- EGOSOFT für die X-Reihe und den Script Editor
SS_T für einen zuverlässigen Downloadort auf xdownloads