İçeriğe geç

Sıralamalar ve ceza geçmişi

Oyun eklentilerinin MySQL tablolarından sıralama sekmeleri ve LiteBans / AdvancedBan ceza kayıtlarını sitede göstermek.

Sıralamalar ve ceza geçmişi, oyun eklentilerinin veritabanından okur ve sitede gösterir. BorCube bu tablolara yalnızca okumak için bağlanır, hiçbir şey yazmaz. İki özellik de Ultimate paketinde yer alır (fiyatlar).

Başlamadan önce#

  • Eklentinin verisi bir MySQL ya da MariaDB veritabanında olmalı ve site bu veritabanına ulaşabilmeli.
  • Ayarları kaydeden yetkilinin hesabında iki adımlı doğrulama (2FA) açık olmalı; bu ayarlar veritabanı şifresi saklar.
  • Yalnızca okuma yetkisi olan ayrı bir veritabanı kullanıcısı açman önerilir.
  • İki bölüm de başlangıçta kapalıdır. Yönetim paneli → Ayarlar → Site bölümleri sayfasından Sıralamalar ve Cezalar'ı aç. Kapalıyken yetkililer sayfaları önizleme için yine görebilir.

Sıralamalar#

Her sıralama, bir oyun eklentisinin tablosundaki en iyi oyuncuları gösteren bir sekmedir (öldürme, oyun süresi, para gibi).

  1. Yönetim paneli → Topluluk → Sıralamalar sayfasında Yeni sıralama'ya bas.
  2. Ad (sekme) ve Adres yaz. Adres boşsa addan üretilir; sekme /siralamalar/<adres> adresinde açılır.
  3. Veri kaynağı bölümünde Site ile aynı veritabanı ya da Başka bir MySQL sunucusu seç. İkincisinde Sunucu, Port, Veritabanı, Kullanıcı ve Şifre gir.
  4. Tablo, Oyuncu adı sütunu ve Sıralama sütunu alanlarını doldur.
  5. Gösterilecek oyuncu sayısını seç (5–100, varsayılan 25). Küçük değer daha iyiyse (ör. en kısa süre) Küçükten büyüğe sırala'yı aç.
  6. Sütunlar bölümünde tabloda gösterilecek değerleri ekle (en çok 8). Her sütun için tablodaki sütun adını, bir başlık ve bir biçim seç.
  7. Bağlantıyı test et ile ilk 5 satırı gör, sonra Kaydet'e bas. Sitede göster açık olmalı.

Sütun biçimleri:

BiçimÖrnek gösterim
Sayı1.250
MetinDeğer olduğu gibi
Süre (saniye)3 sa 12 dk
Süre (dakika)2 g 4 sa
Süre (tick, 20/sn)Tick'i süreye çevirir (20 tick = 1 sn)
Tarih11.10.2026

Kurallar:

  • Tablo ve sütun adları yalnızca harf, rakam ve _ içerebilir.
  • Adı şifre, özet, e-posta, IP ya da token gibi gizli veri çağrıştıran sütunlar (password, email, ip gibi) herkese açık sayfada kullanılamaz.
  • Site ile aynı veritabanını seçtiysen BorCube'un kendi tabloları sıralamada kullanılamaz.
  • Oyuncu adı ya da sıralama değeri boş olan satırlar listeye girmez.

Sitede oyuncular sekmeler arasında geçer ve kendi adını aratıp sırasını öğrenebilir. Temalar ilk oyuncuları bir podyumda gösterebilir; podyumda ilk sütunun değeri görünür. Veriler bir dakika saklanır; tablo her ziyarette yeniden sorgulanmaz.

Ceza geçmişi#

Ceza geçmişi LiteBans ya da AdvancedBan kayıtlarını /cezalar sayfasında gösterir.

  1. Yönetim paneli → Ayarlar → Cezalar sayfasını aç.
  2. Eklenti alanında LiteBans ya da AdvancedBan seç.
    • LiteBans: Tablo öneki'ni LiteBans config.yml dosyasındaki table_prefix ile aynı yap (varsayılan litebans_).
    • AdvancedBan: Eklenti MySQL kullanmalı (config.yml içinde MySQL.Use: true). Varsayılan HSQLDB dosyası okunamaz. Okunan tablolar PunishmentHistory ve Punishments.
  3. Cezayı veren yetkiliyi göster (varsayılan açık) ve LiteBans için Sessiz (-s) cezaları da göster (varsayılan kapalı) seçeneklerini ayarla.
  4. Veritabanı alanında BorCube ile aynı veritabanı ya da Ayrı bir MySQL/MariaDB veritabanı seç ve bağlantı bilgilerini gir.
  5. Kaydet'e bas, ardından Bağlantıyı test et ile dene.

Sitede neler görünür:

  • Dört sekme: Yasaklamalar, Susturmalar, Uyarılar, Atılmalar.
  • Her kayıtta oyuncu, sebep, yetkili (gösterilmesini seçtiysen), tarih, bitiş (ya da Kalıcı) ve durum: Aktif, Süresi doldu ya da Kaldırıldı.
  • Oyuncu adına göre arama ve sayfa başına 20 kayıt.

Sorun olursa#

  • Bağlantıyı test et bir hata gösteriyorsa sunucu adresini, portu, kullanıcı adını, şifreyi ve tablo adını kontrol et.
  • Ayrı bir veritabanı sunucusu kullanıyorsan, veritabanının site sunucusundan gelen bağlantıya izin verdiğinden emin ol.
  • Sitede "Ceza kayıtları şu an yüklenemedi" görünüyorsa ayarlardaki bağlantıyı yeniden test et.

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