TJ Utils ist eine eigenständige Client-Oberfläche von TJ Scripts. Version 1.0.0 bietet Benachrichtigungen, einen Fortschrittsbalken und TextUI über Exporte und Client-Events. Die Installation ersetzt keine Framework-Benachrichtigungen automatisch und ergänzt keine Spielinteraktionen; andere Skripte müssen die API aufrufen.
Ressource einrichten und API nutzen
Entpacke das Repository nach tj_utils, mit fxmanifest.lua, client und web direkt im Ressourcenordner. Belasse web/sounds/notification.mp3 bei den Oberflächendateien. Trage ensure tj_utils vor aufrufenden Skripten ein. Das Manifest nennt keine Abhängigkeit von ESX, QBCore oder ox_lib; die HTML-Datei lädt jedoch externe Stylesheets für Font Awesome und Cascadia Code.
Die Client-Exporte heißen ShowNotification, ShowProgress, HideProgress, ShowTextUI und HideTextUI. ShowNotification erhält eine Tabelle mit type, title, description, duration und position. Dokumentierte Typen sind info, success, error und warning. Serverskripte senden passende Client-Events wie tj_utils:notify an einen bestimmten Spieler, statt einen Server-Export aufzurufen.
Der Fortschrittsabschluss ist nur ein Timer
ShowProgress akzeptiert einen Beschriftungstext oder eine Einstellungstabelle und einen optionalen Callback. Lua verwendet standardmäßig 5000 Millisekunden und die Position bottom. Nach dieser Zeit wird der Callback mit true aufgerufen. HideProgress blendet nur die Browseranzeige aus; der Lua-Timer läuft weiter und meldet keinen Abbruch. Vergib Items oder Zahlungen nicht allein aufgrund dieses Callbacks.
Die Oberfläche hat einen gemeinsamen Fortschrittscontainer. Ein neuer Balken ersetzt den visuellen Timer, während ältere Lua-Callbacks weiterlaufen können. Koordiniere die Zuständigkeit in aufrufenden Skripten und teste Überlappungen, frühes Ausblenden und Ressourcenstopps. Prüfe Zeitwerte vor der Übergabe.
Texte, Benachrichtigungen und Integrationstests
ShowTextUI akzeptiert einen String oder eine Tabelle und bleibt bis HideTextUI sichtbar. Eine angezeigte Aufforderung belegt die genannte Aktionstaste nicht. Benachrichtigungen teilen einen Container; eine neue Position kann deshalb vorhandene Meldungen verschieben. Teste deine tatsächlichen Positionen und Kombinationen.
Titel und Beschreibung von Benachrichtigungen gelangen ungefiltert über innerHTML in die Oberfläche. Fortschrittsbeschriftung und TextUI nutzen textContent. Verwende vertrauenswürdiges Markup oder maskiere fremde Texte vor der Übergabe. Die Demo-Befehle sind /info, /success, /error, /warning, /progress, /textui und /hidetextui; prüfe Namenskonflikte.
Vorhandene Entwicklervorschau
Quelle am 10. September 2026 in Revision 23b4796896d01a73a61c570d44a6a564d88ad78a geprüft. Manifest, vollständiger Lua-Client und Browser-JavaScript wurden untersucht. Es gab keinen FiveM-Spieltest, Leistungstest oder Framework-Integrationstest.