Skip to content

Home

Jump to bottom
Nachtvisionar edited this page May 23, 2026 · 8 revisions

FrameGuard Wiki

Überblick

FrameGuard ist eine Performance-, Diagnose- und Server-Utility-Mod für Minecraft.

Die Mod bietet ein Ingame-Performance-HUD, Diagnosewerte, Log-Export-Funktionen, Crash-Export-Unterstützung und serverseitige Performance-Guards gegen typische Lag-Quellen wie TNT-Ketten, Entity-Spam, zu viele XP-Orbs und zu viele herumliegende Item-Entities.

Ab Version 0.1.5 wurde FrameGuard deutlich erweitert. Neben dem normalen HUD gibt es jetzt mehrere HUD-Modi, einen Debug-Modus mit Ressourcenwerten, verbessertes XP-Orb-Merging, erweitertes Item-Merging am Boden, Item-Cleanup mit Chat-Warnung und einen überarbeiteten FPS-Limiter, der die sichtbare Minecraft-FPS-Einstellung nicht mehr überschreibt.

FrameGuard wird aktuell alleine entwickelt. Deshalb können Fehler, Bugs oder unerwartete Probleme in einzelnen Versionen auftreten. Wenn dir ein Fehler auffällt, melde ihn bitte als Kommentar auf CurseForge oder über den Discord-Server.

Unterstützte Versionen

Version Minecraft-Version Modloader Java-Version Mod-Version Status
FrameGuard 0.1.5 (Forge) 1.20.1 Forge Java 17 0.1.5 Verfügbar / aktueller Hauptstand
FrameGuard 0.1.0 (NeoForge) 1.21.1 NeoForge Java 21 0.1.0 Separater Port / älterer Stand

Wichtig: Die neuen Funktionen aus Version 0.1.5 beziehen sich zuerst auf die Forge-Version. Der NeoForge-Port wird separat gepflegt und kann je nach Veröffentlichungsstand noch nicht alle neuen Funktionen enthalten.

Wichtiger Hinweis beim Update auf 0.1.5

Vor dem Update auf FrameGuard 0.1.5 wird empfohlen, die alten FrameGuard-Config-Dateien zu sichern und anschließend zu löschen.

Grund: In Version 0.1.5 wurden viele neue Config-Optionen hinzugefügt und Teile der Config erweitert. Je nach vorheriger Version kann es vorkommen, dass alte Config-Dateien nicht automatisch entfernt werden. Dadurch können mehrere FrameGuard-Config-Dateien gleichzeitig entstehen, was zu Verwirrung oder falschen Einstellungen führen kann.

Empfohlene Schritte:

  1. Alte FrameGuard-Configs sichern, falls du deine bisherigen Einstellungen behalten möchtest.
  2. Alte FrameGuard-Config-Dateien löschen.
  3. Spiel oder Server einmal starten, damit neue Config-Dateien erstellt werden.
  4. Eigene Einstellungen bei Bedarf neu eintragen.

Hauptordner der neuen Configs:

config/frameguard/

Mögliche alte oder vorhandene Config-Dateien:

config/frameguard-client.toml
config/frameguard-server.toml
config/frameguard-common.toml
config/frameguard/frameguard-client.toml
config/frameguard/frameguard-server.toml

Installation

Client-Installation

Lege die FrameGuard-JAR in den Mods-Ordner deines Minecraft-Clients.

Typischer Pfad:

.minecraft/mods

Auf dem Client bietet FrameGuard unter anderem:

  • Performance-HUD
  • HUD-Modi
  • Debug-HUD
  • FPS-/Frametime-Anzeige
  • Ping-Anzeige
  • FPS-Control für Menü und Hintergrund
  • Ingame-Config-Screen
  • Log-Export
  • Crash-Export
  • Client Entity Render Guard

Server-Installation

Lege dieselbe FrameGuard-JAR in den Mods-Ordner deines Servers.

Typischer Pfad:

server/mods

Für Server-Funktionen muss FrameGuard auf dem Server installiert sein.

Dazu gehören unter anderem:

  • TPS-Sync
  • Server-Status im HUD
  • Server-Performance-Profile
  • Entity Cramming Guard
  • TNT Guard
  • TNT Activation Queue
  • XP-Orb-Merging
  • Ground Item Merging
  • Item-Cleanup mit Warnung
  • Item-Ban-System

Für vollständige Funktionalität sollte FrameGuard auf Client und Server installiert sein.

Config-Dateien

FrameGuard nutzt getrennte Config-Dateien für Client und Server.

Client-Config

Pfad:

config/frameguard/frameguard-client.toml

Die Client-Config enthält Einstellungen für:

  • HUD
  • HUD-Position
  • HUD-Sichtbarkeit
  • HUD-Modi
  • Debug-HUD
  • RAM-/CPU-/GPU-Anzeige
  • FPS-Control
  • Client Entity Render Guard
  • Ping-/TPS-Farben
  • Log-Export
  • Crash-Export
  • Ingame-Config-Screen

Viele Client-Werte können direkt im Ingame-Config-Screen geändert werden.

Client-Config-Änderungen sollen ingame übernommen werden, ohne dass das Spiel, die Welt oder die Serververbindung neu gestartet werden muss.

Server-Config

Pfad:

config/frameguard/frameguard-server.toml

Die Server-Config enthält Einstellungen für:

  • Server-Funktionen
  • TPS-Sync
  • Permission-Level
  • Performance-Profile
  • Entity Cramming Guard
  • XP-Orb-Merging
  • Ground Item Merging
  • Item-Cleanup
  • TNT Guard
  • TNT Activation Queue
  • Item-Ban-System

Die Server-Config wird bewusst nicht im Ingame-Config-Screen angezeigt. Server-Einstellungen sollen direkt über die Datei geändert werden.

Nach Änderungen an der Server-Config sollte der Server neu gestartet werden, damit alle Werte sicher übernommen werden.

Ingame-Config-Screen

FrameGuard besitzt einen Ingame-Config-Screen im Minecraft-Mods-Menü.

Der Ingame-Config-Screen zeigt nur Client-Einstellungen an. Server-Einstellungen werden dort nicht angezeigt.

Im Ingame-Config-Screen können unter anderem folgende Werte geändert werden:

  • HUD an/aus
  • HUD-Position
  • HUD-Zeilenabstand
  • HUD-Schatten
  • sichtbare HUD-Zeilen
  • FPS-Control
  • Client Entity Render Guard
  • Debug-HUD
  • RAM-/CPU-/GPU-Anzeige
  • Ressourcen-Warnwerte
  • Ressourcen-Fallbacks
  • Warnwerte für FPS, Frametime, Ping und TPS
  • Log-Export-Einstellungen
  • Crash-Export-Einstellungen

Änderungen an Client-Werten werden direkt übernommen und benötigen keinen Neustart.

HUD

FrameGuard zeigt wichtige Performance-Werte direkt im Spiel an.

HUD-Modi ab 0.1.5

Ab Version 0.1.5 gibt es mehrere HUD-Modi.

Mit F10 wird zwischen den Modi gewechselt:

Normal -> Erweitert -> Debug -> Normal

F10 schaltet das HUD nicht aus. Das HUD selbst wird nur mit F9 ein- oder ausgeschaltet.

Normales HUD

Das normale HUD kann folgende Werte anzeigen:

  • FrameGuard-Titel
  • FPS
  • Frametime
  • Server-FrameGuard-Status
  • Ping

Der Serverstatus zeigt an, ob der verbundene Server ebenfalls FrameGuard geladen hat.

Wenn ein Wert nicht verfügbar ist, zeigt FrameGuard N/A an.

Erweitertes HUD

Das erweiterte HUD zeigt zusätzliche Diagnosewerte:

  • TPS
  • durchschnittliche Frametime
  • P99-Frametime
  • maximale Frametime
  • 1 Prozent Low FPS

Das erweiterte HUD ist hilfreich, um Stottern, kurze Performance-Einbrüche oder Serverprobleme besser zu erkennen.

Debug-HUD

Der Debug-Modus zeigt zusätzliche Ressourcenwerte.

Mögliche Werte:

  • RAM aktuell / Minimum / Maximum
  • CPU aktuell / Minimum / Maximum
  • GPU aktuell / Minimum / Maximum

RAM und CPU beziehen sich möglichst auf den Minecraft-/Java-Prozess.

GPU wird aktuell als N/A angezeigt, wenn keine zuverlässige Minecraft-spezifische GPU-Auslastung verfügbar ist. FrameGuard zeigt lieber N/A, statt falsche oder irreführende systemweite GPU-Werte als Minecraft-Wert auszugeben.

Optional können Fallbacks für Ressourcenwerte in der Config aktiviert werden. Diese Fallbacks sind standardmäßig deaktiviert.

HUD-Steuerung

Standard-Tasten:

Taste Funktion
F9 HUD ein-/ausschalten
F10 HUD-Modus wechseln
Alt + F9 Werte und Statistiken zurücksetzen

Die Tasten können in den Minecraft-Steuerungsoptionen geändert werden.

Tab-Menü Ping-Anzeige

FrameGuard kann im Tab-Menü den Ping als Zahl anzeigen.

Das Ziel ist, das Vanilla-Ping-Symbol durch eine direkte Ping-Zahl zu ersetzen, während das Tab-Menü ansonsten möglichst nah am Vanilla-Verhalten bleibt.

Der Ping wird farblich nach den Ping-Grenzwerten aus der Client-Config eingefärbt.

  • Grün bedeutet guter Ping.
  • Orange bedeutet Warnbereich.
  • Rot bedeutet schlechter Ping.

FPS-Control

FrameGuard kann die FPS je nach Situation begrenzen.

Typische Werte:

  • 30 FPS im Hintergrund
  • 60 FPS in Menüs

Ab Version 0.1.5 wurde der FPS-Limiter überarbeitet.

FrameGuard verändert nicht mehr den sichtbaren Minecraft-FPS-Slider in den Videoeinstellungen, wenn Menü- oder Hintergrund-FPS-Limits greifen.

Das bedeutet:

  • Menü-FPS-Limit funktioniert weiterhin.
  • Hintergrund-FPS-Limit funktioniert weiterhin.
  • Der normale FPS-Wert des Spielers bleibt erhalten.
  • Die Videoeinstellungen wirken nicht mehr so, als würden sie von FrameGuard überschrieben.
  • Im normalen Gameplay nutzt Minecraft wieder den normalen FPS-Wert des Spielers.

Performance-Profile

Serverseitige Performance-Funktionen können über Profile gesteuert werden.

Die Profile befinden sich in der Server-Config im Bereich:

[performance]

Verfügbare Profile:

Profil Bedeutung
off Deaktiviert die Performance-Guards
safe Vorsichtige Optimierungen
balanced Standard, Mittelweg zwischen Performance und Verhalten
aggressive Stärkere Eingriffe für große Server oder extreme Situationen

Client Entity Render Guard

Der Client Entity Render Guard reduziert Rendering-Last, wenn sehr viele Entities vorhanden sind.

Wenn die Anzahl der Entities über dem eingestellten Limit liegt, kann FrameGuard entfernte Living-Entities ausblenden. Diese Entities werden dabei nicht gelöscht und auch nicht vom Server entfernt. Sie werden nur clientseitig nicht gerendert.

Standardmäßig werden Spieler nicht ausgeblendet.

Zusätzlich können geschützt werden:

  • benannte Entities
  • Boss-Entities
  • gezähmte Entities

Entities innerhalb der eingestellten Chunk-Distanz um den Spieler bleiben sichtbar.

Diese Funktion ist clientseitig und wird über die Client-Config gesteuert.

Server Entity Cramming Guard

Der Server Entity Cramming Guard erweitert den Schutz gegen Entity-Spam auf nichtlebende Entities.

Vanilla Entity Cramming betrifft nicht alle problematischen Entity-Arten gleich stark. FrameGuard kann deshalb zusätzliche nichtlebende Entities pro Block begrenzen.

Betroffene Entities können zum Beispiel sein:

  • Boote
  • Loren
  • Armor Stands
  • andere nichtlebende Entities

Gedroppte Items werden standardmäßig ignoriert.

TNT wird vom Entity Cramming Guard ignoriert, weil TNT vom TNT Guard separat behandelt wird.

Die Einstellung:

max_entity_cramming = 0

bedeutet, dass FrameGuard die Vanilla-Gamerule maxEntityCramming nutzt.

Wenn die Vanilla-Gamerule maxEntityCramming ebenfalls 0 ist, ist der Entity Cramming Guard aus.

Über ignored_entity_types können bestimmte Entity-Typen vom Guard ausgeschlossen werden.

XP-Orb-Merging

Ab Version 0.1.5 kann FrameGuard XP-Orbs stärker zusammenführen.

Wichtig:

FrameGuard verändert nicht, wie viel XP Mobs, Blöcke, Farmen oder andere Mods erzeugen.

Stattdessen werden bereits vorhandene XP-Orbs in einem größeren Radius zusammengeführt. Dadurch kann die Anzahl der XP-Entities deutlich reduziert werden.

Das ist besonders hilfreich bei:

  • Mob-Farmen
  • XP-Farmen
  • Mod-Farmen
  • großen XP-Drops
  • Servern mit vielen XP-Orbs

Wichtige Server-Config-Werte:

[performance.server.xp_orb_merge]
enabled = true
radius = 6.0
scan_interval_ticks = 20
max_value_per_orb = 32767
max_merges_per_scan = 1000
max_orbs_per_scan = 5000

max_value_per_orb ist bewusst begrenzt. FrameGuard verwendet kein echtes unendliches XP-Limit, weil extrem hohe Werte zu Kompatibilitäts- oder Speicherproblemen führen könnten.

Ground Item Merging

Ab Version 0.1.5 kann FrameGuard gedroppte Items in einem größeren Radius zusammenführen.

Diese Funktion betrifft nur Item-Entities, die am Boden liegen.

Nicht verändert werden:

  • Spieler-Inventare
  • Kisten
  • Container
  • normale Inventar-Stacklimits

Standardmäßig können Item-Stacks am Boden ungefähr bis zum Dreifachen der normalen Stackgröße zusammengeführt werden.

Beispiel:

  • normales Stacklimit: 64
  • Standard-Bodenlimit: 192

Items, die kürzlich von Spielern gedroppt wurden, werden geschützt und für eine einstellbare Zeit nicht von FrameGuard zusammengeführt.

Wichtige Server-Config-Werte:

[performance.server.ground_item_merge]
enabled = true
radius = 5.0
scan_interval_ticks = 20
stack_multiplier = 3
max_stack_size = 192
max_merges_per_scan = 1000
max_items_per_scan = 5000
player_dropped_protection_ticks = 200

player_dropped_protection_ticks = 200 entspricht ungefähr 10 Sekunden.

Item-Cleanup mit Chat-Warnung

Ab Version 0.1.5 enthält FrameGuard ein optionales Cleanup-System für herumliegende Items.

Wenn zu viele nicht geschützte Item-Entities am Boden liegen, startet FrameGuard zuerst eine Warnphase im Chat. Danach werden die betroffenen nicht geschützten Items entfernt.

Kürzlich von Spielern gedroppte Items bleiben während ihrer Schutzzeit erhalten.

Standard-Warnpunkte:

  • 30 Sekunden
  • 15 Sekunden
  • 10 Sekunden
  • 5 Sekunden
  • 3 Sekunden
  • 2 Sekunden
  • 1 Sekunde

Beispielhafte Chat-Meldungen:

FrameGuard: Zu viele herumliegende Items erkannt. Nicht geschützte Item-Entities werden in 30 Sekunden aufgeräumt.
FrameGuard: Item-Aufräumung in 15 Sekunden.
FrameGuard: Item-Aufräumung in 10 Sekunden.
FrameGuard: Item-Aufräumung in 5 Sekunden.
FrameGuard: Item-Aufräumung in 3 Sekunden.
FrameGuard: Item-Aufräumung in 2 Sekunden.
FrameGuard: Item-Aufräumung in 1 Sekunde.
FrameGuard: Item-Aufräumung abgeschlossen. Entfernte nicht geschützte Item-Entities: <Anzahl>.

Wenn die Anzahl der nicht geschützten Items vor Ablauf des Countdowns wieder unter das Limit fällt, wird die Aufräumung abgebrochen.

Wichtige Server-Config-Werte:

[performance.server.ground_item_cleanup]
enabled = true
max_unprotected_items = 1000
scan_interval_ticks = 100
warning_seconds = 30
broadcast_warnings = true
warning_points_seconds = [30, 15, 10, 5, 3, 2, 1]
max_removed_per_cleanup = 0

max_removed_per_cleanup = 0 bedeutet unbegrenzt. Standardmäßig werden nach der Warnphase alle nicht geschützten Item-Entities entfernt.

Wenn ein Limit gesetzt werden soll, kann ein Wert größer als 0 eingetragen werden.

Beispiel:

max_removed_per_cleanup = 5000

Dann werden pro Cleanup maximal 5000 nicht geschützte Item-Entities entfernt.

TNT Guard

Der TNT Guard ist ein serverseitiges Performance-System gegen große TNT-Mengen.

FrameGuard verhindert, dass extrem viele TNT-Entities gleichzeitig aktiv laufen und explodieren.

Intern unterscheidet FrameGuard zwischen aktiver TNT und wartender TNT.

Aktive TNT läuft normal weiter und kann explodieren.

Wartende TNT bleibt als TNT-Entity vorhanden, wird aber eingefroren. Der Fuse-Timer wird pausiert. Wartende TNT kann unsichtbar, stumm und bewegungslos gemacht werden.

Wenn wieder aktive Slots frei sind, werden wartende TNT-Entities nach und nach aktiviert.

TNT Activation Queue

Große TNT-Ketten können extremen Lag erzeugen, weil Explosionen sehr viele TNT-Blöcke gleichzeitig zünden.

FrameGuard kann diese TNT-Blöcke abfangen und in eine Warteschlange legen. Pro Tick werden nur begrenzt viele TNT-Blöcke aktiviert.

Dadurch laufen große TNT-Ketten kontrollierter und verursachen weniger FPS- und TPS-Einbrüche.

Wichtige Server-Config-Werte:

max_active_tnt
freeze_excess_tnt
queue_exploded_tnt_blocks
max_queued_tnt_activations_per_tick
max_queued_tnt_blocks

Item-Ban-System

FrameGuard besitzt ein serverseitiges Item-Ban-System.

Damit können Admins Items bannen, auch wenn sie von anderen Mods stammen.

Alle Item-Ban-Befehle laufen unter:

/frameguard

Item-Ban-Befehle

/frameguard item ban

Bannt das Item, das der ausführende Spieler in der Hand hält. Wenn die Mainhand leer ist, wird die Offhand geprüft.

/frameguard item banlist

Zeigt alle gebannten Items an.

/frameguard item list

Alternative Anzeige der Banliste.

/frameguard item unban <item_id>

Entfernt ein Item wieder von der Banliste.

Beispiel:

/frameguard item unban minecraft:bedrock

Item-Ban Permissions

Das benötigte Permission-Level ist in der Server-Config einstellbar.

Standardmäßig ist OP-Level 3 vorgesehen.

Config-Wert:

[commands]
permission_level = 3

Was entfernt das Item-Ban-System?

Gebannte Items werden entfernt aus:

  • Online-Spieler-Inventaren
  • Enderchests
  • offenen Menüs
  • Cursor-/Carried-Stacks
  • gedroppten Item-Entities

Spieler können optional benachrichtigt werden, wenn ein gebanntes Item entfernt wurde.

Offline-Spieler-Inventare werden nicht direkt bearbeitet. Sobald ein Spieler wieder joint, werden gebannte Items aus seinem Inventar entfernt.

Geschlossene Kisten und Container in der Welt werden nicht global durchsucht. Das schützt die Server-Performance.

Log-Export

FrameGuard kann Logs und Diagnoseinformationen exportieren.

Befehl:

/frameguard exportlogs

Der Export wird gespeichert unter:

frameguard-exports

Der Export kann enthalten:

  • latest.log
  • debug.log
  • Crash-Reports
  • FrameGuard-Configs
  • gefilterte wichtige Log-Zeilen
  • Systeminformationen
  • Minecraft-/Forge-Zusammenfassung

Der Log-Export ist hilfreich, wenn Probleme an Modpack-Ersteller, Server-Admins oder den FrameGuard-Entwickler gemeldet werden sollen.

Crash-Export

FrameGuard kann bei einem Crash automatisch einen Export vorbereiten.

Die Funktion wird über die Client-Config gesteuert.

Wenn auto_export_on_crash aktiviert ist, versucht FrameGuard bei einem Crash relevante Logs automatisch zu exportieren.

Commands

Client-Befehl

/frameguard exportlogs

Erstellt einen Log- und Diagnoseexport.

Server-Befehle

/frameguard item ban
/frameguard item banlist
/frameguard item list
/frameguard item unban <item_id>

Alle Server-Befehle benötigen das in der Server-Config eingestellte Permission-Level.

Client-Config Übersicht

Pfad:

config/frameguard/frameguard-client.toml

Wichtige Bereiche:

hud_thresholds
hud_state
hud
fps_control
performance.client
performance.client.entity_render_guard
debug_hud
hud_visible
network_thresholds
session
network
crash_export
log_export

Debug-HUD Client-Config

Wichtige Werte:

[debug_hud]
resource_monitoring_enabled = true
show_ram = true
show_cpu = true
show_gpu = true
allow_system_ram_fallback = false
allow_system_cpu_fallback = false
allow_system_gpu_fallback = false
show_unavailable_as_na = true
resource_sample_interval_ms = 1000
ram_warn_percent = 80.0
ram_bad_percent = 90.0
cpu_warn_percent = 80.0
cpu_bad_percent = 95.0
gpu_warn_percent = 80.0
gpu_bad_percent = 95.0

Fallbacks sind standardmäßig deaktiviert, damit keine irreführenden systemweiten Werte angezeigt werden.

Server-Config Übersicht

Pfad:

config/frameguard/frameguard-server.toml

Wichtige Bereiche:

server
tps_sync
commands
performance
performance.server.entity_cramming_guard
performance.server.xp_orb_merge
performance.server.ground_item_merge
performance.server.ground_item_cleanup
performance.server.tnt_guard
item_ban

Häufige Fragen

Warum steht bei TPS N/A?

TPS ist nur verfügbar, wenn der Server FrameGuard korrekt geladen hat und TPS-Sync aktiv ist.

Prüfe:

  • Ist FrameGuard auf dem Server installiert?
  • Ist TPS-Sync in der Server-Config aktiviert?
  • Ist der Client korrekt mit dem Server verbunden?

Muss FrameGuard auf den Server?

Für reine Client-Funktionen wie HUD, Debug-HUD, FPS-Control oder Client Entity Render Guard reicht der Client.

Für Server-Funktionen wird FrameGuard auf dem Server benötigt.

Server-Funktionen sind unter anderem:

  • TPS-Sync
  • TNT Guard
  • Entity Cramming Guard
  • XP-Orb-Merging
  • Ground Item Merging
  • Item-Cleanup
  • Item-Ban-System
  • Server-Performance-Profile

Warum steht GPU auf N/A?

FrameGuard zeigt GPU-Auslastung nur an, wenn ein zuverlässiger Minecraft-spezifischer Wert verfügbar ist.

Aktuell ist GPU häufig N/A, weil Standard-Java keine zuverlässige prozessbezogene GPU-Auslastung bereitstellt.

FrameGuard zeigt lieber N/A, statt falsche systemweite GPU-Werte als Minecraft-Wert auszugeben.

Warum explodiert TNT verzögert?

Das ist der TNT Guard.

Er verhindert, dass zu viele TNT-Entities gleichzeitig aktiv sind oder dass große TNT-Ketten in einem Tick komplett gezündet werden.

Warum werden XP-Kugeln zusammengeführt?

Das ist die XP-Orb-Optimierung.

Sie verändert nicht die XP-Menge. Sie reduziert nur die Anzahl der XP-Orb-Entities, indem XP-Orbs in einem größeren Radius zusammengeführt werden.

Warum werden Items am Boden größer gestapelt?

Das ist das Ground Item Merging.

Es betrifft nur Items am Boden und verändert keine Inventar-, Kisten- oder Container-Stacklimits.

Warum werden meine gerade gedroppten Items nicht direkt gemerged?

Items, die kürzlich von Spielern gedroppt wurden, sind für eine einstellbare Zeit geschützt.

Standardwert:

player_dropped_protection_ticks = 200

Das entspricht etwa 10 Sekunden.

Warum kommt eine Chat-Warnung wegen Item-Aufräumung?

FrameGuard hat erkannt, dass zu viele nicht geschützte Item-Entities am Boden liegen.

Nach dem Countdown werden nicht geschützte Item-Entities entfernt. Kürzlich von Spielern gedroppte Items bleiben während ihrer Schutzzeit erhalten.

Warum verschwinden Items?

Mögliche Gründe:

  1. Ein Admin hat das Item über das Item-Ban-System gebannt.
  2. Das Item wurde durch das Item-Cleanup-System entfernt.
  3. Das Item wurde mit anderen gleichen Items am Boden zusammengeführt.

Prüfe bei Item-Ban:

/frameguard item banlist

Prüfe bei Item-Cleanup die Server-Config:

[performance.server.ground_item_cleanup]

Warum werden nicht alle Kisten gescannt?

FrameGuard scannt aktuell keine geschlossenen Welt-Container global. Das schützt die Server-Performance.

Gebannte Items werden entfernt, sobald sie in Online-Spieler-Inventaren, offenen Menüs oder als Drop auftauchen.

Warum wird mein FPS-Limit nicht mehr im Optionsmenü verändert?

Seit FrameGuard 0.1.5 verändert FrameGuard den sichtbaren FPS-Slider nicht mehr.

Menü- und Hintergrund-FPS werden intern begrenzt, ohne die sichtbare Minecraft-Einstellung zu überschreiben.

Empfohlene Standardwerte

Für normale Nutzung wird das Profil balanced empfohlen.

Für vorsichtige Server wird safe empfohlen.

Für extreme TNT-, XP- oder Item-Situationen kann aggressive genutzt werden.

Wenn die Performance-Guards deaktiviert werden sollen, kann off genutzt werden.

Hinweise für Modpack-Entwickler

FrameGuard eignet sich besonders für:

  • große Forge-Modpacks
  • technische Server
  • öffentliche Modpack-Server
  • Diagnose bei FPS- und TPS-Problemen
  • TNT- und Entity-Spam-Schutz
  • XP-Farm-Optimierung
  • Item-Entity-Reduktion
  • Admin-Werkzeuge über das Item-Ban-System

Empfohlen wird:

  • FrameGuard auf Client und Server installieren
  • Server-Config bewusst prüfen
  • alte Config-Dateien beim Update auf 0.1.5 löschen oder neu generieren lassen
  • bei Fehlerberichten den Log-Export anfordern

Kompatibilität

Derzeit sind keine bekannten Inkompatibilitäten mit anderen Mods dokumentiert.

Interne Tests der aktuellen FrameGuard-Versionen 0.1.0 bis 0.1.5 haben keine kritischen Bugs gezeigt. Getestete Umgebungen können jedoch nicht alle möglichen Modpacks, Server-Setups, Betriebssysteme, Hardware-Kombinationen oder Modloader-Konfigurationen abdecken.

Wenn ein Problem auftritt, melde es bitte mit:

  • FrameGuard-Version
  • Minecraft-Version
  • Modloader und Modloader-Version
  • Client oder Dedicated Server
  • kurzer Fehlerbeschreibung
  • FrameGuard-Log-Export
  • relevanter Crash-Report, falls vorhanden

Fehler melden

FrameGuard wird aktuell alleine entwickelt. Dadurch können Fehler, Bugs oder unerwartete Probleme in einzelnen Versionen auftreten.

Wenn du einen Fehler findest, melde ihn bitte als Kommentar auf CurseForge oder über den Discord-Server.

Bitte füge bei technischen Problemen möglichst einen FrameGuard-Log-Export hinzu.

CurseForge Projeckt seite https://www.curseforge.com/minecraft/mc-mods/frameguard

Discord Server https://discord.gg/hH7mPYR9vG

Clone this wiki locally