FrameGuard 0.2.0 — Changelog

FrameGuard 0.2.0 ist ein größeres Stabilitäts- und Diagnose-Update für Minecraft Forge 1.20.1.
Der Schwerpunkt dieser Version liegt auf besserer Modpack-Kompatibilität, sichererem Startverhalten und neuen Better-WorldGen-Diagnosefunktionen.

Neue Funktionen

Better WorldGen Diagnostics

FrameGuard 0.2.0 fügt neue Better-WorldGen-Diagnosen hinzu.

Diese Diagnosen helfen Serverbesitzern und Modpack-Entwicklern dabei, auffällige Lastspitzen durch Weltgenerierung, Chunk-Aktivität oder starke Server-/World-Last besser zu erkennen.

Die Diagnosen können unter anderem melden:

• hohe Chunk-Load-Aktivität

• hohe Chunk-Unload-Aktivität

• auffällige Chunk-Aktivität pro Sekunde

• hohe durchschnittliche Server-/World-Last

• betroffene Dimensionen bei Chunk-Aktivitäts-Spitzen

Diese Funktion ist reine Diagnose.
FrameGuard verändert dadurch keine Weltgenerierung, löscht keine Chunks, blockiert keine Strukturen und verändert keine Terrain-Generierung.

Neuer Better-WorldGen-Status-Befehl

Es wurde ein neuer Status-Befehl für Better WorldGen hinzugefügt:

/frameguard betterworldgen status

Damit können Serveradmins direkt prüfen, ob Better-WorldGen-Systeme und Diagnosen aktiv sind.

Optionale OP-Chat-Warnungen für Better WorldGen

Better-WorldGen-Warnungen können jetzt optional auch direkt an online befindliche OPs/Admins im Chat gesendet werden.

Standardmäßig bleibt diese Funktion deaktiviert, damit kein unnötiger Chat-Spam entsteht.

Neue Config-Option:

notify_ops_in_chat = false

Wenn aktiviert, erhalten OPs zusätzliche Warnungen bei auffälliger Chunk-Aktivität oder hoher Server-/World-Last.

Normale Spieler erhalten diese Diagnosemeldungen nicht.

Konfigurierbare Chunk-Aktivitäts-Warnschwelle

Die Warnschwelle für auffällige Chunk-Aktivität kann jetzt in der Server-Config angepasst werden.

Neue Config-Option:

chunk_activity_warning_per_second = 128

Höhere Werte reduzieren Warnungen in großen Modpacks.
Niedrigere Werte sind nützlich für Tests oder Modpack-Entwicklung.

Verbesserungen

Verbesserte Forge-1.20.1-Kompatibilität

FrameGuard 0.2.0 verbessert die Kompatibilität mit neueren Forge-1.20.1-Versionen, einschließlich Forge 47.4.x.

Ein Start-Crash aus älteren Versionen wurde behoben, der durch instabile Client-Mixin-Hooks entstehen konnte.

Betroffen war unter anderem der frühere Tab-Overlay-/Ping-Mixin.
Dieser konnte auf bestimmten Forge-Umgebungen dazu führen, dass Minecraft direkt beim Start abstürzt.

Stabileres Startverhalten

FrameGuard startet jetzt zuverlässiger in Forge-1.20.1-Umgebungen.

Besonders wichtig ist das für Modpacks, die neuere Forge-47.4.x-Versionen verwenden.

Bessere Client-/Server-Kompatibilität

FrameGuard 0.2.0 ist robuster, wenn die Mod nicht auf beiden Seiten installiert ist.

Serverseitige Funktionen bleiben weiterhin serverseitig.
Clients müssen FrameGuard nicht zwingend installieren, nur damit ein Server mit FrameGuard funktionieren kann.

Diese Änderung soll Modpacks und Server-Setups flexibler machen.

Verbesserte Server-Config

Die Server-Config wurde erweitert und sauberer strukturiert.

Neue Bereiche wurden für Better WorldGen ergänzt:

[better_worldgen]
[better_worldgen.diagnostics]
[better_worldgen.chunk_save_optimizer]
[better_worldgen.structure_spacing_guard]

Wichtig: Die neuen Better-WorldGen-Diagnosen sind aktiv nutzbar.
Einige weiterführende WorldGen-Bereiche sind bereits in der Config vorbereitet, aber standardmäßig deaktiviert.

Fehlerbehebungen

Forge-Startcrash durch PlayerTabOverlayMixin behoben

Ein Crash aus älteren FrameGuard-Versionen wurde behoben.

In bestimmten Forge-1.20.1-Setups konnte FrameGuard beim Start abstürzen, weil ein Client-Mixin für die Tab-Spielerliste nicht mehr korrekt auf die erwartete Minecraft-Methode zugreifen konnte.

Dieser Fehler ist in FrameGuard 0.2.0 behoben.

Weniger Risiko durch instabile Client-Hooks

Instabile Client-Hooks aus älteren Versionen wurden entfernt oder deaktiviert, um Startprobleme und Forge-Kompatibilitätsprobleme zu vermeiden.

Dadurch ist FrameGuard 0.2.0 besser für öffentliche Modpacks und Serverumgebungen geeignet.

Hinweise zum Update

Beim Update von FrameGuard 0.1.5 auf 0.2.0 wird empfohlen, die alte Server-Config einmal zu sichern und anschließend neu generieren zu lassen.

Empfohlenes Vorgehen:

1. Alte Config sichern

2. Alte frameguard-server.toml löschen

3. Server oder Client einmal neu starten

4. Neue Config prüfen und gewünschte Werte wieder anpassen

So werden die neuen Better-WorldGen-Optionen korrekt erzeugt.

Zusammenfassung

FrameGuard 0.2.0 bringt:

• neue Better-WorldGen-Diagnosen

• Chunk-Aktivitäts-Warnungen

• Diagnosemeldungen für hohe Server-/World-Last

• optionale OP-Chat-Warnungen

• neue Better-WorldGen-Config-Werte

• neuen Better-WorldGen-Status-Befehl

• bessere Forge-47.4.x-Kompatibilität

• behobenen Startcrash durch frühere Client-Mixins

• stabileres Verhalten in Modpacks und Serverumgebungen

Dieses Update wird besonders für Modpack-Entwickler und Serverbetreiber empfohlen, die FrameGuard mit Minecraft Forge 1.20.1 verwenden.