Yapılandırma

Tüm ayarlar yorumlarıyla birlikte plugins/ReferralTrack/config.yml içindedir. Değişiklikleri /referraltrack reload ile uygulayın; veritabanı ayarlarındaki bir değişiklik yeniden başlatma gerektirir ve yeniden yükleme bunu size söyler. config-version değerini düzenlemeyin. Daha büyük düzenlemelerden sonra /referraltrack validate çalıştırın. Yapılandırma başvurusu daha yeni sistemleri anlatır (kampanyalar, hile, menüler, temalar, geri bildirim).

Dil #

language değeri en, tr, es, de ve pt_br kabul eder. Dosyalar plugins/ReferralTrack/lang içindedir; kendi dilinizi eklemek için birini kopyalayın. text-formatting, MiniMessage ve & renk kodlarını bağımsız olarak açıp kapatır.

Veritabanı #

yaml

database:
  type: SQLITE # or MYSQL
  sqlite:
    file: "data.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "referraltrack"
    username: "root"
    password: ""
    parameters: "?useSSL=false&autoReconnect=true&characterEncoding=utf8&serverTimezone=UTC"

SSL'siz MySQL 8 sunucuları için parameters içine &allowPublicKeyRetrieval=true eklemek gerekebilir. Bir pool bölümü bağlantı havuzu boyutunu ve zaman aşımlarını ayarlar. Kimlik bilgilerini gizli tutun.

Davet kuralları #

Anahtar	Varsayılan	Anlamı
`referral.allow-overwrite`	`false`	Bir oyuncunun daha önce verdiği daveti değiştirip değiştiremeyeceği.
`referral.max-code-length`	`32`	Kodlar harf, rakam, `.`, `_` ve `-` kullanır. `friend-invite` ve `no-source` ayrılmıştır.
`referral.max-custom-sources`	`200`	Kabul edilen serbest biçimli farklı kaynak sayısı. `0` sınırsızdır.
`referral.command-cooldown-seconds`	`3`	İki `/referral` denemesi arasındaki bekleme. `0` kapatır.
`referral.claim-window-hours`	`0`	`/referral` yalnızca ilk girişten sonra bu kadar süre çalışır. `0` sınır koymaz.
`referral.restrict-to-known-sources`	`false`	`true` yalnızca `known-sources` içindeki kodları kabul eder. `false` her kodu kabul eder ve düzenler.
`referral.known-sources`	youtube, tiktok, minecraft-server-list	Koddan görünen ada eşleme. Her kanal veya içerik üreticisi için bir satır ekleyin.
`referral.fuzzy-match-max-distance`	`2`	Bilinen kodlar için yazım hatası toleransı. `0` kapatır.
`referral.ignore-private-addresses`	`true`	Yerel ve özel adresler alternatif hesap denetimlerinde yok sayılır.
`referral.personal-codes.enabled`	`true`	Her oyuncu kalıcı bir davet kodu alır.
`referral.personal-codes.prefix`	`RT-`	Üretilen kodların öneki.
`referral.personal-codes.random-length`	`7`	Rastgele kısmın uzunluğu.
`referral.personal-codes.leaderboard-size`	`10`	`/referral top` ile gösterilen oyuncu sayısı.
`referral.personal-codes.leaderboard-period-days`	`30`	Sıralama dönemi. `0` tüm zamanlar demektir.
`referral.validation.enabled`	`false`	Yeni oyuncu aşağıdaki iki eşiğe de ulaşana kadar ödülleri ve liderlik tablosu puanını bekletir. Mevcut davetler doğrulanmış kalır; yalnızca yeni talepler bekletilir.
`referral.validation.required-playtime-minutes`	`30`	Talepten sonraki oynama süresi.
`referral.validation.required-joins`	`2`	Giriş sayısı.
`referral.validation.check-interval-seconds`	`30`	Bekleyen davetlerin ne sıklıkla denetlendiği.
`referral.retention.active-window-days`	`3`	Geri dönen bir oyuncunun elde tutulmuş sayılması için davetten sonraki gün sayısı.

Ödüller #

yaml

referral:
  rewards:
    enabled: true
    money: 100.0
    commands:
      - "give %player% diamond 2"
    max-claims-per-ip: 3
  friend-invite:
    enabled: true
    reward-money: 100.0
    max-rewards-per-player: 10
    block-same-ip: true
    milestones:
      5:
        money: 250.0
        commands:
          - "give %player% diamond 5"

Para yalnızca Vault kuruluysa ödenir. Komutlar konsoldan çalışır; %player% oyuncunun adıdır.
max-claims-per-ip, aynı IP'ye zaten bu kadar karşılama ödülü gittiğinde yeni bir hesabın talep etmesini engeller. Birkaç gerçek oyuncu aynı ağı paylaşıyorsa artırın. 0 sınırsızdır.
milestones, davet edilen arkadaş sayısına göre anahtarlanır ve her biri oyuncu başına yalnızca bir kez ödenir.
Gösterilen değerler pakete dahil örneklerdir; sunucunuza uygun ödüller belirleyin.

Discord #

yaml

discord:
  enabled: true
  webhook-url: ""
  server-name: "Your Server"

Discord özellikleri bir webhook URL'si yapıştırana kadar kapalı kalır. Anlık bildirimler, günlük rapor (varsayılan 00:00), haftalık rapor (varsayılan Pazartesi 00:05) ve canlı istatistik mesajı (varsayılan olarak kapalı) ayrı ayrı açılıp kapatılabilir. webhooks bölümü kartları, raporları ve canlı paneli ayrı kanallara yönlendirir; branding ve embed görünümü değiştirir. /referraltrack discord preview <type> her tasarımı test verisi olmadan gösterir.

Genel ayarlar #

Anahtar	Varsayılan	Anlamı
`settings.join-tracking-enabled`	`true`	`false` bu sunucunun yeni oyuncuları kaydetmesini durdurur. Genel bakış sayfasındaki Ağlar bölümüne bakın.
`settings.reward-delivery-enabled`	`true`	`false` ödülleri burada teslim etmek yerine bekleyen olarak saklar.
`settings.ignored-players`	boş	Tüm istatistiklerin dışında tutulan adlar. `referraltrack.ignore` izni de aynısını yapar.
`settings.data-retention.ip-hash-days`	`90`	Bu kadar süredir olmayan oyuncuların saklanan IP karmaları silinir. `0` sonsuza dek saklar.
`settings.data-retention.delivered-rewards-days`	`0`	Bundan eski teslim edilmiş ödül satırları silinir. Bu, bunlardan sayılan IP başına ve arkadaş başına sınırları da sıfırlar.
`settings.seed-known-players`	`true`	İlk başlangıçta sunucunun zaten tanıdığı oyuncuları içe aktarır; böylece `/referral <friend>` onlar için çalışır.

Güncelleme denetimi #

integrations.update-checker, resource-id gerçek bir kaynak numarasına ayarlanana kadar hiçbir şey yapmaz.