BUPA Chat

BUPA Chat ist ein erstklassiger, nahtloser Ersatz für den Standard-FiveM-Chat. Es liefert eine vollständig anpassbare React-Oberfläche und ersetzt die Standard-chat-Ressource, sodass jedes Skript, das bereits mit dem Spielchat kommuniziert, weiterhin funktioniert – keine Migration erforderlich.

Anstatt eines einzelnen Eingabefelds bietet BUPA Chat Spielern eine tabulatorbasierte Eingabe mit Chat-Kategorien (Befehle, OOC, Admin, Job-/Gang-Kanäle, private Nachrichten), einem Emoji-Picker, Live-Befehlsvorschlägen, /me- und /do-ähnlichen Emotes, die über dem Kopf des Spielers gerendert werden, optionalen Spieler-ID-/Namens-Abzeichen, Discord-Logging und einer pro Spieler einstellbaren Sprache, die zur Laufzeit gewechselt werden kann.

Key features

• Chat-Kategorien / Tabs — ein integrierter command-Tab sowie vollständig konfigurierbare Kategorien: OOC global, OOC lokal (Nähe), Admin, Polizei-/EMS-Jobkanäle, Gangkanäle und jede von dir definierte benutzerdefinierte Kategorie. Jede Kategorie hat ihre eigenen Farben, Tags, Berechtigungen und Nachrichtenregeln.
• Private Nachrichten — /pm (und /dm) mit separatem Styling für Sender und Empfänger.
• Emotes — /me, /do, /dice und /rps direkt nach der Installation, angezeigt als Kopftext über dem Ped und optional in den Chat spiegelnd. Füge deine eigenen mit Animationen, Distanzlimits und benutzerdefinierten Parametern hinzu.
• Emoji-Picker — ein anpassbares, kategorisiertes Emoji-Panel (Smileys, Gesten, Symbole, Objekte) mit durchsuchbaren Shortcodes.
• Befehlsvorschläge — automatisch befüllt aus registrierten Befehlen, auf die der Spieler ACE-Zugriff hat, plus allem, was du über die Standard-API chat:addSuggestion(s) übergibst.
• Spieleridentitäts-Abzeichen — optionale kategorisierende Namen, Server-ID, Job (Label/Rang) und Discord-Rollen-Tags, mit maskenbewusster Namensversteckung und einer Näherungs-ID-Anzeige über den Köpfen.
• Discord-Integration — Webhook-Logging von Chat-, Emote- und PM-Nachrichten sowie eine optionale Discord-zu-In-Game-Kanal-Brücke, die Discord-Nachrichten in den Chat weiterleitet.
• Mehrsprachigkeit — Übersetzungen über ox_lib Locales, global, pro Ressource oder live pro Sitzung auswählbar.
• Themeable React UI — Sichtbarkeitsmodi (bei Aktivität anzeigen / immer anzeigen / ausblenden), Tippgeräusche, Bei-Klick-außerhalb-schließen und konfigurierbare Öffnungs-/Sichtbarkeitstasten.

Framework

BUPA Chat wurde für QB-Core entwickelt und ist als qb-core-Abhängigkeit gelistet. Die gemeinsame Framework-Brücke erkennt zudem Qbox (qbx_core) und ESX (es_extended) automatisch zur Laufzeit, und das Framework kann über das Convar bupa-chat:framework erzwungen oder deaktiviert werden.

Die Ressource stellt die Standard-chat-Ressource bereit (provide 'chat'), sodass sie ein vollständiger Ersatz für den Standard-Chat von FiveM statt eines Add-ons ist.

Dependencies

Dependency	Purpose
ox_lib	Locales, Tastenkombinationen, Benachrichtigungen, Callbacks und UI-Helfer. Geladen als @ox_lib/init.lua und über ox_lib 'locale'.
qb-core	Framework-Kern (Spielerdaten, Jobs, Gangs). Als harte Abhängigkeit gelistet.
assetpacks	Deklariert mit dependency '/assetpacks' – erforderlich für die gepackten UI-Assets.