Troubleshooting

Kendala umum dan cara memperbaikinya.

Dua kotak chat / chat duplikat

Penyebab: resource chat bawaan masih berjalan berdampingan dengan BUPA Chat. Karena BUPA Chat menggunakan provide 'chat', keduanya terdaftar sebagai chat.

Solusi: hentikan atau hapus resource chat bawaan. Jangan pernah ensure chat di mana pun dalam konfigurasi Anda — cukup ensure bupa-chat.

Resource tidak mau mulai / UI kosong

Penyebab: dependensi yang hilang. BUPA Chat bergantung pada ox_lib, qb-core, dan mendeklarasikan dependency '/assetpacks'.

Solusi: pastikan ketiganya dimulai sebelum BUPA Chat:

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

Jika assetpacks tidak ada, aset UI yang dikemas gagal dimuat dan chat tidak akan pernah muncul.

Tidak ada pesan yang muncul

• Pastikan resource lain mengirim pesan melalui API standar — chat:addMessage (event) atau exports.chat:addMessage(...). Lihat Developer API.
• Untuk pesan kategori, pastikan pemain benar-benar memiliki akses: permissions (ACE), jobs, atau gangs pada kategori tersebut harus cocok. Pemain tanpa akses tidak akan pernah melihat atau menggunakan tab tersebut.
• Periksa maxLength pada kategori — pesan yang terlalu panjang akan dipotong, bukan dihapus, tetapi type yang tidak cocok dalam integrasi kustom akan diabaikan.

Saran tidak muncul

• Saran perintah dibuat dari perintah terdaftar yang diizinkan ACE untuk digunakan oleh pemain (command.<name>). Jika suatu perintah tidak diizinkan ACE untuk pemain tersebut, perintah itu tidak akan disarankan.
• Saran akan diperbarui saat pemain memuat game dan saat resource dimulai/berhenti. Jika perintah yang baru didaftarkan tidak muncul, mulai ulang resource penyedia atau buka kembali chat.
• Untuk teks bantuan/parameter kustom, dorong secara eksplisit dengan chat:addSuggestion / chat:addSuggestions.

Semuanya dalam bahasa Inggris (atau bahasa yang salah)

Cause: convar lokal tidak diatur, sehingga BUPA Chat kembali ke en.

Solusi: atur bahasa di server.cfg:

setr ox:locale "tr"
# atau paksa khusus chat:
setr bupa-chat:locale "tr"

Ingat bupa-chat:locale menggantikan ox:locale. Untuk perubahan langsung, gunakan event klien bupa:changeLanguage. Lihat Localization.

Terjemahan yang hilang menampilkan nama kunci

t() mengembalikan key (misalnya CATEGORY_ADMIN_LABEL) ketika terjemahan tidak ada dalam file bahasa yang aktif. Tambahkan kunci yang hilang ke locales/<code>.json tersebut, atau salin dari en.json.

qb-core / framework tidak terdeteksi

Penyebab: core framework dimulai setelah (atau tidak berjalan ketika) BUPA Chat melakukan booting.

Solusi: pastikan qb-core (atau qbx_core / es_extended) dimulai sebelum BUPA Chat. Bridge framework mendeteksi Qbox, QB-Core, dan ESX secara otomatis; Anda juga dapat menyematkan atau menonaktifkannya dengan convar bupa-chat:framework (default qb-core; setel ke false untuk berjalan tanpa framework).

Logging Discord / bridge tidak berfungsi

• Log webhook tidak masuk: konfirmasikan bahwa URL di server/webhook.lua adalah URL webhook Discord yang valid dan bukan nilai placeholder.
• Bridge Discord → chat diam: di shared/config/discord.lua, setel active = true, isi channelId, dan berikan token bot + ID guild (di config.discord atau digunakan ulang dari config.adminChatName.discord). Pesan yang dibuat oleh bot sengaja diabaikan.