AserPass v1.0

📑 İçindekiler

1. Genel Bakış
2. Kurulum ve Gereksinimler
3. Komut Referansı
4. Görev Sistemi (Trackers)
5. Görev Kategorileri
6. Sezon ve Seviye Sistemi
7. Ödül Sistemi (Free & Premium)
8. Ünvan (Tag) Sistemi
9. Yapılandırma Dosyası
10. İzin Düğümleri (Permissions)
11. Sık Sorulan Sorular (SSS)

🌍 Genel Bakış

AserPass, AserLand sunucusu için özel olarak geliştirilmiş, oyunculara çeşitli görevler sunarak oyun içi etkileşimi en üst düzeye çıkaran kapsamlı bir BattlePass sistemidir. Gelişmiş görev izleme (tracker) altyapısı sayesinde oyuncuların yaptığı eylemleri takip eder, XP kazandırır ve Seviye (Tier) atlatarak hem ücretsiz hem de premium ödüller kazanmalarını sağlar.

Temel Özellikler

📦 Kurulum ve Gereksinimler

Opsiyonel Bağımlılıklar

Kurulum Adımları

1. AserPass.jar dosyasını plugins/ klasörüne kopyalayın.
2. Sunucuyu başlatın. Eklenti otomatik olarak config.yml dosyasını oluşturacaktır.
3. config.yml dosyasını sunucunuzun ekonomisine ve dengesine göre düzenleyin.
4. Eklenti tam olarak yüklendiğinde /bp komutuyla menüleri test edin.

📜 Komut Referansı

Oyuncu Komutları

Admin Komutları

🎯 Görev Sistemi (Trackers)

AserPass, oyuncuların etkinliklerini takip edebilmek için 14 farklı görev tipini (Tracker) destekler.

📋 Görev Kategorileri

1. Günlük Görevler (Daily)

• Süre: 24 Saat
• Zorluk: Kolay - Orta
• Görev Sayısı: 25 farklı seçenek
• Ödül: Ortalama XP (Örn. 100 - 350 XP)
• Açıklama: Oyuncuların her gün düzenli olarak girip tamamlayabileceği temel oyun içi eylemlerden oluşur (örn. ekin hasat etmek, fırın kullanmak, ağaç kesmek).

2. Haftalık Görevler (Weekly)

• Süre: 7 Gün
• Zorluk: Zor - Destansı
• Görev Sayısı: 15 farklı seçenek
• Ödül: Yüksek XP (Örn. 2500 - 5000 XP)
• Açıklama: Ciddi efor ve zaman gerektiren büyük çaplı görevlerdir. Yüzlerce blok kazma, zorlu moblar öldürme veya büyük projeleri içerir.

3. Rutin (Sürekli) Görevler (Continuous)

• Süre: Günde belirli sayıda tekrar hakkı (max_repeat)
• Zorluk: Çok Kolay
• Görev Sayısı: 20 farklı seçenek
• Ödül: Düşük XP (Örn. 20 - 50 XP)
• Açıklama: Sürekli olarak kırıktaş kazma, odun kesme gibi arka planda doğal olarak ilerleyen görevlerdir. Her görevin max_repeat limiti vardır.

🏆 Sezon ve Seviye Sistemi

AserPass'te kazanılan XP'ler, oyuncunun seviye (Tier) atlamasını sağlar. Her seviye atlandığında yeni ödüllerin kilidi açılır.

Sezon Yapılandırması

• Mevcut Sezon: config.yml içinden season.current_id ve season.name ile ayarlanır.
• Seviye Başına XP: Varsayılan olarak her seviye için 1000 XP gereklidir.

🎁 Ödül Sistemi (Free & Premium)

Ödüller, oyuncunun seviyesine göre 1 ile 100 seviye arasında dağıtılmıştır. Her seviyede alınabilecek iki tür ödül havuzu vardır.

Ödül Formatları

📛 Ünvan (Tag) Sistemi

AserPass, bünyesinde oyuncuların ünvanlarını (Tag) rahatça seçebilecekleri bir modül barındırır. Oyuncular görevlerden veya BattlePass seviyelerinden kazandıkları ünvanları özel menüden seçip kuşanabilirler.

• Menü Erişimi: /unvan veya /title
• İşlev: Kazanılan ünvanı sohbette (chat) veya isim etiketinde göstermek. (Tam stabilite için AserPermissions entegrasyonu gereklidir).

⚙️ Yapılandırma Dosyası

config.yml - Temel Yapı

# ==========================================

#        ASERPASS - CONFIGURATION

# ==========================================

prefix: "&6[AserPass] &f"

premium_commands:


    
"/tfly"
    
"/townyfly"


season:

current_id: 1

name: "&c&l1. Sezon: Parçalanmış Taç"

xp_per_level: 1000

quests:

daily: ...

weekly: ...

continuous: ...

rewards:

1:

free:


    
"NAME:&f16x Demir Külçesi"
    
"ITEM:IRON_INGOT:16"


premium:


    
"NAME:&616x Altın Külçesi"
    
"ITEM:GOLD_INGOT:16"

🔐 İzin Düğümleri (Permissions)

❓ Sık Sorulan Sorular (SSS)

S: Bir oyuncu Premium Pass aldığında önceki seviyelerdeki premium ödülleri alabilir mi?

C: Evet. Oyuncu örneğin Seviye 50'deyken Premium Pass alırsa, 1'den 50'ye kadar olan tüm premium ödülleri geriye dönük olarak toplayabilir.

S: Rutin görevler ne zaman sıfırlanır?

C: continuous (Rutin) görevler her oyuncu için max_repeat (örn. 10 kere) sınırına ulaştığında kilitlenir ve belirlenen süre (genelde ertesi gün) dolduğunda yeniden açılır.

S: Yeni bir sezona geçerken XP ve seviyeler sıfırlanır mı?

C: Evet. config.yml üzerinden sezon kimliği (current_id) değiştirildiğinde, AserPass sistemi yeni bir sezona başlandığını algılar ve tüm oyuncuların mevcut sezon verilerini (Seviye ve XP) sıfırdan başlatır.

S: /unvan menüsünden ünvan seçilmiyor, ne yapmalıyım?

C: Ünvan sisteminin oyun içi chate tam olarak yansıması için AserPermissions eklentisinin sunucuda aktif ve güncel olduğundan emin olun.