Lythtlorn
NWN2-Log-Explorer
Such- und Archivierungswerkzeug für Rollenspiel-Chatlogs
Inhaltsverzeichnis
- Übersicht
- Erste Schritte
- Die Benutzeroberfläche
- Suche
- Verfeinerung und Verlauf
- Ergebnisanzeige
- Export
- Charakterliste
- Archiv-Ansicht
- Dialog-Spam-Filter
- Log-Vollansicht
- Konfiguration
- Häufige Fragen
Übersicht
Der NWN2 Log Explorer ist ein Such- und Archivierungswerkzeug für die Chatlog-Dateien des Lythtlorn Persistent World Servers. Er ermöglicht es, Rollenspiel-Inhalte gezielt zu durchsuchen, zu filtern und als bereinigte Kopien zu exportieren - ohne die Originaldateien jemals zu verändern.
Unterstützte Dateiformate:
- <Name> (Chatlog) YYYY-MM-DD.log - Chatlog-Originale
- <Name> (Chatlog) YYYY-MM-DD.txt - Exportierte Bearbeitungen
- <Name> (Chatlog) YYYY-MM-DD Beschreiber.log - Logs mit Namenszusatz nach dem Datum
- <Name> (Chatlog) YYYY-MM-DD (1).log - Nummerierte Duplikate
Erste Schritte
Programmstart
Starte die "NWN2 Log Explorer.exe" per Doppelklick. Beim ersten Start öffnet sich automatisch ein Ordner-Dialog. Wähle deinen Log-Ordner aus - üblicherweise:
C:\Users\<Dein Name>\Documents\Neverwinter Nights 2\Logs
Der Ordner wird gespeichert und beim nächsten Start automatisch geladen.
Ordnerstruktur
Der Log-Explorer erwartet folgende Struktur im gewählten Ordner:
Logs\
Max Minnesänger\
Max Minnesänger (Chatlog) 2024-04-19.log
Max Minnesänger (Combatlog) 2024-04-19.log
...
Siegbert Störenfried\
...
Jeder Charakter hat einen eigenen Unterordner mit seinem Namen.
Die Benutzeroberfläche
Das Fenster ist in zwei Bereiche geteilt:
Linke Spalte - Steuerung
Von oben nach unten:
- Pfad-Leiste - Zeigt den aktiven Log-Ordner. Buttons zum Wechseln.
- ORDNER - Liste aller Charakterordner. Mehrfachauswahl möglich (Klick zum Markieren/Demarkieren). Kein Haken = alle Ordner werden durchsucht.
- SUCHE - Suchbegriff-Eingabe + Modus-Auswahl + Suchen-Button.
- VERLAUF / VERFEINERN - Verlaufsbuttons und Verfeinern-Eingabe.
- Exportieren - Exportiert gefundene Logs.
- Charakterliste - Erstellt eine Übersicht aller Spieler und Charaktere.
- 🔇 Spam - Schaltet den Dialog-Spam-Filter ein oder aus.
Rechte Seite - Ergebnisse
- Hauptbereich - Zeigt gefundene Treffer mit Kontext.
- Dateiliste unten - Alle Dateien mit Treffern. Doppelklick öffnet den vollständigen Log. Einfacher Klick markiert Dateien für selektiven Export.
Suche
Suchbegriff eingeben
Tippe deinen Suchbegriff in das obere Eingabefeld. Bestätige mit Enter oder klicke 🔍 Suchen.
Suchmodi
Wähle vor der Suche den Modus:
| Modus | Sucht in |
|---|---|
| Charakter | Dem Namen des sprechenden Charakters |
| Text | Dem Inhalt der Nachricht |
| Alles | Beidem gleichzeitig |
Ordnerauswahl
Standardmäßig werden alle Charakterordner durchsucht. Klicke einzelne Ordner in der Liste an, um nur diese zu durchsuchen. Ein weiterer Klick hebt die Auswahl wieder auf.
Ergebnisanzeige
Nach der Suche erscheinen:
- Die Trefferzahl und Dateienanzahl als Statusmeldung
- Die Treffer im Hauptbereich mit Kontext (2 Sprecherwechsel vor und nach jeder Fundstelle)
- Die betroffenen Dateien in der Liste unten
Jeder sprechende Charakter bekommt automatisch eine eigene Farbe, die über die gesamte Sitzung konsistent bleibt.
Verfeinerung und Verlauf
Ergebnisse verfeinern
Nach einer erfolgreichen Suche wird das Verfeinern-Feld aktiviert. Gib dort einen zweiten Begriff ein, um nur noch innerhalb der bereits gefundenen Dateien zu suchen.
Der Verfeinern-Modus hat eine eigene Modus-Auswahl (Standard: Alles), unabhängig vom Suchmodus der Initialsuche.
Verlaufsbuttons
Jede erfolgreiche Suche schreibt sich sofort als Button in den Verlauf:
[Schmied (47/12)] <- 47 Treffer in 12 Dateien [Schwert (20/5)] <- Verfeinerung: 20 Treffer in 5 Dateien [Verfeinern...] <- bereit für nächsten Schritt
Ein Klick auf einen Verlaufsbutton springt direkt auf diese Stufe zurück. Alle neueren Verfeinerungen werden dabei entfernt.
Suche zurücksetzen
Das X-Symbol neben dem Suchfeld setzt alles zurück.
Ergebnisanzeige
Treffermarkierung
Treffer werden mit ▶ in goldener Farbe markiert. Kontext-Zeilen (die umgebenden Sprechwechsel) erscheinen abgedunkelt.
Übersetzungen
Spricht ein Charakter in einer Fremdsprache (z.B. Elfisch), sucht das Programm automatisch im passenden Combatlog nach Übersetzungen mit gleichem Zeitstempel und Charakternamen. Gefundene Übersetzungen erscheinen direkt unter der Originalzeile:
▶ [00:22] Mirafin [Talk] Lailvan, Fmywam, amea vyan nöllan eirm sean was Lanyiramaman ysvairal? -> Elven: Sagt, Bruder, wie gut könnt ihr mit dem Schwert umgehen?
Dialog-Spam
Dialog-Einträge aus NWN2-Menüs (Item-Tools, Kleidungsanpassung usw.) werden automatisch erkannt und rot markiert. Mit dem 🔇 Spam-Button kannst du zwischen Anzeigen und Ausblenden wechseln:
- AN - Spam wird ausgeblendet, ein Platzhalter zeigt die Anzahl der übersprungenen Zeilen
- AUS - Spam wird rot markiert angezeigt
Export
Grundfunktion
Klicke auf 💾 Exportieren. Es öffnet sich ein Dialog für einen optionalen Beschreiber (Namenszusatz für die Exportdateien):
Max Minnesänger (Chatlog) 2024-04-19.log -> Max Minnesänger (Chatlog) 2024-04-19 Kampf.txt -> Max Minnesänger (Chatlog) 2024-04-19 Kampf.html
Ohne Beschreiber bleibt der Dateiname unverändert (nur Endung .txt/.html).
Selektiver Export
Markiere einzelne Dateien in der Dateiliste unten (einfacher Klick zum Markieren/Demarkieren), um nur diese zu exportieren. Ohne Markierung werden alle Dateien mit Treffern exportiert.
Nach einem Export bleibt die Suche aktiv - du kannst sofort einen weiteren Export mit anderem Beschreiber starten.
Exportort
Alle Exporte landen im Unterordner `_Bearbeitete_Logs` innerhalb des aktiven Log-Ordners:
Logs\
_Bearbeitete_Logs\
Max Minnesänger - bearbeitet\
Max Minnesänger (Chatlog) 2024-04-19 Kampf.txt
Max Minnesänger (Chatlog) 2024-04-19 Kampf.html
Spam im Export
Ist der Spam-Filter aktiv, werden erkannte Dialog-Spam-Zeilen aus den exportierten Dateien vollständig entfernt. Die HTML-Datei enthält in diesem Fall einen roten Hinweis mit der Anzahl der entfernten Zeilen.
Exportformate
- .txt - Reiner Text, alle Farbcodes entfernt
- .html - Farbige Darstellung mit charakterspezifischen Farben, optimiert für den Browser (dunkles Theme)
Charakterliste
Klicke auf 📋 Charakterliste, um alle Spieler-Accounts und ihre gespielten Charaktere aus allen Logs zu extrahieren. Das Ergebnis wird in einem eigenen Fenster angezeigt.
Über den Export-Button im Fenster werden CSV- und HTML-Dateien nach `_Bearbeitete_Logs\Charakterliste\` gespeichert.
Archiv-Ansicht
Die Archiv-Ansicht fasst alle bisher exportierten Logs aus allen bekannten Log-Ordnern in einer übersichtlichen Oberfläche zusammen - ohne Browser, direkt im Programm.
Öffnen
Klicke auf 📖 Archiv-Ansicht in der linken Spalte.
Archiv erstellen
Beim ersten Öffnen ist das Archiv leer. Klicke auf 🔄 Archiv erstellen. Das Programm durchsucht automatisch alle bekannten Log-Pfade nach `_Bearbeitete_Logs`-Unterordnern und liest alle enthaltenen ".txt"-Dateien ein.
Navigation
Im linken Bereich erscheint ein Baum mit allen Charakteren (eingeklappt). Klappe einen Charakter auf, um seine exportierten Logs zu sehen. Ein Klick auf einen Log-Eintrag zeigt den Inhalt rechts an - direkt im Programm, inklusive Spam-Unterdrückung und Charakterfarben.
Suche im Archiv
Das Suchfeld filtert den Baum nach Eingabe:
- Gefunden wird im Charakternamen und im Log-Bezeichner (Datum + Beschreiber)
- Charakter-Knoten bleiben sichtbar, solange mindestens ein Kind passt
Die Suche unterstützt den vollen Verlauf mit Verfeinerung wie die Hauptsuche:
- Jede Suche schreibt sich als Verlaufsbutton mit Trefferanzahl
- Das Verfeinern-Feld wird nach der ersten Suche aktiviert
- Klick auf einen Verlaufsbutton stellt diese Stufe wieder her
- X setzt die Suche zurück und zeigt das vollständige Archiv
Hinweis
Das Archiv muss nach neuen Exporten über 🔄 Archiv erstellen aktualisiert werden. Es liest immer den aktuellen Stand aller `_Bearbeitete_Logs`-Ordner.
Dialog-Spam-Filter
Was wird gefiltert?
Der Filter arbeitet ausschließlich auf dem [Dialog]-Kanal und prüft jeden Eintrag gegen eine Blacklist bekannter Menü-Texte (Item-Tools, Kleidungsanpassung, Navigation usw.).
Eigene Einträge hinzufügen
In der `nwn2explorer_config.json` können eigene Spam-Einträge ergänzt werden:
{
"spam_blacklist_extra": [
"mein eigener eintrag",
"noch ein menüpunkt"
]
}
Einträge sind nicht case-sensitiv.
Log-Vollansicht
Doppelklick auf eine Datei in der Dateiliste öffnet den vollständigen, bereinigten Log in einem eigenen Fenster. Farbcodes werden entfernt, Charakterfarben bleiben erhalten.
Der Spam-Filter gilt auch hier und ist mit einem eigenen 🔇 Spam-Button unabhängig von der Hauptansicht steuerbar.
Per Strg+W oder dem X-Button wird das Fenster geschlossen.
Konfiguration
Die `nwn2explorer_config.json` liegt neben der .exe und wird automatisch verwaltet. Manuell editierbar mit einem Texteditor:
{
"recent_paths": [
"C:\\Users\\Name\\Documents\\Neverwinter Nights 2\\Logs",
"C:\\Users\\Name\\Documents\\Neverwinter Nights 2\\Logs\\alt"
],
"spam_blacklist_extra": []
}
Häufige Fragen
Meine Logs werden nicht gefunden. Prüfe ob der Ordner Unterordner mit Charakternamen enthält und ob die Dateien das Format `Name (Chatlog) YYYY-MM-DD.log` haben.
Die Übersetzungen (Elfisch usw.) werden nicht angezeigt. Das Programm sucht nach einer passenden Combatlog-Datei im selben Ordner. Stelle sicher, dass Combatlog-Dateien vorhanden sind.
Der Spam-Filter entfernt Zeilen, die kein Spam sind. Schalte den Filter mit 🔇 aus. Wenn spezifische Texte fälschlicherweise gefiltert werden, melde das auf Discord.
Exportierte HTML-Dateien sehen nicht korrekt aus. Öffne sie in einem modernen Browser (Firefox, Chrome, Edge). Der Doppelklick öffnet automatisch den Standardbrowser.