> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# ajLeaderboards

> Minecraft ajLeaderboards veritabanını bağlayın; sezon sıralamalarını ve isteğe bağlı Sezon Biletini yapılandırın.

ajLeaderboards, Minecraft sunucunuzdaki PlaceholderAPI verilerini (öldürme, bakiye, ada seviyesi veya özel etkinlik puanları) toplayıp MySQL veritabanına kaydeden bir sıralama eklentisidir.

Bu rehberde ajLeaderboards veritabanının Zonely paneline nasıl bağlanacağını, canlı sezon sıralamalarının nasıl oluşturulacağını ve isteğe bağlı olarak **Sezon Bileti** ilerlemesine nasıl dönüştürüleceğini bulabilirsiniz.

## Eklentiyi kurun ve sıralama ekleyin

Sunucunuza [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) ve [ajLeaderboards](https://www.spigotmc.org/resources/ajleaderboards.85548/) eklentilerini kurun.

Sıralamaya dahil etmek istediğiniz istatistiği belirleyin ve oyun içinden veya sunucu konsolundan sıralamayı ekleyin:

```bash title="Sunucu konsolu" theme={"theme":"css-variables"}
# Oyuncu öldürme sıralaması ekleme örneği:
ajlb add kills %statistic_player_kills%

# Bakiye veya özel puan sıralaması ekleme örneği:
ajlb add points %playerpoints_points%
```

Sıralama eklendikten sonra eklenti verileri toplamaya başlar.

## MySQL ayarlarını yapılandırın

Web panelinin sıralamaları okuyabilmesi için ajLeaderboards verilerini MySQL'e kaydetmelidir. Sunucuyu durdurun ve **plugins/ajLeaderboards/config.yml** dosyasını açın.

Zonely panelinde **Ayarlar → Veritabanı** bölümünden veritabanı bağlantı bilgilerinizi alarak yapılandırmayı güncelleyin:

```yaml title="plugins/ajLeaderboards/config.yml" theme={"theme":"css-variables"}
mysql:
  enabled: true
  host: 'VERITABANI_ADRESI'
  port: 3306
  database: 'VERITABANI_ADI'
  username: 'VERITABANI_KULLANICISI'
  password: 'VERITABANI_SIFRESI'
  table_prefix: 'ajlb_'
  update_interval: 60
```

**table\_prefix**, tabloların karışmaması için `ajlb_` olarak belirlenir. **update\_interval** ise verilerin kaç saniyede bir veritabanına aktarılacağını belirler (önerilen: 60 saniye). Dosyayı kaydedin ve sunucuyu yeniden başlatın.

## Sezon veri bağlantısını kurun

Yönetim panelinde **Çeşitli → Sezonlar** bölümünü açın. Yeni sezon oluşturmak için **Sezon Ekle** düğmesine basın veya mevcut bir sezonu düzenleyin.

**Veri Bağlantısı** sekmesinde ajLeaderboards MySQL tablosunu ve gerekli sütunları eşleştirin:

[![MySQL Tablosu, Kullanıcı ve sıralama](https://mintcdn.com/zonely-a8cd49e7/fYktJ_8IwtEKWD7v/images/panel/participation-seasons-guide-20261025/s02-veri-baglantisi.png?fit=max\&auto=format\&n=fYktJ_8IwtEKWD7v\&q=85\&s=3b944f165f96110a762aa11c52963ee3)](https://docs.zonely.gen.tr/images/panel/participation-seasons-guide-20261025/s02-veri-baglantisi.png)

> [card] 1. MySQL Tablosu
>
> ajLeaderboards tarafından oluşturulan sıralama tablosunu seçin.

> [card] 2. Kullanıcı ve sıralama
>
> Kullanıcı adı sütununu ve sıralama puanını eşleştirin.

| Panel Alanı | Karşılığı |
| - | - |
| MySQL Tablosu | ajLeaderboards tablosu (örneğin `ajlb_data` veya `ajlb_kills`). |
| Kullanıcı Adı Sütunu | Oyuncunun adını tutan sütun (`player` veya `player_name`). |
| Sıralama Sütunu | Sıralamayı belirleyen sayısal puan sütunu (`value` veya `score`). |
| Tarih Sütunu | Eklenti anlık toplam tutuyorsa `Kullanılmasın` seçin. |

Kullanıcı adlarının sitedeki kullanıcı hesaplarıyla eşleştiğinden emin olun.

## İsteğe bağlı: Sezon Bileti yapılandırması

Sezon Bileti (Season Pass), oyuncuların ajLeaderboards üzerinden kazandığı puanlarla seviye atlayıp ödül alabildiği isteğe bağlı bir özelliktir. Yalnızca sıralama listesi göstermek istiyorsanız bu adımı atlayabilirsiniz.

Sezon Bileti'ni etkinleştirmek için:

1. Sezon düzenleme ekranında **Sezon Bileti** sekmesini açın.
2. **Sezon Biletini Etkinleştir** seçeneğini açık konuma getirin.
3. **İlerleme İstatistiği** olarak ajLeaderboards'tan bağladığınız sıralama sütununu seçin.
4. **Seviye Ekle** düğmesiyle puan hedeflerini (örneğin 50, 100, 250 puan) ve kazanılacak ödülleri (kredi, kasa anahtarı veya sunucu teslimat komutları) tanımlayın.

Oyuncular Minecraft'ta ajLeaderboards tarafından takip edilen eylemleri gerçekleştirdikçe puanları artar, sitedeki Sezon Bileti çubukları dolar ve hak ettikleri ödülleri kullanıcı profilinden teslim alabilirler.

## Kontrol ve sorun giderme

* **Puanlar güncellenmiyor:** `config.yml` içindeki `update_interval` süresini ve MySQL bağlantı durumunu kontrol edin. Eklentinin veritabanına yazma yetkisi olmalıdır.
* **Kullanıcı bulunamadı:** Sunucunuzda AuthMe veya nLogin kullanılıyorsa, oyundaki kullanıcı adı ile sitedeki hesap adının birebir eşleştiğinden emin olun.
* **Sıralama boş görünüyor:** `ajlb_` tablolarında veri olup olmadığını kontrol edin; oyuncular sunucuya girip istatistik oluşturana kadar tablo boş kalabilir.

[Sezon rehberi](https://docs.zonely.gen.tr/guides/seasons.md) · [Sezon Bileti ayarları](https://docs.zonely.gen.tr/guides/season-tickets.md) · [Veritabanı yönetimi](https://docs.zonely.gen.tr/guides/database.md) · [Bağlantılar ve araçlar](https://docs.zonely.gen.tr/integrations/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.