1.0.0.0 FS-Log Assistant

FS-Log Assistant is a Discord bot designed to analyze log files, automatically detect errors or issues, and provide instant solutions based on a database.

FS-Log Assistant

Modbeschreibung DE

FS-Log Assistant

Der FS-Log Assistant ist ein Discord-Bot, der deine Log-Dateien aus dem Landwirtschafts-Simulator ausliest, automatisch Fehler
und Warnungen erkennt und dir erklärt, was diese bedeuten und wie du sie beheben kannst – basierend auf einer stetig wachsenden
Datenbank mit Lösungsvorschlägen.

FUNKTIONSWEISE
Lade deine `log.txt` hoch, und der Bot antwortet mit einer übersichtlichen Liste der gefundenen Probleme. Zu jedem Eintrag erhältst du Informationen über:
- die Art des Problems
- eine Schritt-für-Schritt-Anleitung zur Behebung
- die genaue Stelle in der Log-Datei (Zeilennummer und den betroffenen Inhalt)
- den betroffenen Mod (sofern dieser in der Log-Datei genannt wird)

Harmlose Meldungen werden von echten Problemen getrennt, sodass du auf einen Blick siehst, was wirklich wichtig ist.
Meldungen, für die noch keine Lösung bekannt ist, werden anonym gesammelt, damit sie in Zukunft analysiert und erklärt werden können.

ANWENDUNG
- Lade deine `log.txt` (oder eine beliebige `.txt`- bzw. `.log`-Datei) in einen dafür vorgesehenen Kanal hoch – der Bot antwortet direkt dort.
- Alternativ kannst du die Datei auch per Direktnachricht an den Bot senden.
- Oder nutze den Befehl `/log` und hänge die Datei an – die Antwort ist dann nur für dich sichtbar.
- Bei umfangreichen Ergebnissen kannst du dir die Antwort mit nur einem Klick per Direktnachricht zusenden lassen.

XML- & MOD-ÜBERPRÜFUNG
Der Bot untersucht zudem XML-Dateien sowie Mod-ZIP-Archive auf grundlegende Fehler. Er gibt dabei die genaue Stelle an und liefert einen Lösungsvorschlag:
- Syntaxfehler (nicht geschlossene Tags, überflüssige Sonderzeichen wie `&`, fehlende Anführungszeichen, falsche Zeichenkodierung)
- Probleme in der `modDesc.xml` (z. B. `descVersion`, Version, Titel, Icon, `l10n`)
- Sprachdateien (doppelte oder leere Texteinträge)
- Dateipfade (falsche Schrägstriche, absolute Pfadangaben)
- Mod-ZIP-Archive: ungültige Dateinamen, eine zu tief im Verzeichnis liegende `modDesc.xml` sowie die Überprüfung aller darin enthaltenen XML-Dateien

Nutze hierfür den Befehl `/xml` oder lade die entsprechenden Dateien einfach in einen dafür vorgesehenen Kanal hoch. EINRICHTUNG AUF DEINEM SERVER
Server-Administratoren können den Bot über den Befehl `/logsetup` einrichten:
- `addchannel` / `removechannel` – lege fest, in welchen Kanälen Logs hochgeladen werden dürfen.
- `language` – wähle die Sprache (Deutsch oder Englisch) für deinen Server.
- `deletemessage` – optional: das hochgeladene Log nach der Analyse automatisch löschen.
- `status` – zeige die aktuellen Einstellungen an.

Nach der Einrichtung postet der Bot ein Panel mit Anweisungen im Kanal; dieses wird nach jeder Analyse automatisch wieder ganz unten im Chat angezeigt.
Nutzer können ihre bevorzugte Sprache individuell mit `/loglanguage` anpassen.

DATENSCHUTZ
Logs werden vor der Speicherung bereinigt: Dateipfade, dein Windows-Benutzername, Hardware-Details sowie Zeitstempel werden entfernt.
Nur der bereinigte Bericht wird gespeichert – dies hilft dabei, häufig auftretende Fehler zu erkennen und die Lösungsansätze zu verbessern.
Hochgeladene XML-Dateien und ZIP-Archive werden lediglich überprüft, aber nicht dauerhaft gespeichert.

BETA
Das System befindet sich aktuell noch in der Beta-Phase. Sollte etwas nicht wie erwartet funktionieren, gib bitte SimuTools Bescheid.

Bereitgestellt von SimuTools.

FS Log Assistant is a Discord bot that reads your Farming Simulator log files, finds errors and warnings automatically, and tells you what they mean and how to fix them – based on a constantly growing solutions database.

WHAT IT DOES
Upload your log.txt and the bot sends back a clear list of problems. Every entry explains:
- what the problem is
- how to fix it, step by step
- where it appears in your log (line number and the affected log line)
- which mod is affected, when the log names one

Harmless messages are separated from real problems, so you can see at a glance what actually matters. Messages without a known solution are collected anonymously, so they can be explained soon.

HOW TO USE IT
- Drop your log.txt (or any .txt / .log file) into an upload channel – the bot replies right there.
- Or send the file to the bot in a direct message.
- Or use /log with the file as an attachment – only you can see the answer.
- Long results can be sent to you by direct message with one click.

XML & MOD CHECK
The bot also checks XML files and mod ZIPs for basic errors, including the exact line and a solution:
- syntax errors (unclosed tags, a stray "&", missing quotes, wrong encoding)
- modDesc.xml problems (descVersion, version, title, icon, l10n)
- language files (duplicate or empty texts)
- file paths (backslashes, absolute paths)
- mod ZIPs: invalid file name, modDesc.xml one folder too deep, and all XML files inside

Use /xml or just upload the files in an upload channel.

SET UP ON YOUR SERVER
Server managers set the bot up with /logsetup:
- addchannel / removechannel – choose the upload channels
- language – German or English for your server
- deletemessage – optionally delete the uploaded log after the analysis
- status – show your settings

After setup the bot posts a panel with instructions in the channel and keeps it at the bottom after every analysis. Users can change their own language with /loglanguage.

PRIVACY
Logs are cleaned before anything is stored: paths, your Windows user name, hardware details and timestamps are removed. Only the cleaned report is kept, to recognize frequent errors and improve the solutions. Uploaded XML files and ZIPs are checked and not stored.

BETA
The system is still in beta. If something is not correct, please let SimuTools know.

Provided by SimuTools.