Rozwiązywanie problemów

Częste problemy i sposoby ich naprawy.

Dwa okna czatu / zduplikowany czat

Przyczyna: domyślny zasób chat nadal działa w tle razem z BUPA Chat. Ponieważ BUPA Chat deklaruje provide 'chat', oba zgłaszają się jako czat.

Naprawa: zatrzymaj lub usuń domyślny zasób chat. Nigdy nie używaj ensure chat w swojej konfiguracji – wyłącznie ensure bupa-chat.

Zasób nie chce się uruchomić / Interfejs jest pusty

Przyczyna: brakująca zależność. BUPA Chat wymaga ox_lib oraz qb-core, a także deklaruje zależność dependency '/assetpacks'.

Naprawa: upewnij się, że wszystkie trzy elementy uruchamiają się przed BUPA Chat:

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

Jeśli brakuje zasobu assetpacks, spakowane zasoby interfejsu nie wczytają się, a czat się nie pojawi.

Brak wyświetlanych wiadomości

• Upewnij się, że inne zasoby wysyłają wiadomości za pomocą standardowego API – chat:addMessage (event) lub exports.chat:addMessage(...). Zobacz Developer API.
• W przypadku wiadomości w kategoriach, upewnij się, że gracz faktycznie ma do nich dostęp: permissions (ACE), jobs lub gangs dla danej kategorii muszą się zgadzać. Gracz bez dostępu nigdy nie zobaczy tej zakładki ani jej nie użyje.
• Sprawdź parametr maxLength kategorii – zbyt długie wiadomości są przycinane, a nie odrzucane, jednak niedopasowany type w niestandardowej integracji zostanie zignorowany.

Podpowiedzi się nie pojawiają

• Podpowiedzi komend są generowane na podstawie zarejestrowanych komend, do których gracz posiada uprawnienia ACE (command.<name>). Jeśli komenda nie jest dozwolona przez ACE dla danego gracza, nie zostanie podpowiedziana.
• Podpowiedzi odświeżają się podczas ładowania gracza oraz po uruchomieniu/zatrzymaniu zasobów. Jeśli nowo zarejestrowana komenda się nie pojawia, zrestartuj dostarczający ją zasób lub otwórz czat ponownie.
• W przypadku niestandardowych tekstów pomocy / parametrów, przekaż je jawnie za pomocą chat:addSuggestion / chat:addSuggestions.

Wszystko jest po angielsku (lub w złym języku)

Przyczyna: zmienna konfiguracyjna (convar) języka nie jest ustawiona, więc BUPA Chat domyślnie przełącza się na en.

Naprawa: ustaw język w pliku server.cfg:

setr ox:locale "tr"
# lub wymuś tylko dla czatu:
setr bupa-chat:locale "tr"

Pamiętaj, że bupa-chat:locale nadpisuje ox:locale. Aby zmienić język na żywo, użyj eventu klienta bupa:changeLanguage. Zobacz Lokalizacja.

Brakujące tłumaczenia wyświetlają nazwę klucza

Funkcja t() zwraca klucz (np. CATEGORY_ADMIN_LABEL), gdy w aktywnym pliku językowym brakuje tłumaczenia. Dodaj brakujący klucz do odpowiedniego pliku locales/<code>.json lub skopiuj go z en.json.

Nie wykryto qb-core / frameworka

Przyczyna: rdzeń frameworka uruchomił się po uruchomieniu BUPA Chat (lub nie działa w momencie jego startu).

Naprawa: upewnij się, że qb-core (lub qbx_core / es_extended) uruchamia się przed BUPA Chat. Mostek frameworka automatycznie wykrywa Qbox, QB-Core oraz ESX; możesz go również przypisać na sztywno lub wyłączyć za pomocą zmiennej konfiguracyjnej bupa-chat:framework (domyślnie qb-core; ustaw na false, aby uruchomić czat bez frameworka).

Logowanie Discord / mostek nie działa

• Logi webhook nie dochodzą: upewnij się, że adresy URL w pliku server/webhook.lua to prawdziwe adresy URL webhooków Discord, a nie wartości zastępcze (placeholder).
• Mostek Discord → czat nie odpowiada: w pliku shared/config/discord.lua ustaw active = true, wpisz channelId oraz podaj token bota + ID serwera (guild ID) (w config.discord lub pobrane ponownie z config.adminChatName.discord). Wiadomości wysyłane przez boty są celowo ignorowane.