Modliste: melden was sich geaendert hat, einzeln laden

Bisher gab es fuer Mods nur einen Link auf das Sammelpaket des Hosters — vier
Gigabyte, auch wenn sich zwei Dateien geaendert haben. Jetzt liest der Bot die
Modliste aus der Statusabfrage, die er ohnehin holt, und meldet im Kanal, was
neu, aktualisiert oder entfernt wurde. Beim ersten Durchlauf bleibt es still,
sonst kaeme eine Meldung ueber 110 "neue" Mods.

Geaendert heisst: andere Version oder anderer Hash. Beides einzeln reicht
nicht — manche Modder bessern nach, ohne die Version zu erhoehen.

Dazu die Seite /mods/<server>: jeder Mod mit Version und Groesse, Suche ueber
Titel, Dateiname und Autor, und ein Download je Zeile. Der laeuft durch den
Bot, damit der Zugangs-Code des Spielservers nicht in einem Link landet — mit
dem Code liesse sich auch der ganze Spielstand lesen. Angefragt wird nur, was
wirklich in der Modliste steht; ueber den Dateinamen kommt man an nichts
anderes heran.

Groessen lernt der Bot beim Weiterleiten. Der Spielserver beantwortet kein
HEAD (501) und ignoriert Range, es gibt also keinen billigen Weg, sie vorher
zu erfahren — und 4 GB nur fuers Anzeigen zu holen waere keiner.

Nebenbei gefunden und behoben: 'server.mods' und 'commands.tag' gab es je
zweimal in den Sprachdateien. Der spaetere Eintrag gewinnt still, deshalb
stand auf dem neuen Knopf woertlich "%s Mods (110)" und auf der Befehlsseite
die Beschreibung von /tag statt der Kopfzeile.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/bot/ls-farm.js

@@ -12,10 +12,10 @@
 import { AttachmentBuilder, Events } from 'discord.js';
 import sharp from 'sharp';
 import { brandEmbed } from '../embeds.js';
-import { brandFooter } from '../runtime-settings.js';
+import { brandFooter, hubUrl } from '../runtime-settings.js';
 import { moduleEnabled } from '../modules.js';
 import { tuning, tuningMs, everyTuned } from '../tuning.js';
-import { getSetting, setSetting, listGameservers, lsState, setLsMessage, setLsTageszeit, setLsHofMessages } from '../db.js';
+import { getSetting, setSetting, listGameservers, lsState, setLsMessage, setLsTageszeit, setLsHofMessages, setLsMods } from '../db.js';
 
 /** Alle Attribute eines XML-Tags als Objekt */
 const attrsVon = (roh) =>
@@ -111,6 +111,131 @@ export function hofUebersicht(parzellen) {
     };
 }
 
+// ── Mods ──────────────────────────────────────────────────────────────────
+
+/**
+ * Die Modliste aus der Statusabfrage.
+ *
+ * Steht ganz oben im XML, noch vor den Parzellen. Je Mod gibt es `name`
+ * (= Dateiname ohne .zip), `author`, `version` und `hash` — GIANTS' eigenen
+ * Fingerabdruck. Was der genau ist, weiss ich nicht: gemessen ist er weder
+ * die MD5 der ausgelieferten Zip noch die der modDesc.xml. Für den Abgleich
+ * reicht, dass er sich mit dem Mod ändert.
+ */
+export function modsLesen(xml) {
+    const block = String(xml ?? '').match(/<Mods>([\s\S]*?)<\/Mods>/);
+    if (!block) return [];
+    return [...block[1].matchAll(/<Mod ([^>]*)>([^<]*)<\/Mod>/g)].map(([, kopf, titel]) => {
+        const a = attrsVon(kopf);
+        return {
+            name: a.name ?? '',
+            titel: entschaerft(titel.trim()) || a.name || '?',
+            autor: entschaerft(a.author ?? ''),
+            version: a.version ?? '',
+            hash: a.hash ?? '',
+        };
+    }).filter((m) => m.name);
+}
+
+/** &amp;#93; und Konsorten aus dem Feed zurückübersetzen */
+function entschaerft(text) {
+    return String(text)
+        .replaceAll('&amp;', '&')
+        .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(Number(n)))
+        .replaceAll('&lt;', '<').replaceAll('&gt;', '>').replaceAll('&quot;', '"');
+}
+
+/**
+ * Was hat sich an der Modliste geändert?
+ *
+ * Beim ersten Durchlauf gibt es nichts zu melden — sonst käme beim Botstart
+ * eine Meldung über 110 „neue" Mods.
+ *
+ * Geändert heisst: andere Version **oder** anderer Hash. Der Hash allein
+ * reicht nicht, weil manche Modder nachbessern, ohne die Version zu erhöhen —
+ * und die Version allein reicht auch nicht, aus demselben Grund.
+ */
+export function modsDiff(vorher, jetzt) {
+    if (!Array.isArray(vorher) || vorher.length === 0) return null;
+    const alt = new Map(vorher.map((m) => [m.name, m]));
+    const neu = new Map(jetzt.map((m) => [m.name, m]));
+    const geaendert = [];
+    for (const m of jetzt) {
+        const v = alt.get(m.name);
+        if (v && (v.version !== m.version || v.hash !== m.hash)) {
+            geaendert.push({ ...m, vorher: v.version });
+        }
+    }
+    const diff = {
+        neu: jetzt.filter((m) => !alt.has(m.name)),
+        geaendert,
+        entfernt: vorher.filter((m) => !neu.has(m.name)),
+    };
+    return diff.neu.length + diff.geaendert.length + diff.entfernt.length > 0 ? diff : null;
+}
+
+/** Eine Zeile je Mod, aber nie mehr als in ein Discord-Feld passt */
+function modZeilen(mods, zeile, grenze = 1000) {
+    const alle = mods.map(zeile);
+    const raus = [];
+    let laenge = 0;
+    for (const z of alle) {
+        // Der Hinweis auf den Rest muss selbst noch hineinpassen
+        if (laenge + z.length + 1 > grenze - 30) {
+            raus.push(`… und ${alle.length - raus.length} weitere`);
+            break;
+        }
+        raus.push(z);
+        laenge += z.length + 1;
+    }
+    return raus.join('\n');
+}
+
+/**
+ * Was sich an den Mods getan hat — als Meldung im Kanal.
+ *
+ * Bewusst nur die Änderung und nicht die ganze Liste: wer alle 110 sehen
+ * will, geht auf die Seite. Hier steht, was man nachladen muss.
+ */
+export function modsEmbed(client, diff, server) {
+    const seite = `${hubUrl()}/mods/${server.id}`;
+    const teile = [];
+    if (diff.neu.length) teile.push(`${diff.neu.length} neu`);
+    if (diff.geaendert.length) teile.push(`${diff.geaendert.length} aktualisiert`);
+    if (diff.entfernt.length) teile.push(`${diff.entfernt.length} entfernt`);
+
+    const embed = brandEmbed(client, 'MOD')
+        .setTitle('🧩 Modliste geändert')
+        .setURL(seite)
+        .setDescription(`**${server.name}** — ${teile.join(', ')}.\nAlle Mods und Downloads: [auf der Seite](${seite})`)
+        .setFooter({ text: brandFooter('MOD') })
+        .setTimestamp();
+
+    if (diff.geaendert.length) {
+        embed.addFields({
+            name: `⬆️ Aktualisiert (${diff.geaendert.length})`,
+            // Gleiche Version, anderer Hash: der Modder hat nachgebessert,
+            // ohne die Version zu erhöhen. „1.3.0.0 → 1.3.0.0" wäre Unsinn.
+            value: modZeilen(diff.geaendert, (m) => (m.vorher === m.version
+                ? `**${m.titel}** ${m.version} · neu gepackt`
+                : `**${m.titel}** ${m.vorher} → ${m.version}`)),
+        });
+    }
+    if (diff.neu.length) {
+        embed.addFields({
+            name: `➕ Neu (${diff.neu.length})`,
+            value: modZeilen(diff.neu, (m) => `**${m.titel}** ${m.version}`),
+        });
+    }
+    if (diff.entfernt.length) {
+        embed.addFields({
+            name: `➖ Entfernt (${diff.entfernt.length})`,
+            value: modZeilen(diff.entfernt, (m) => `~~${m.titel}~~`),
+        });
+    }
+    return embed;
+}
+
 // ── Fuhrpark ──────────────────────────────────────────────────────────────
 
 /**
@@ -621,6 +746,17 @@ export function feedBasis(server) {
     return `http://${server.host}:${port}/feed`;
 }
 
+/**
+ * Wo die Mod-Dateien liegen.
+ *
+ * Nicht unter `/feed` — die Zips hängen eine Ebene höher direkt am Webserver
+ * des Spiels: `http://host:port/mods/<name>.zip?code=…`. Deshalb wird das
+ * `/feed` vom Ende abgeschnitten statt eine zweite Einstellung zu bauen.
+ */
+export function modBasis(server) {
+    return feedBasis(server).replace(/\/feed\/?$/i, '');
+}
+
 /**
  * Ist das ein LS-Server, den wir abfragen können?
  *
@@ -651,6 +787,7 @@ export async function lsAbfragen(server, { timeoutMs = 15000, kartenBreite = 102
     const code = encodeURIComponent(server.token);
     const stats = await holen(`${basis}/dedicated-server-stats.xml?code=${code}`, timeoutMs);
     const stand = statsLesen(stats);
+    const mods = modsLesen(stats);
 
     // Karte, Preise und Fuhrpark sind Beiwerk: fehlt eins, bleibt der Rest
     // brauchbar. Deshalb einzeln abgefangen statt einmal um alles herum.
@@ -665,7 +802,7 @@ export async function lsAbfragen(server, { timeoutMs = 15000, kartenBreite = 102
         holen(`${basis}/dedicated-server-savegame.html?file=vehicles&code=${code}`, timeoutMs)
             .then(fahrzeugeLesen).catch(() => null),
     ]);
-    return { stand, bild, preise, fahrzeuge };
+    return { stand, mods, bild, preise, fahrzeuge };
 }
 
 
@@ -706,7 +843,7 @@ export async function lsTick(client) {
 
     for (const s of server) {
         try {
-            const { stand, bild, preise, fahrzeuge } = await lsAbfragen(s, {
+            const { stand, mods, bild, preise, fahrzeuge } = await lsAbfragen(s, {
                 timeoutMs: tuningMs.seconds('monitor_timeout'),
                 kartenBreite: breite,
             });
@@ -726,8 +863,16 @@ export async function lsTick(client) {
             // bekannt", und der echte Mitternachtssprung geht verloren.
             if (stand.tageszeit != null) setLsTageszeit(s.id, stand.tageszeit);
 
+            // Modliste: erst vergleichen, dann merken. Die Meldung ist die
+            // einzige, die noch von sich aus schreibt — sie kommt selten und
+            // sagt etwas, das man wissen muss, bevor man verbindet.
+            const modWechsel = mods.length > 0 ? modsDiff(alt?.mods, mods) : null;
+            if (mods.length > 0) setLsMods(s.id, mods);
+
             if (!kanal?.isTextBased()) continue;
 
+            if (modWechsel) await kanal.send({ embeds: [modsEmbed(client, modWechsel, s)] });
+
             // 1) Karte und Preise
             const payload = await hofNachricht(client, stand, bild, namen, breite);
             if (preise.length > 0) {