Genel bakış

Onay bekliyor v1.3.0

Platformlar

Paper, Spigot, Folia

Minecraft

1.21 ve üzeri

Java

21

Gerekli

Yok

İsteğe bağlı

Vault, PlaceholderAPI, HeadDB

ReferralTrack, sunucunuza her oyuncuyu hangi sunucu listesinin, videonun, Discord davetinin veya arkadaşın getirdiğini gösterir. Oyuncular sunucuya nereden geldiklerini /referral ile bildirir veya bir arkadaşının kalıcı davet kodunu girer ve bunun için ödül kazanabilir. Her şey kendi veritabanınızda saklanır (SQLite veya MySQL/MariaDB). Yapılandırdığınız Discord webhook'u dışında sunucudan hiçbir şey çıkmaz.

Gereksinimler #

• Minecraft 1.21 veya daha yenisi, Java 21.
• Paper, Spigot veya Folia.
• Vault ve Vault uyumlu bir ekonomi eklentisi isteğe bağlıdır ve yalnızca para ödülleri için gerekir.
• PlaceholderAPI isteğe bağlıdır.
• HeadDB ve Head Database isteğe bağlıdır ve menülere özel kafalar ekler. Bunlar olmadan normal bir Bukkit materyali kullanılır.

Veritabanı kütüphaneleri jar'ın içindedir; bu yüzden ilk başlatmada hiçbir şey indirilmez.

Kurulum #

1. ReferralTrack.jar dosyasını plugins/ klasörüne koyun ve sunucuyu başlatın.
2. plugins/ReferralTrack/config.yml dosyasını düzenleyin: kaynaklarınız, ödülleriniz ve Discord webhook'u.
3. /referraltrack validate, ardından /referraltrack reload çalıştırın.
4. Veritabanını, ödülleri ve entegrasyonları denetlemek için /referraltrack doctor çalıştırın.

Ne yapar #

• Kaynak kodları. Oyuncular /referral youtube (veya tanımladığınız herhangi bir kod) yazar. yotube gibi yanlış yazılmış bilinen bir kod, en yakın olanla eşleştirilir.
• Kalıcı kişisel kodlar. Her oyuncu, UUID'sine bağlı, çakışmaya karşı güvenli bir davet kodu alır (örneğin RT-AB12CD3); bu yüzden ad değişikliğinden etkilenmez. Arkadaş adları ve kaynak kodları çalışmaya devam eder.
• Ödüller. Vault üzerinden para ve/veya konsol komutları; IP adresi başına sınır, arkadaş davetlerinde aynı IP denetimi, ödül üst sınırları ve davet kilometre taşları ile.
• Doğrulanmış davetler (isteğe bağlı). Ödüller ve liderlik tablosu puanı, yeni oyuncu bir oynama süresi ve giriş sayısı eşiğine ulaşana kadar bekletilebilir. Varsayılan olarak kapalıdır.
• Hile incelemesi (isteğe bağlı). Açıklanabilir risk sinyalleri, yetkililerin onaylaması veya reddetmesi için bir daveti bekletebilir.
• Kampanyalar (isteğe bağlı). Kendi tarihleri, kodları, çarpanları, ödülleri ve kilometre taşları olan süreli kampanyalar.
• Oyuncu merkezi. /referral, oyuncunun kodunu, kaynağını, doğrulama durumunu ve ödüllerini içeren kişisel bir menü açar. Destekleyen sunucularda merkez yerel bir Java diyaloğu olarak açılabilir.
• Yetkili araçları. Panel, analitik, büyüme sıralaması, Reward Rescue, yapılandırma doğrulama ve bir sağlık raporu.
• Discord. Anlık kartlar, günlük ve haftalık raporlar ve canlı istatistik mesajı; her biri kendi kanalına yönlendirilebilir.
• Ön ayarlar ve temalar. Yedi başlangıç ön ayarı ve üç görsel tema; yalnızca onay ve yedekle uygulanır.
• Diller. İngilizce, Türkçe, İspanyolca, Almanca ve Brezilya Portekizcesi.

Ağlar #

Bir ağda settings.join-tracking-enabled değerini bir giriş sunucusunda (örneğin lobi) true, diğerlerinde false yapın ve her sunucuyu aynı MySQL/MariaDB veritabanına yönlendirin. settings.reward-delivery-enabled değerini yalnızca gerçek ekonominizin bulunduğu sunucuda true yapın. Başka yerlerde talep edilen ödüller bekleyen olarak saklanır ve oradaki bir sonraki girişte teslim edilir. Her ödül satırının sunucular arasında tek bir etkin teslimat sahibi vardır.

BungeeCord veya Velocity arkasında proxy'de IP yönlendirmeyi etkinleştirin. Bu olmadan her oyuncu proxy'nin adresini gösterir ve IP başına denetimler herkesi engellerdi. SQLite paylaşılan bir depolama değildir; bir ağ MySQL/MariaDB gerektirir.

Yükseltme #

ReferralTrack özelleştirilmiş bir config.yml dosyasının üzerine asla sessizce yazmaz. Yapılandırma sürümü değiştiğinde özgün dosyayı config.yml.bak-v<old> olarak saklar, tam yeni başvuruyu config.new-v<new>.yml dosyasına yazar, dosyanızda yalnızca sürüm işaretini değiştirir ve açılışta eksik yolları listeler. Paketle gelen varsayılanlar, siz onları kopyalayana kadar yeni seçeneklerin çalışmasını sağlar. Düzenlediğiniz dil dosyalarının üzerine yazılmaz; eksik anahtarlar paketle gelen İngilizce metne geri döner.