Troubleshooting

Häufige Probleme und deren Behebung.

Zwei Chat-Boxen / Doppelter Chat

Cause: Die Standard-chat-Ressource läuft noch parallel zu BUPA Chat. Da BUPA Chat provide 'chat' nutzt, registrieren sich beide als Chat.

Fix: Stoppe oder entferne die Standard-chat-Ressource. Nutze in deiner Config niemals ensure chat – nur ensure bupa-chat.

Ressource startet nicht / UI bleibt leer

Cause: Eine fehlende Abhängigkeit. BUPA Chat benötigt ox_lib, qb-core und deklariert dependency '/assetpacks'.

Fix: Stelle sicher, dass alle drei vor BUPA Chat starten:

ensure ox_lib
ensure qb-core
ensure assetpacks
ensure bupa-chat

Wenn assetpacks fehlt, schlägt das Laden der gepackten UI-Assets fehl und der Chat wird nie angezeigt.

Keine Nachrichten werden angezeigt

• Stelle sicher, dass andere Ressourcen Nachrichten über die Standard-API senden – chat:addMessage (Event) oder exports.chat:addMessage(...). Siehe Developer API.
• Überprüfe bei Kategorie-Nachrichten, ob der Spieler tatsächlich Zugriff hat: permissions (ACE), jobs oder gangs der Kategorie müssen übereinstimmen. Ein Spieler ohne Zugriff sieht oder nutzt diesen Tab niemals.
• Überprüfe maxLength der Kategorie – zu lange Nachrichten werden abgeschnitten, nicht verworfen, aber ein nicht übereinstimmender type in einer benutzerdefinierten Integration wird ignoriert.

Vorschläge werden nicht angezeigt

• Befehlsvorschläge basieren auf registrierten Befehlen, die der Spieler per ACE verwenden darf (command.<name>). Wenn ein Befehl für diesen Spieler nicht per ACE erlaubt ist, wird er nicht vorgeschlagen.
• Vorschläge werden beim Laden des Spielers und beim Starten/Stoppen von Ressourcen aktualisiert. Wenn ein neu registrierter Befehl nicht erscheint, starte die bereitstellende Ressource neu oder öffne den Chat erneut.
• Für benutzerdefinierte Hilfetexte/Parameter kannst du diese explizit mit chat:addSuggestion / chat:addSuggestions übergeben.

Alles ist auf Englisch (oder in der falschen Sprache)

Cause: Der Locale-Convar ist nicht gesetzt, weshalb BUPA Chat auf en zurückfällt.

Fix: Setze die Sprache in der server.cfg:

setr ox:locale "tr"
# oder erzwinge es nur für den Chat:
setr bupa-chat:locale "tr"

Denke daran, dass bupa-chat:locale den Wert von ox:locale überschreibt. Für eine Live-Änderung nutze das Client-Event bupa:changeLanguage. Siehe Localization.

Fehlende Übersetzungen zeigen den Schlüsselnamen

t() gibt den Schlüssel zurück (z. B. CATEGORY_ADMIN_LABEL), wenn eine Übersetzung in der aktiven Sprachdatei fehlt. Füge den fehlenden Schlüssel zur entsprechenden locales/<code>.json hinzu oder kopiere ihn aus der en.json.

qb-core / Framework nicht erkannt

Cause: Der Framework-Kern wurde nach BUPA Chat gestartet (oder läuft beim Start von BUPA Chat noch nicht).

Fix: Stelle sicher, dass qb-core (oder qbx_core / es_extended) vor BUPA Chat startet. Die Framework-Brücke erkennt Qbox, QB-Core und ESX automatisch; du kannst sie auch mit dem Convar bupa-chat:framework festlegen oder deaktivieren (Standard ist qb-core; setze es auf false, um ohne Framework zu laufen).

Discord-Logging / Brücke funktioniert nicht

• Webhook-Logs kommen nicht an: Stelle sicher, dass die URLs in server/webhook.lua echte Discord-Webhook-URLs und keine Platzhalterwerte sind.
• Discord → Chat Brücke bleibt stumm: Setze in shared/config/discord.lua active = true, trage die channelId ein und gib ein Bot-Token + Server-ID (Guild ID) an (entweder in config.discord oder übernommen aus config.adminChatName.discord). Von Bots verfasste Nachrichten werden absichtlich ignoriert.