Eklenti sorunları

BorCube Connect siteye bağlanmıyorsa ya da ürün komutları oyuna ulaşmıyorsa adım adım kontrol listesi.

BorCube Connect'te sorunların çoğu üç yerden birindedir: config.yml ayarları, oyun sunucusunun siteye ulaşması ya da komutun izin listesinde olmaması. Bu sayfa her durum için ne yapacağını anlatır.

Önce durumu gör#

Oyunda ya da konsolda şunu yaz:

Metin

/borcube status

Satır	Anlamı
`Durum: bağlı (anlık)`	Her şey yolunda; yeni komutlar hemen gelir.
`Durum: çalışıyor (yoklama)`	Anlık bağlantı yok, eklenti siteyi aralıklarla yokluyor. Komutlar gecikmeli gelir.
`Durum: durdu`	Eklenti başlamadı. Konsoldaki uyarıya bak.
`Paneldeki sunucu`	Token'ın paneldeki hangi sunucuya ait olduğu
`Son başarılı istek`	Siteyle son başarılı konuşmanın zamanı
`Son hata`	Son isteğin neden başarısız olduğu

Panelde Mağaza → Oyun sunucuları listesindeki Connect sütunu, eklenti son 90 saniyede siteyle konuşmadıysa bağlı değil gösterir.

Ayarı düzelttikten sonra /borcube reload yaz. Siteyi hemen yoklatmak için /borcube poll kullan. Aynı uyarı konsolu doldurmasın diye en fazla 5 dakikada bir yazılır.

Eklenti bağlanmıyor#

Eklentinin konsola yazdığı uyarıya göre:

Konsoldaki uyarı	Sebep ve çözüm
`config.yml içinde token boş.`	Token yapıştırılmamış. Panelde token oluştur, `config.yml`'ye yapıştır, `/borcube reload` yaz.
`Token biçimi hatalı; ...`	Token eksik ya da fazla kopyalanmış. Panelde gösterilen değeri olduğu gibi yapıştır; `bc_` ile başlar.
`site-url https:// ile başlamalı.`	Adresin başında `https://` yok.
`site-url https olmalı (token şifresiz gönderilmesin). ...`	Adres `http://` ile başlıyor. Sitenin `https://` adresini yaz.
`Site token'ı reddetti. ...`	Token yanlış, yenilenmiş ya da iptal edilmiş; ya da paneldeki sunucunun Aktif düğmesi kapalı. Gerekirse yeni token oluştur.
`Site isteği başarısız: HTTP 301` (302, 307, 308)	`site-url` başka bir adrese yönlendiriyor (ör. `www`'li ve `www`'siz adres). Eklenti yönlendirmeleri izlemez.
`Siteye ulaşılamıyor: ...`	Oyun sunucusu siteye ulaşamıyor: alan adı çözülmüyor, giden bağlantı engelli, SSL sertifikası geçersiz ya da site kapalı.

Yönlendirme sorununda site-url değerini Yönetim paneli → Ayarlar → Genel sayfasındaki Site adresi ile birebir aynı yap. Panelin Ayarları kopyala düğmesi zaten bu adresi verir.

Komutlar teslim edilmiyor#

Sunucu sayfasındaki Komut geçmişi'nde ya da Yönetim paneli → Kayıtlar → Komut kayıtları sayfasında komutun durumuna bak.

bekliyor

Eklenti bağlı değil: önceki bölüme bak.
Sunucu sayfasının Komut geçmişi'nde komutun altında "çevrimiçi olunca" yazıyorsa komut, oyuncu o sunucuya girene kadar bekler. Bu normaldir.
Komut yanlış sunucuya gidiyor olabilir: ürünün Komutlar kartında Sunucu seçimine bak.

gönderildi

Eklenti komutu aldı ama sonucu henüz bildirmedi. 5 dakika içinde sonuç gelmezse komut kuyruğa geri döner; 5 denemeden sonra "Eklenti teslimatı onaylamadı (zaman aşımı)." nedeniyle başarısız olur.

başarısız

Neden komutun altında kırmızıyla yazar:

Neden	Çözüm
`Komut izin listesinde değil: ...`	Komutu `config.yml` içindeki `allowed-commands` listesine ekle, `/borcube reload` yaz, panelde Yeniden dene'ye bas.
`Komut bu sunucuda yasaklı: ...`	Komut `blocked-commands` listesinde. Bu komutu ürünlerde kullanma.
`Bilinmeyen komut`	Komut bu sunucuda yok. Komutu sağlayan eklenti kurulu mu, komut doğru sunucuya mı gidiyor bak. Proxy'de oyun içi komutlar (`give` gibi) yoktur.
`Sunucu komutu 30 sn içinde çalıştırmadı`	Sunucu çok yoğundu. Komut sonradan çalışmış olabilir.

teslim edildi ama oyuncu almadı

Sunucu yalnızca komutun var olup olmadığını bildirir. Var olan bir komut yanlış argüman ya da çevrimdışı oyuncu yüzünden hata verdiyse panelde yine teslim edildi görünür. Sunucu konsoluna bak. Eşya vermek gibi oyuncunun oyunda olması gereken komutlarda Oyuncu çevrimiçi kutusunu işaretle: Ürün komutları ve güvenlik.

Sürüm uyumu#

Jar	Platform	Java
`BorCubeConnect-Bukkit-<sürüm>.jar`	Spigot, Paper, Purpur (1.8.8 ve üstü), Folia	8 ve üstü
`BorCubeConnect-Bungee-<sürüm>.jar`	BungeeCord, Waterfall	8 ve üstü
`BorCubeConnect-Velocity-<sürüm>.jar`	Velocity 3.4 ve üstü	21 ve üstü

Her platformda kendi jar'ını kullan; örneğin Velocity jar'ı Paper'da çalışmaz.
plugins/ klasöründe eklentinin yalnızca bir jar'ı olsun. Güncellerken eski jar'ı sil.
Kurulu sürümü panelde sunucu sayfasının Bağlantı kartındaki Eklenti satırında, en yeni sürümü Ayarlar → Güncellemeler sayfasında görürsün.

Sunucuyu taşırken#

Eklenti klasörünün tamamını (plugins/BorCubeConnect/, Velocity'de plugins/borcubeconnect/) yeni sunucuya taşı:

config.yml: adres, token ve izin listesi.
executed.txt: çalıştırılmış komutların listesi. Silinirse onayı yolda kalmış bir komut ikinci kez çalışabilir.
bazaar.key ve bazaar-pending/: pazar kullanıyorsan. Anahtar kaybolursa depodaki eşyalar bu sunucuda çekilemez.

Hâlâ çözemediysen#

Konsoldaki BorCube Connect uyarılarını ve /borcube status çıktısını kaydet. Destek almadan önce Sık karşılaşılan sorunlar ve Günlükler ve destek sayfalarına bak.

ÖncekiOylama sayfası Sonraki Tema seçmek ve değiştirmek

Bir yanlış ya da eksik mi gördün? Discord’dan haber ver, hemen düzeltelim.