Um ein FiveM HUD zu installieren, bestätige dessen Framework und Abhängigkeiten, füge dessen Ressourcenordner hinzu, starte es nach diesen Abhängigkeiten und teste die angezeigten Werte mit einem normalen Spieler. Ein HUD, das auf dem Bildschirm erscheint, benötigt immer noch eine Daten- und Usability-Prüfung.
Kompatibilität prüfen und Rollback beibehalten
Lies die HUD-Dokumentation für die unterstützte Framework-Version, Inventar-, Status- und Sprachressourcen. ESX-, QBCore- und Qbox-Integrationen sind nicht austauschbar, es sei denn, der Ersteller unterstützt sie explizit. Sichere das aktuelle HUD, die Konfiguration und alle Datenbanktabellen, die die Installation ändert.
Teste zuerst auf einem separaten Server. Deaktiviere das alte HUD während des Tests, um doppelte Overlays und konkurrierende Minimap- oder Statuslogik zu vermeiden.
Installiere die Ressource
- Entpacke das Paket. Der Ressourcenordner muss fxmanifest.lua in seinem Stammverzeichnis enthalten, anstatt einer weiteren verschachtelten Kopie des Ordners. Behalte dokumentierte Ordnernamen bei.
- Installiere die erforderlichen Abhängigkeiten und konfiguriere die unterstützte Framework-Integration des HUDs. Halte Geheimnisse von Client- und NUI-Dateien fern.
- Füge ensure gefolgt vom genauen Namen des Ressourcenordners zu server.cfg nach seinen Abhängigkeiten hinzu. Starte den Testserver und lies den ersten Ressourcenfehler, bevor du fortfährst.
- Tritt mit einem gewöhnlichen Konto bei. Überprüfe Gesundheit, Rüstung, Hunger/Durst (sofern unterstützt), Geld, Job und Fahrzeugwerte anhand des tatsächlichen Spielzustands.
Überprüfe die Benutzeroberfläche
Teste verschiedene Auflösungen und UI-Skalierungen, das Ein- und Aussteigen aus Fahrzeugen, das erneute Verbinden, Charakterwechsel und einen vollständigen Serverneustart. Bestätige, dass Menüs anklickbar bleiben und wichtiger Text lesbar ist, ohne sich nur auf Farbe zu verlassen. Überprüfe die F8- und Serverkonsolen auf Fehler.
Finde die Ursache eines Fehlers
Keine Benutzeroberfläche: Überprüfe den Ressourcenstartfehler, das Manifest, die NUI-Dateipfade und die Browser-Assets. Eine Benutzeroberfläche mit falschen Werten deutet stattdessen auf die Framework- oder Statusintegration hin. Überlappende Elemente deuten darauf hin, dass eine andere HUD- oder Minimap-Ressource noch läuft.
Stelle das alte HUD und die Konfiguration wieder her, wenn die neue Ressource diese Prüfungen nicht besteht. Stelle ein Datenbank-Backup nur wieder her, wenn seine Migration Daten geändert hat; koordiniere dies so, dass neuere Spielerfortschritte nicht überschrieben werden.
Offizielle Referenzen
Ressourcenmanifest erklärt Skript- und UI-Deklarationen; Serverbefehle dokumentieren ensure.