FJX Studios Dokumentation
Shop Discord

FAQ & Fehlerbehebung

Häufige Fragen zu Anpassung und Betrieb sowie Lösungen für typische Probleme.

Zuletzt aktualisiert: 21. August 2026

Allgemeine Fragen

Was ist FJX Disclaimer?

Ein eigenständiges (Standalone) FiveM-Skript, das beim Betreten des Servers einen vollständig anpassbaren Disclaimer anzeigt. Es ist mit allen FiveM-Frameworks kompatibel und benötigt keine speziellen Abhängigkeiten.

Funktioniert es mit meinem Framework?

Ja. FJX Disclaimer funktioniert mit jedem Framework — ESX, QBCore, vRP, QBus oder andere — ohne zusätzliche Konfiguration.

Können Spieler den Disclaimer überspringen?

Ja. Spieler können entweder warten, bis der Timer abläuft, oder die konfigurierte Taste drücken (standardmäßig die Leertaste).

Kann ich den Disclaimer mehrfach anzeigen?

Ja — manuell über den Befehl /disclaimer (wenn Config.UseCommand aktiviert ist) oder aus einer anderen Resource über den Export:

lua
exports["fjx_disclaimer"]:ShowDisclaimer()
Ist die Ressource leistungsoptimiert?

Ja. FJX Disclaimer läuft hauptsächlich clientseitig und verbraucht nur minimale Serverressourcen.

Anpassungsfragen

Wie ändere ich den Disclaimer-Text?

Über Config.Text in der config.lua.

Kann ich Farben und Design anpassen?

Ja, alle visuellen Aspekte sind vollständig anpassbar: Farben, Schatten, Schriftarten, Größen und weitere Stilelemente stehen in den entsprechenden Abschnitten der config.lua.

Kann ich die Anzeigedauer ändern?

Ja, über Config.Timeout in der config.lua — der Wert wird in Millisekunden angegeben.

Lässt sich der Disclaimer nur für neue Spieler anzeigen?

Diese Funktion ist standardmäßig nicht enthalten. Sie liesse sich umsetzen, indem du über die Datenspeicherung deines Frameworks festhältst, welche Spieler den Disclaimer bereits gesehen haben.

Fehlerbehebung

Disclaimer wird nicht angezeigt

Problem: Der Disclaimer erscheint beim Betreten des Servers nicht.

  1. Prüfen, ob Config.ShowOnJoin auf true steht
  2. Serverkonsole auf Fehlermeldungen prüfen
  3. Den Disclaimer manuell mit /disclaimer aufrufen
  4. Sicherstellen, dass die Resource korrekt in der server.cfg eingetragen ist
  5. In der Serverkonsole prüfen, ob die Resource ordnungsgemäß startet

Darstellung ist falsch oder inkonsistent

Problem: Der Disclaimer wird nicht korrekt dargestellt.

  1. CSS-Einstellungen in der config.lua auf Fehler prüfen
  2. Sicherstellen, dass alle Farbwerte im korrekten Format angegeben sind, z. B. rgba(0, 0, 0, 0.8) oder #ffffff
  3. Die Stileinstellungen versuchsweise auf die Standardwerte zurücksetzen
  4. Prüfen, ob Größenangaben korrekte Einheiten haben (px, % usw.)

Fortschrittsanzeige funktioniert nicht richtig

Problem: Die Fortschrittsanzeige wird nicht korrekt angezeigt oder aktualisiert sich nicht.

  1. Wert von Config.UpdateInterval prüfen — niedrigere Werte machen die Anzeige flüssiger
  2. Sicherstellen, dass Config.Timeout auf einen positiven Wert gesetzt ist
  3. CSS-Einstellungen der Fortschrittsanzeige prüfen

Events werden nicht ausgelöst

Problem: disclaimer:shown oder disclaimer:closed werden nicht ausgelöst oder von anderen Resourcen nicht empfangen.

  1. Prüfen, ob die Event-Namen korrekt sind
  2. Sicherstellen, dass die lauschenden Resourcen nach FJX Disclaimer gestartet werden
  3. Die Skripte, die auf die Events warten, auf korrekte Syntax prüfen

Export-Funktion funktioniert nicht

Problem: ShowDisclaimer lässt sich nicht aus anderen Resourcen aufrufen.

  1. Den korrekten Ressourcennamen verwenden, z. B. exports["fjx_disclaimer"]:ShowDisclaimer()
  2. Prüfen, ob FJX Disclaimer vor der aufrufenden Resource gestartet wird
  3. Den Aufruf versuchsweise per Timeout verzögern, damit alle Resourcen vollständig geladen sind

Erweiterte Fehlerbehebung

Debugging aktivieren

Setze Config.Debug = true in der config.lua. Das gibt zusätzliche Informationen in der Serverkonsole aus.

Client-Fehler prüfen

Prüfe die Client-Konsole auf Fehler während der Ausführung. Du öffnest sie mit F8 oder über den txAdmin-Debug-Modus.

CSS validieren

Bei komplexeren Anpassungen der Stile sicherstellen, dass die CSS-Werte gültig sind. Ungültige Werte führen dazu, dass der Disclaimer nicht korrekt angezeigt wird.

Leistungsoptimierung

Bei Leistungsproblemen:

  1. Blur-Effekt deaktivieren: Config.Background.Blur = false
  2. Box-Schatten vereinfachen: Config.Box.BoxShadow auf einen einfacheren Wert setzen
  3. Config.UpdateInterval erhöhen, um die Fortschrittsanzeige seltener zu aktualisieren

Support

https://discord.gg/7uwQwp3NeP