AserPermissions (AserCore), AserLand sunucusunun temel oyuncu verilerini yöneten kapsamlı bir yetkilendirme ve senkronizasyon eklentisidir. Oyuncular kayıt olabilir, giriş yapabilir, hesaplarını Discord ile eşleştirebilir ve oyun içi tüm istatistiklerini web sitesiyle anlık olarak senkronize edebilirler.
| Özellik | Açıklama |
|---|---|
| Auth Sistemi | /register ve /login ile güvenli oyuncu kimlik doğrulaması |
| WebSync Mekanizması | Kills, Deaths, Playtime, Balance, Towny ve AserPass verilerini anlık senkronizasyon |
| Discord Entegrasyonu | Oyun içi hesabı Discord sunucusuyla /bagla komutuyla eşleştirme |
| Scoreboard (Çift Sayfa) | Kişisel Bilgiler ve Kasaba Bilgileri arasında otomatik geçiş yapan tablo |
| Canlı Tablist | Animasyonlu, PlaceholderAPI destekli oyuncu listesi yönetimi |
| Ekonomi Altyapısı | Vault destekli bakiye görüntüleme ve transfer (money, pay) işlemleri |
| Temel Yönetim | Spawn, warp ayarlama, gamemode, heal ve fly kontrol sistemleri |
| Otomatik Yeniden Başlatma | /restarttimer ile güvenli geri sayımlı sunucu kapama |
| SQLite / MySQL | HikariCP destekli asenkron yüksek performanslı veritabanı |
| Tamamen Özelleştirilebilir | config.yml üzerinden tüm bağlantılar ve arayüzler yönetilebilir |
| Plugin | Amaç |
|---|---|
| Vault | Ekonomi entegrasyonu (para çekme/yatırma ve bakiye) |
| PlaceholderAPI | Scoreboard ve Tablist üzerindeki değişkenlerin yönetimi |
| AserPass | Oyuncunun seviye, xp ve pass durumunun entegre edilmesi |
| Plugin | Amaç |
|---|---|
| Towny | Kasaba/ulus bilgileri senkronizasyonu ve scoreboard yansıması |
AserPermissions.jar dosyasını plugins/ klasörüne kopyalayın.config.yml dosyasını oluşturacaktır.config.yml dosyasını sunucunuzun MySQL bilgilerine göre düzenleyin.| Komut | Açıklama |
|---|---|
/register <şifre> <şifre> | Sunucuya kayıt olur |
/login <şifre> | Kayıtlı hesaba giriş yapar |
/bagla | Discord hesabı ile oyunu bağlamak için kod üretir |
/money veya /bal | Mevcut bakiyenizi gösterir |
/pay <oyuncu> <miktar> | Belirtilen oyuncuya belirtilen miktarda para gönderir |
/spawn | Başlangıç noktasına döner |
/warp <isim> | Belirlenmiş warpa ışınlar |
| Komut | Açıklama | Yetki |
|---|---|---|
/eco <give|take|set> <oyuncu> <miktar> | Oyuncunun parasını yönetir | aserperms.admin |
/gamemode <mod> (gmc, gms vb.) | Oyun modunu değiştirir | aserperms.admin |
/setspawn | Spawn noktasını belirler | aserperms.admin |
/setwarp <isim> / /delwarp <isim> | Warp oluşturur / siler | aserperms.admin |
/restarttimer | Geri sayımlı restart başlatır | aserperms.admin |
Kayıt veya giriş yapmayan oyuncuların hareket etmesi, sohbeti kullanması ve komut girmesi otomatik olarak engellenmektedir.
Oyuncuların sunucu içi istatistikleri, çıkış yaptıklarında asenkron olarak MySQL veritabanına aktarılır.
| Veri Türü | Açıklama | Kaynak API |
|---|---|---|
| ⚔️ Kills / Deaths | Oyuncunun öldürme ve ölme sayıları | Bukkit Statistic API |
| ⏱️ Playtime (Saat) | Oyuncunun toplam oynama süresi | Bukkit Statistic API |
| 💰 Balance (Bakiye) | Mevcut parası | Vault Economy API |
| 🏰 Towny Bilgileri | Kasaba ve Ulus isimleri | Towny API |
| ⭐ AserPass Bilgileri | Seviye, XP, Pass Türü ve Açılmış Etiketler | AserPass Hook |
Kullanıcıların hesap güvenliği için uygulanan giriş akış sistemi:
Oyuncu şifreleri veritabanında kesinlikle düz metin (plain-text) olarak saklanmaz, güvenlik standartlarına uygun şekilde hashlenir.
AserLand web sitesi ve Discord sunucusu arasındaki eşleşmeyi sağlamak için oluşturulan köprü sistemi.
/bagla yazarAserPermissions, Vault destekli bir iç ekonomi motoruna sahiptir.
/pay komutu ile sıfır komisyonlu gecikmesiz transferler yapılır.aserperms.admin) sahip kullanıcılar, /eco komutu aracılığıyla ekonomiyi şekillendirebilir.Scoreboard, her 10 saniyede bir otomatik olarak iki farklı sayfa arasında geçiş yapar (FastBoard API kullanılır):
| Sayfa Adı | İçerilen Veriler |
|---|---|
| Sayfa 1 (Kişisel & AserPass) | Oyuncu Adı, Bakiye, AserPass Üyeliği, Seviyesi, XP |
| Sayfa 2 (Kasaba & Ulus) | Towny Kasaba Adı, Kasaba Hazinesi, Ulus Adı, Ulus Hazinesi |
config.yml üzerinden tamamen değiştirilebilen ve her 100 tickte güncellenen oyuncu listesi:
| Bölüm | Değişkenler |
|---|---|
| Header (Üst Kısım) | Sunucu Başlığı, Slogan, Web Sitesi |
| Footer (Alt Kısım) | Ping, Aktif Oyuncu, Bakiye, Sunucu İsmi |
Eklenti veritabanı işlemleri için HikariCP bağlantı havuzu kullanır. Bu sayede sunucu ana iş parçacığı (main thread) kilitlenmeden arka planda asenkron kayıt işlemleri yapılır.
players_auth — Oyuncuların giriş, kayıt ve şifre (hash) verileri.players_stats — Kills, deaths, playtime, balance, towny bilgileri.players_pass — AserPass seviyesi, XP ve açılmış etiketler.Sistem, senkronizasyonların her PlayerQuitEvent (çıkış) anında çalışmasını garanti altına alır.
Ayrıca oyuncu ilk girdiğinde PlayerJoinEvent esnasında scoreboard ve tablist aktif edilir.
Ana yapılandırma dosyası üç ana bölümden oluşur:
mysql:
host: "veritabani_ip_adresi"
port: 3306
database: "veritabani_adi"
username: "kullanici_adi"
password: "sifreniz"
scoreboard:
enabled: true
title: '&6&lAserTowny'
update_ticks: 20
switch_interval: 10
pages: [...]
tablist:
update-interval: 100
player-format: '{prefix}{player}'
header: [...]
footer: [...]
| İzin | Açıklama | Varsayılan |
|---|---|---|
aserperms.admin | Setspawn, setwarp, delwarp, eco, restarttimer gibi yetkili komutlarına erişim | OP |
Standart oyuncu komutları (login, register, bagla, money, pay, spawn, warp vb.) herhangi bir özel izin gerektirmez.
S: Kayıt olmadan oynayabilir miyim?
C: Hayır, sunucuya giren her oyuncu hareket edebilmek ve sohbet edebilmek için /register veya /login komutunu kullanmalıdır.
S: Şifreler veritabanında güvende mi?
C: Evet, hiçbir şifre düz metin (plain text) olarak kaydedilmez. Özel hash algoritmaları ile şifrelenir.
S: Web sayfasında istatistiklerim neden anında güncellenmiyor?
C: Veritabanı yoğunluğunu engellemek için, oyuncu verileri (WebSync) oyuncu sunucudan çıkış yaptığında (Quit) veritabanına işlenir.
AserPermissions (AserCore) — AserLand Altyapısının Ana Kalbi.
© 2026 AserLand — www.aserland.com