BorCube Connect kurulumu

Minecraft eklentisini indirip sunucuna kurmak, panelde token oluşturmak ve bağlantıyı doğrulamak.

BorCube Connect, sitende satın alınan ürünlerin komutlarını Minecraft sunucuna teslim eden eklentidir. Kurulum dört adımdır: jar dosyasını sunucuna koy, panelde bir token oluştur, token'ı eklentinin ayar dosyasına yapıştır ve eklentiyi yeniden yükle.

Nasıl çalışır#

Eklenti siteye kendisi bağlanır. Bütün bağlantılar oyun sunucusundan siteye doğru gider, bu yüzden oyun sunucunda port açman gerekmez.

Eklenti siteyle sürekli açık bir bağlantı tutar. Yeni bir komut olduğunda site eklentiyi hemen uyarır.
Eklenti bekleyen komutları alır, sunucu konsolunda çalıştırır ve sonucu siteye bildirir.
Bu bağlantı koparsa eklenti siteyi belirli aralıklarla yoklamaya devam eder (varsayılan 30 saniye).

Token, panelin her oyun sunucusu için ürettiği gizli anahtardır. Eklenti siteye kendini bu anahtarla tanıtır; bir şifre gibi sakla.

Hangi dosyayı kuracağım#

Eklentiyi iki yerden indirebilirsin:

borcube.com → Hesabım → İndirmeler sayfasındaki BorCube Connect bölümü.
Yönetim paneli → Ayarlar → Güncellemeler sayfasındaki Eklentiyi indir düğmesi.

İnen zip dosyasında her platform için ayrı bir klasör vardır. Sunucuna uyan jar'ı seç:

Klasör	Dosya	Platform	Java
`bukkit/`	`BorCubeConnect-Bukkit-<sürüm>.jar`	Spigot, Paper, Purpur (1.8.8 ve üstü), Folia	8 ve üstü
`bungee/`	`BorCubeConnect-Bungee-<sürüm>.jar`	BungeeCord, Waterfall	8 ve üstü
`velocity/`	`BorCubeConnect-Velocity-<sürüm>.jar`	Velocity 3.4 ve üstü	21 ve üstü

Pazar menüsü ve PlaceholderAPI desteği yalnızca Spigot, Paper ve Folia sürümünde vardır.

1. Panelde sunucuyu ekle#

Yönetim paneli → Mağaza → Oyun sunucuları sayfasını aç.
Sağdaki Yeni sunucu formuna bir Ad yaz (örneğin "Survival"). Kısa ad boş kalırsa addan üretilir.
Aktif açık kalsın ve Kaydet'e bas.

Kaç sunucu ekleyebileceğin paketine bağlıdır: Sunucular ve oyun modları.

2. Token oluştur#

Listede sunucunun adına tıkla. Sunucunun bağlantı ve komut sayfası açılır.
Eklenti token'ı kartında Token oluştur'a bas.
Ekranda site-url ve token satırları görünür. Ayarları kopyala ile ikisini birden kopyala.

Token yalnızca bu anda gösterilir; site onun yalnızca özetini saklar. Kaybedersen Yeni token oluştur ile yenisini al. Yeni token oluşunca eskisi hemen geçersiz olur.

site-url değeri Ayarlar → Genel sayfasındaki Site adresi alanından gelir. Orası doğru değilse önce onu düzelt.

3. Eklentiyi kur ve ayarla#

Jar dosyasını sunucunun plugins/ klasörüne koy ve sunucuyu bir kez başlat.
Eklenti klasöründe config.yml oluşur: Spigot, Paper ve BungeeCord'da plugins/BorCubeConnect/, Velocity'de plugins/borcubeconnect/.
Kopyaladığın iki satırı dosyadaki site-url ve token satırlarının yerine yapıştır (örnek aşağıda).
Ürünlerinde kullandığın komutları allowed-commands listesine ekle. Listede olmayan komut çalışmaz: Ürün komutları ve güvenlik.
Konsola ya da oyuna /borcube reload yaz.

Yapıştırdıktan sonra iki satır şöyle görünür:

YAML

site-url: "https://siteadresin.com"
token: "bc_..."

config.yml ayarları#

Ayar	Varsayılan	Ne işe yarar
`site-url`	`https://example.com`	Sitenin adresi, `https://` ile
`token`	boş	Panelde oluşturduğun token (`bc_` ile başlar)
`poll-seconds`	`30`	Anlık bağlantı yokken siteyi kaç saniyede bir yoklasın (10–300)
`allowed-commands`	hazır liste	Çalışmasına izin verilen komutlar
`blocked-commands`	hazır liste	Hiçbir koşulda çalışmayacak komutlar
`allow-all-commands`	`false`	`true` olursa izin listesi kullanılmaz; önerilmez
`bazaar-enabled`	`true`	Pazar menüsü (yalnız Spigot, Paper, Folia)
`bazaar-blocked-items`	shulker kutuları, bundle	Pazara konamayacak eşyalar
`allow-http`	`false`	Yalnız yerel testte `https` olmayan adrese izin verir

Listelerde her maddeyi ayrı satıra, başına iki boşluk ve tire koyarak yaz ( - give). Pazar ayrıntıları için: Oyuncu pazarı.

Bağlandığını doğrula#

Panelde: Oyun sunucuları listesindeki Connect sütununda bağlı yazmalı. Eklenti son 90 saniyede siteyle konuşmadıysa bağlı değil, token yoksa token yok görünür. Sunucu sayfasındaki Bağlantı kartı son görülme zamanını, eklenti sürümünü, platformu ve çevrimiçi oyuncu sayısını gösterir.
Oyunda: /borcube status yaz. Durum: bağlı (anlık) ya da Durum: çalışıyor (yoklama) görmelisin.
Deneme komutu: Sunucu sayfasındaki Komut gönder kartına say BorCube bağlantısı çalışıyor yaz ve Kuyruğa ekle'ye bas. Mesaj birkaç saniye içinde oyun sohbetine düşer (Spigot, Paper ve Folia'da). Sayfayı yenilediğinde Komut geçmişi'nde komut teslim edildi olarak görünür.

Eklenti komutları#

Komut	Kim kullanır	Ne yapar
`/borcube status`	`borcube.admin` izni	Bağlantı durumu, son başarılı istek, son hata
`/borcube reload`	`borcube.admin` izni	`config.yml`'yi yeniden okur ve yeniden bağlanır
`/borcube poll`	`borcube.admin` izni	Siteyi hemen yoklar
`/dogrula <kod>`	Tüm oyuncular	Site hesabını oyun hesabına bağlar
`/pazar`	`borcube.bazaar` izni	Pazar deposunu açar (Spigot, Paper, Folia)

Spigot ve Paper'da borcube.admin varsayılan olarak OP'lerdedir; borcube.bazaar herkese açıktır. Konsol her komutu kullanabilir.

PlaceholderAPI#

Spigot, Paper veya Folia sunucunda PlaceholderAPI kuruluysa eklenti kendi yer tutucularını kaydeder; ayrı bir genişletme indirmen gerekmez.

Yer tutucu	Gösterdiği
`%borcube_credits%`	Oyuncunun sitedeki kredi bakiyesi
`%borcube_credits_full%`	Bakiye ve kredi adı birlikte
`%borcube_credits_raw%`	Bakiye, kuruş cinsinden (1250 = 12,50)
`%borcube_credit_name%`	Mağaza ayarlarındaki kredi adı
`%borcube_registered%`	Bu adla site hesabı varsa `yes`, yoksa `no`

Değerler dakikada bir yenilenir. İlk kullanımda birkaç saniye … görünebilir. Site hesabı olmayan oyuncunun bakiyesi 0 olur.

Eklentiyi güncellemek#

Yeni sürüm Yönetim paneli → Ayarlar → Güncellemeler sayfasında görünür. Eski jar'ı sil, yenisini plugins/ klasörüne koy ve sunucuyu yeniden başlat. config.yml korunur; eklenti bu dosyayı yalnızca yoksa oluşturur.

ÖncekiÖdeme sorunları Sonraki Ürün komutları ve güvenlik

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