📑 İçindekiler
- Genel Bakış
- Kurulum ve Gereksinimler
- Komut Referansı
- Asker Sınıfları ve Tier Sistemi
- Barınma (Housing) Sistemi
- Kışla (Barracks) Sistemi
- Savaş Mekanikleri
- Antlaşma ve Diplomasi Sistemi
- Ekonomi ve Maaş Sistemi
- GUI Menüleri
- API ve Etkinlikler (Events)
- Yapılandırma Dosyaları
- İzin Düğümleri (Permissions)
- Sık Sorulan Sorular (SSS)
🌍 Genel Bakış
AserWar Towny Legions, Towny kasaba sistemine entegre edilmiş kapsamlı bir NPC ordusuna dayalı savaş eklentisidir. Kasaba başkanları kendi ordularını kurabilir, askerlerini eğitebilir (Tier yükseltme), savaş ilan edebilir ve savaş sonunda kazananlar antlaşma koşulları dayatabilir.
Temel Özellikler
| Özellik | Açıklama |
| 7 Asker Sınıfı | Archer, Warrior, Fighter, Cavalry, Mage, Medic, Tank |
| 6 Kademeli Tier Sistemi | Her sınıf Tier 1 → Tier 6 arası yükseltilebilir |
| NPC Tabanlı Savaş | Citizens + Sentinel ile gerçek zamanlı otomatik savaş |
| Barınma Kapasitesi | Kasabanın arsa sayısına göre ordu büyüklüğü sınırı |
| Kışla Deposu | Askerleri depoda tutup ihtiyaç anında sahaya sürme |
| Yıldız Tabanlı Antlaşma | Savaş performansına göre yıldız kazanma ve şart dayatma |
| Savaş Ambargosu | Savaş sırasında ekonomi/toprak komutlarının kilitlenmesi |
| Otomatik Maaş Sistemi | Saatlik maaş ödeme, ödenemeyen askerler firar eder |
| SQLite / MySQL | HikariCP destekli veritabanı |
| Tamamen Özelleştirilebilir | config.yml, messages.yml, guis.yml |
📦 Kurulum ve Gereksinimler
Zorunlu Bağımlılıklar
| Plugin | Amaç |
| Towny | Kasaba/ulus sistemi, arsa yönetimi |
| Citizens | NPC (asker) oluşturma ve yönetimi |
| Sentinel | NPC yapay zeka savaş sistemi |
Opsiyonel Bağımlılıklar
| Plugin | Amaç |
| Vault | Ekonomi entegrasyonu (para çekme/yatırma) |
Kurulum Adımları
AserWarTownyLegions.jar dosyasını plugins/ klasörüne kopyalayın.
- Sunucuyu başlatın. Eklenti otomatik olarak
config.yml, messages.yml ve guis.yml dosyalarını oluşturacaktır.
config.yml dosyasını sunucunuza göre düzenleyin.
/aserwar reload komutuyla yapılandırmayı yeniden yükleyin.
📜 Komut Referansı
Oyuncu Komutları
| Komut | Açıklama |
/aserwar veya /aw | Yardım menüsünü gösterir |
/aserwar stats | Kasabanızın askeri istatistiklerini gösterir |
/aserwar antlasma | Özel Antlaşma Yönetimi GUI'sini açar |
/aserwar ilhak | Savaş sonrası kazanılan ilhak hakkını kullanır (bulunduğunuz arsayı alır) |
Kasaba (Towny) Alt Komutları
| Komut | Açıklama | Yetki |
/t army veya /town army | Ordu Yönetimi GUI menüsünü açar | Sadece Başkan |
/t army war <kasaba_adı> | Hedef kasabaya savaş ilan eder | Sadece Başkan |
/t army surrender | Aktif savaşta pes eder | Sadece Başkan |
/t army barracks | Kışla (Depo) GUI menüsünü açar | Sadece Başkan |
Admin Komutları
| Komut | Açıklama | İzin |
/aserwar spawn <sınıf> <seviye> | Test amaçlı asker doğurur | aserwar.admin |
/aserwar clear | Tüm savaş NPC'lerini temizler | aserwar.admin |
/aserwar reload | Config ve mesaj dosyalarını yeniden yükler | aserwar.admin |
💡 İpucu
Spawn komutu örneği: /aserwar spawn ARCHER 3 — Tier 3 bir okçu doğurur.
🛡️ Asker Sınıfları ve Tier Sistemi
Her asker sınıfı Tier 1'den Tier 6'ya kadar yükseltilebilir. Her tier yeni yetenekler ve stat artışları kazandırır.
Sınıf Özet Tablosu
| Sınıf | Housing Maliyeti | Çağırma Ücreti | Silah | Rol |
| 🏹 ARCHER | 10 | $500 | Yay | Uzak menzilli DPS |
| ⚔️ WARRIOR | 10 | $750 | Demir Kılıç | Yakın dövüş DPS |
| 🪓 FIGHTER | 15 | $1,250 | Demir Balta | Alan hasarı / Armor-break |
| 🐴 CAVALRY | 25 | $2,000 | Elmas Kılıç | Hızlı hücumcu |
| 🔮 MAGE | 20 | $1,750 | İksir | Büyü hasarı |
| 💚 MEDIC | 15 | $1,500 | Kağıt | İyileştirme / Diriltme |
| 🛡️ TANK | 40 | $2,500 | Kalkan | Yüksek HP / Savunma |
🏹 ARCHER — Okçu (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Saldırı Hızı Artışı | Sentinel attackRate = 20, menzil 25.0 blok |
| 2 | Temel Hasar Artışı | +%15 temel hasar çarpanı |
| 3 | Menzil Genişleme | Etkili atış menzili artar |
| 4 | Zırh Delici | Ok hasarı ×1.25 çarpana ulaşır |
| 5 | Ateşli Oklar (DoT) | Hedefe 2 saniyelik ateş efekti uygular (fireTicks = 40) |
| 6 | Usta Okçu | %20 kritik vuruş şansı → hasar ×1.5 + güçlü geri itme (knockback) |
⚔️ WARRIOR — Savaşçı (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Hız Artışı | +%5 hareket hızı |
| 2 | Zırh Bonusu | +2.0 zırh puanı |
| 3 | Yarma (Cleave) | — |
| 4 | Kalkan Kırıcı | — |
| 5 | Can Artışı | +%10 maksimum can |
| 6 | İnfazcı | +%15 can, +%15 hasar, +3.0 zırh (toplam bonuslar) |
📝 Not
Warrior, Fighter ile bazı yetenekleri paylaşır ancak daha fazla hayatta kalma odaklıdır.
🪓 FIGHTER — Dövüşçü (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Temel Güç Artışı | +%5 temel hasar |
| 2 | Saldırı Hızı Artışı | — |
| 3 | Yarma Duruşu (Cleave) | Vurduğu hedefin 2.5 blok çevresindeki düşmanlara %20 yayılma hasarı verir (kendi takımına zarar vermez) |
| 4 | Kalkan Kırıcı | TANK sınıfı hedeflere ×2.0 hasar |
| 5 | Kanlı Öfke | Fighter'ın canı %30 altına düştüğünde tüm saldırılar ×1.5 kritik |
| 6 | İnfazcı (Stun) | Her 5. vuruşta hedefe 2 saniyelik (40 tick) aşırı yavaşlatma efekti uygular |
🐴 CAVALRY — Süvari (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Hız ve Hasar Artışı | +%15 hareket hızı |
| 2 | Savuşturma | Menzilli saldırılara (ok/büyü) %5 dodge şansı |
| 3 | Hücum (Charge) | İlk vuruşta hedefe ×2.0 hasar (yeni hedefe saldırdığında tetiklenir) |
| 4 | Vur-Kaç (Hit & Run) | Canının %20'sinden fazla hasar alırsa 3 saniyelik Speed II efekti kazanır |
| 5 | Zırhlı Süvari | Hasar direnci artar |
| 6 | Ağır Hücum | Charge hasarı ×3.0'a yükselir |
⚠️ Önemli
Charge mekaniği, aynı hedefe ardışık vuruşlarda tetiklenmez. Yeni bir hedefe saldırıldığında sıfırlanır. Bellek 10 dakika sonra otomatik olarak temizlenir.
🔮 MAGE — Büyücü (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Büyü Hasarı Artışı | Sentinel attackRate = 40, menzil 15.0 blok |
| 2 | Bekleme Süresi Azalması | — |
| 3 | Alan (AoE) Genişleme | Büyü çapı genişler |
| 4 | Yavaşlatma Etkisi | Hedefi yavaşlatır |
| 5 | Zırh Delen Büyü | Büyü direncini yok sayar |
| 6 | Meteor | Yıkıcı devasa alan hasarı |
💚 MEDIC — Sıhhiyeci (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Can Artışı | Temel HP yükselmesi |
| 2 | İyileştirme Gücü | — |
| 3 | Grup İyileştirme | İyileştirme alanı genişler |
| 4 | Zırh Direnci | Zırh bonusu |
| 5 | Kritik İyileştirme | Kritik durumdaki dostlara ekstra HPS |
| 6 | Diriltme (Revive) | 8 blok yarıçap içindeki dost askere ölümcül hasar geldiğinde, hasarı iptal edip askerin canını tamamen yeniler |
⚠️ Uyarı
Diriltme mekaniği 30 saniye bekleme süresine sahiptir (medic başına). Aynı anda birden fazla sıhhiyeci varsa, sadece biri devreye girer.
🛡️ TANK — Tank (Detaylı Tier Tablosu)
| Tier | Yetenek | Mekanik Detayı |
| 1 | Büyük Can Artışı | Sentinel attackRate = 30, hız 0.8 (yavaş ama dayanıklı) |
| 2 | Hasar Azaltma | %10 mitigation |
| 3 | Kışkırtma (Taunt) | Menzili artar |
| 4 | Hasar Yansıtma | Thorns efekti |
| 5 | HP Yenileme | Savaş dışı otomatik iyileşme |
| 6 | Ölümsüz Siper | +%50 maksimum can bonusu — kısa süreliğine hasar almaz |
Tier Yükseltme Maliyeti
Formül: base_upgrade_cost + (upgrade_multiplier × hedef_tier)
| Hedef Tier | Maliyet (Varsayılan) |
| Tier 2 | $5,000 + ($2,500 × 2) = $10,000 |
| Tier 3 | $5,000 + ($2,500 × 3) = $12,500 |
| Tier 4 | $5,000 + ($2,500 × 4) = $15,000 |
| Tier 5 | $5,000 + ($2,500 × 5) = $17,500 |
| Tier 6 | $5,000 + ($2,500 × 6) = $20,000 |
🏠 Barınma (Housing) Sistemi
Her kasabanın sahip olduğu toprak miktarına göre belirli sayıda asker barındırabilecek kapasitesi vardır.
Formül
Maksimum Housing = (Arsa Sayısı × capacity-per-claim) + base-capacity
Varsayılan Değerler
| Parametre | Değer |
base-capacity | 10 |
capacity-per-claim | 5 |
max-capacity | 300 |
Örnek Hesaplama
| Arsa Sayısı | Housing Kapasitesi |
| 5 | (5 × 5) + 10 = 35 |
| 20 | (20 × 5) + 10 = 110 |
| 50 | (50 × 5) + 10 = 260 |
| 60 | min((60 × 5) + 10, 300) = 300 (tavan) |
Asker Housing Maliyetleri
| Sınıf | Housing Maliyeti |
| Archer | 10 |
| Warrior | 10 |
| Fighter | 15 |
| Cavalry | 25 |
| Mage | 20 |
| Medic | 15 |
| Tank | 40 |
🔴 Dikkat
max-capacity değerini çok yüksek tutmak (1000+), savaşlarda aşırı NPC doğumuna neden olarak sunucu performansını ciddi şekilde düşürebilir. 25v25 savaşlar için 300 civarı bir limit önerilir.
Asker öldüğünde veya despawn olduğunda, kapladığı housing alanı otomatik olarak serbest bırakılır.
🏰 Kışla (Barracks) Sistemi
Kışla, satın alınan askerlerin sahaya sürülmeden önce depolandığı bir sistemdir.
Kışla Kapasitesi
Maksimum Kapasite = Kışla Seviyesi × 20
| Kışla Seviyesi | Maksimum Asker |
| 1 | 20 |
| 2 | 40 |
| 3 | 60 |
| 4 | 80 |
| 5 | 100 |
Kışla Yükseltme Şartları
Her kışla yükseltmesi iki şart gerektirir:
| Gereksinim | Formül |
| Kazanılması Gereken Savaş | Mevcut Kışla Seviyesi × 2 |
| Para | Mevcut Kışla Seviyesi × 25,000$ |
| Hedef Seviye | Gereken Savaş | Maliyet |
| Seviye 2 | 2 | $25,000 |
| Seviye 3 | 4 | $50,000 |
| Seviye 4 | 6 | $75,000 |
| Seviye 5 | 8 | $100,000 |
Kışla İşlevleri
- Asker Satın Alma: Ordu menüsünden sol tıkla asker satın alındığında kışlaya eklenir.
- Tekli Sahaya Sürme: Kışla GUI'sinde belirli bir askere sol tıklayarak 1 asker çıkarılır.
- Toplu Sahaya Sürme: Sağ tıklayarak o sınıfın tüm stokunu sahaya sürer.
- Tümünü Sür: Beacon (ışık) butonuna basarak kışladaki TÜM askerleri bir anda sahaya sürme.
⚔️ Savaş Mekanikleri
Savaş İlan Etme Şartları
Savaş ilan edebilmek için aşağıdaki tüm koşulların sağlanması gerekir:
| Şart | Açıklama |
| Yalnızca Başkan | Sadece kasaba başkanları savaş ilan edebilir |
| Eş Zamanlı Savaş Limiti | Aynı anda maksimum 2 savaş olabilir (ayarlanabilir) |
| Kendine Saldırı Yasağı | Kendi kasabasına savaş açılamaz |
| Çifte Savaş Yasağı | Zaten savaşta olan kasabaya savaş ilan edilemez |
| Savaş Bekleme Süresi (Cooldown) | Son savaştan sonra 2 saat bekleme süresi |
| Savunan Çevrimiçi | Hedef kasabadan en az 1 oyuncu çevrimiçi olmalı |
| Minimum Asker | Saldıran tarafın sahada en az 5 askeri olmalı |
Savaş Süreci
🗡️ Savaş İlan Edilir
/t army war kasaba_adı
→
📢 Sunucu Geneli Duyuru
+ Ejderha Kükremesi Sesi
→
⏱️ BossBar Sayacı Başlar
(30 dakika geri sayım)
→
NPC'ler Birbirini Öldürür
Bir tarafın askeri 0 olur
→
🏆 Savaş Sona Erer
Kazanan belirlenir
→
📜 Antlaşma GUI'si Açılır
(Kazananın başkanına)
30 dakika dolar
→
Asker Sayısı Karşılaştırması
→
🤝 Berabere
Her iki tarafın da NPC'leri temizlenir
⏳ Her iki taraf da 2 saat bekleme süresine girer (Savaş sonucu)
⏳ Her iki taraf da 1 saat bekleme süresine girer (Berabere)
BossBar Göstergesi
Savaş sırasında, savaşa dahil kasabaların oyuncularına canlı bir BossBar gösterilir:
[Saldıran Kasaba] (Kalan Asker) ⚔ (Kalan Asker) [Savunan Kasaba] - Süre: MM:SS
- Her saniye güncellenir
- Sadece savaşa taraf kasabaların oyuncuları görebilir
Savaş Sırasında Ambargo (Savaş Kilidi)
Savaş sırasında aşağıdaki komutlar otomatik olarak engellenir:
| Engellenen Komut | Nedeni |
/t claim / /town claim | Toprak genişletme engeli |
/t unclaim / /town unclaim | Toprak terk etme engeli |
/t deposit / /town deposit | Kasaba bankasına para yatırma engeli |
/t withdraw / /town withdraw | Kasaba bankasından para çekme engeli |
/pay / /eco pay | Oyuncular arası para transferi engeli |
⚠️ Önemli
Bu sistem, savaş sırasında kasabaların ekonomik manipülasyon yapmasını önlemek için tasarlanmıştır.
NPC Savaş Kuralları
- Oyuncular askerlere hasar veremez. Gerçek oyuncuların NPC askerlere saldırması engellenir.
- Askerler sadece düşman kasaba askerlerine saldırır. Sentinel entegrasyonu ile
aserwar_enemy:TOWN_UUID hedefleme sistemi kullanılır.
- Ölen askerin cesedi anında kaldırılır. Sunucu performansını korumak için.
- Chunk unload koruması mevcuttur. Chunk'lar arasında asker kaybını önler.
📜 Antlaşma ve Diplomasi Sistemi
Yıldız Puanlama
Savaş bitiminde kazanana Yıldız verilir. Yıldız miktarı savaş performansına bağlıdır:
| Durum | Yıldız |
| Saldıran taraf pes etti | 20 ⭐ (Tam zafer) |
| Kalan asker oranı ≥ %70 | 20 ⭐ (Ağır zafer) |
| Kalan asker oranı %30 – %70 | 10 ⭐ (Orta zafer) |
| Kalan asker oranı < %30 | 5 ⭐ (Hafif zafer) |
Antlaşma Şartları (Treaty Maker)
Kazanan tarafın başkanına açılan Antlaşma GUI'sinde seçilebilecek şartlar:
| Şart | Yıldız Maliyeti | Açıklama |
| 🪙 Hazine Yağması I | 3 ⭐ | Kaybeden kasabanın toplam değerinin %10'unu anında tahsil et |
| 💰 Hazine Yağması II | 8 ⭐ | Kaybeden kasabanın toplam değerinin %25'ini anında tahsil et |
| 💎 Hazine Yağması III | 15 ⭐ | Kaybeden kasabanın toplam değerinin %50'sini anında tahsil et |
| 🟩 Sınır Düzenlemesi | 5 ⭐ | Düşman sınırından 1 arsa ilhak etme hakkı |
| 🟫 Toprak İşgali | 12 ⭐ | Düşman sınırından 3 arsa ilhak etme hakkı |
| ⏰ Düzenli Vergi | 15 ⭐ | Mağlup kasabaya günlük 25,000$ vergi borcu (3 gün) |
| 📝 Özel Şart | 8 ⭐ | Sohbet üzerinden girilen serbest metin şartı |
📝 Not
Hazine Yağması seçenekleri birbirleriyle karşılıklı dışlayıcıdır — yalnızca biri seçilebilir.
İlhak seçenekleri de birbirleriyle karşılıklı dışlayıcıdır.
Kasaba Değeri Hesaplama
Hazine yağması şartlarında kullanılan "Kasaba Değeri" şu formülle hesaplanır:
Kasaba Değeri = (Arsa Sayısı × 2,000) + (Nüfus × 5,000) + Kasaba Bankası Bakiyesi
Bu sistem, savaş öncesi kasaba bankasını boşaltma gibi manipülasyonları engeller.
İlhak (Annexation) Sistemi
Savaş sonrası ilhak hakkı kazanıldığında:
- Kazanan kasabanın başkanı, mağlup kasabanın topraklarındaki bir arsanın üzerine gider.
/aserwar ilhak komutunu kullanır.
- Sadece dış çeperdeki arsalar (vahşi doğaya veya kendi sınırlarına temas eden) ilhak edilebilir.
- Her başarılı ilhak, kalan hakkı 1 azaltır.
Antlaşma Kabul/Red Sistemi
Mağlup tarafa antlaşma sunulduğunda:
| Seçenek | Sonuç |
| ✅ Kabul Et | İstenen tutarı kendi cebinden öder. Barış sağlanır. |
| ❌ Reddet | Kasaba zorla yağmalanır (yarı tutar). Kasaba "Yıkım Modu"na girer. Sunucu geneline diplomatik kriz duyurusu yapılır. |
Özel Şart Yönetimi
/aserwar antlasma komutuyla özel antlaşmalar görüntülenebilir.
- Galip kasaba başkanı, özel şartı "Tamamlandı" olarak işaretleyerek yükümlülüğü kaldırabilir.
- Mağlup kasaba, şartı yerine getirmek zorundadır (sistem dışı takip).
💰 Ekonomi ve Maaş Sistemi
Saatlik Maaş (Upkeep)
Her 1 saatte bir otomatik olarak çalışan maaş sistemi:
Maaş = (Kışladaki Asker Housing Maliyeti + Sahadaki Asker Housing Maliyeti) × upkeep_multiplier
| Parametre | Varsayılan |
upkeep_multiplier | 10.0 |
Maaş Ödeme Akışı
⏰ Saatlik Maaş Kontrolü
→
Kasabanın yeterli parası var mı?
Evet → 💰 Başkandan para kesilir
Hayır → 🏃 Askerler firar eder!
Kışladaki her sınıfın yarısı silinir
→
📢 Başkana uyarı mesajı gönderilir
Otomatik Kaydetme
Tüm kasaba verileri 15 dakikada bir otomatik olarak veritabanına kaydedilir (asenkron).
1. Ordu Yönetimi Menüsü (/t army)
| Slot | İtem | İşlev |
| 10 | 🏹 Yay | Archer — Sol tık: çağır / Sağ tık: yükselt |
| 11 | ⚔️ Demir Kılıç | Warrior — Sol tık: çağır / Sağ tık: yükselt |
| 12 | 🪓 Elmas Balta | Fighter — Sol tık: çağır / Sağ tık: yükselt |
| 13 | 🐴 Demir At Zırhı | Cavalry — Sol tık: çağır / Sağ tık: yükselt |
| 14 | 🔮 Blaze Çubuğu | Mage — Sol tık: çağır / Sağ tık: yükselt |
| 15 | 💚 Altın Elma | Medic — Sol tık: çağır / Sağ tık: yükselt |
| 16 | 🛡️ Kalkan | Tank — Sol tık: çağır / Sağ tık: yükselt |
Menü başlığında mevcut ve maksimum housing alanı gösterilir: Ordu Yönetimi (35/110)
2. Kışla (Depo) Menüsü (/t army barracks)
| Slot | İtem | İşlev |
| 4 | 📖 Kitap | Kışla bilgileri (seviye, kapasite) |
| 9–15 | Asker ikonları | Sol tık: 1 adet sahaya sür / Sağ tık: tümünü sür |
| 22 | 🔨 Örs | Kışlayı yükselt |
| 26 | 💡 Beacon | TÜM orduyu sahaya sür |
3. Seviye Yükseltme Menüsü
| Slot | İtem | İşlev |
| 11 | 📄 Kağıt | Asker özellikleri ve bonusları (Tier listesi) |
| 13 | 📖 Kitap | Mevcut sınıf ve tier bilgisi |
| 15 | ✅/❌ Cam | Yükselt butonu (max ise kırmızı gösterilir) |
| 26 | 🚫 Bariyer | Geri dön |
4. Antlaşma Yapma Menüsü (Savaş Sonrası — Kazanan)
45 slotluk envanter. Yıldız harcayarak şartlar seçilir, ardından "İmzala" butonuyla uygulanır.
5. Antlaşma Kabul Menüsü (Savaş Sonrası — Kaybeden)
| Slot | İtem | İşlev |
| 11 | 🟢 Yeşil Cam | İmzala ve Kabul Et |
| 13 | 📄 Kağıt | Şart detayları |
| 15 | 🔴 Kırmızı Cam | Reddet (Yıkımı Göze Al) |
6. Özel Antlaşma Yönetimi Menüsü (/aserwar antlasma)
54 slotluk envanter. Galip kasabanın dayattığı özel şartlar burada listelenir. Galip taraf, şartı "Tamamlandı" olarak işaretleyebilir.
🔌 API ve Etkinlikler (Events)
Plugin, diğer eklentilerin entegre olabilmesi için özel Bukkit etkinlikleri sunar:
| Etkinlik | Tetiklenme Anı | Bilgiler |
WarDeclareEvent | Savaş ilan edildiğinde | initiator (Player), attackerUUID, defenderUUID — İptal edilebilir |
WarEndEvent | Savaş sona erdiğinde | winnerUUID, loserUUID, attackerSurrendered |
TroopSpawnEvent | Asker doğduğunda | townUUID, troopType, location, npc |
Sentinel Entegrasyonu
Plugin, Sentinel'e özel bir hedefleme sistemi kaydeder:
- Hedef prefiks:
aserwar_enemy
- Kullanım:
aserwar_enemy:TOWN_UUID
- Farklı kasabadaki askerler birbirini düşman olarak algılar.
⚙️ Yapılandırma Dosyaları
config.yml
Ana yapılandırma dosyası. Üç ana bölümden oluşur:
Veritabanı Ayarları
database:
type: "sqlite" # sqlite veya mysql
host: "localhost" # MySQL için
port: 3306
database: "aserwar"
username: "root"
password: "password"
pool-size: 10
connection-timeout: 30000
Housing (Barınma) Ayarları
housing:
base-capacity: 10
capacity-per-claim: 5
max-capacity: 300
costs:
archer: 10
warrior: 10
fighter: 15
cavalry: 25
mage: 20
medic: 15
tank: 40
Mekanik Ayarları
mechanics:
max-concurrent-wars: 2
npc-name-format: "&c[T%tier%] %type%"
medic-revive-cooldown: 30
cavalry-charge-multiplier: 2.0
cavalry-charge-tier6-multiplier: 3.0
fighter-cleave-percentage: 0.20
fighter-stun-duration: 40
Ekonomi Ayarları
economy:
upkeep_multiplier: 10.0
town-value:
claim-value: 2000.0
resident-value: 5000.0
spawn-cost:
archer: 500.0
warrior: 750.0
fighter: 1250.0
cavalry: 2000.0
mage: 1750.0
medic: 1500.0
tank: 2500.0
base-upgrade-cost: 5000.0
upgrade-multiplier: 2500.0
messages.yml
Tüm oyun içi mesajlar bu dosyadan yönetilir. & renk kodları desteklenir.
Ana Bölümler:
prefix — Mesaj öneki
war.* — Savaş mesajları (ilan, bitiş, berabere, BossBar)
stats.* — İstatistik mesajları
upkeep.* — Maaş başarısızlık mesajları
commands.* — Yardım ve komut mesajları
army.* — Ordu yönetimi mesajları (yetki, hata, başarı)
guis.yml
Tüm GUI menü metinleri ve tier yetenek açıklamaları bu dosyadan yönetilir.
Ana Bölümler:
army-menu.* — Ordu menüsü başlık ve ikonları
upgrade-menu.* — Yükseltme menüsü ve tüm sınıf yetenek açıklamaları
barracks-menu.* — Kışla menüsü
treaty-maker-menu.* — Antlaşma yapma menüsü
treaty-accept-menu.* — Antlaşma kabul menüsü
🔐 İzin Düğümleri (Permissions)
| İzin | Açıklama | Varsayılan |
aserwar.admin | Admin komutlarına erişim (spawn, clear, reload) | OP |
📝 Not
Standart oyuncu komutları (stats, antlasma, ilhak) herhangi bir özel izin gerektirmez.
Kasabaya özel işlemler (savaş ilan, ordu yönetimi, kışla) Towny'nin kendi başkanlık kontrolü ile sınırlandırılır.
❓ Sık Sorulan Sorular (SSS)
Savaş ile İlgili
S: Bir savaşta taraflardan biri tamamen askerini kaybederse ne olur?
C: Tüm askerlerini kaybeden taraf otomatik olarak savaşı kaybeder. Kazanana antlaşma GUI'si açılır.
S: 30 dakika dolduğunda asker sayısı eşitse ne olur?
C: Savaş berabere biter. Hiçbir taraf antlaşma dayatamaz. Her iki tarafa da 1 saatlik bekleme süresi verilir.
S: Savaş sırasında pes edersem ne olur?
C: Pes eden taraf otomatik kaybeder. Karşı tarafa 20 Yıldız verilir (maksimum antlaşma gücü).
S: Aynı anda kaç savaş olabilir?
C: Varsayılan olarak 2. config.yml dosyasından max-concurrent-wars ayarıyla değiştirilebilir.
Asker ile İlgili
S: Gerçek oyuncular askerlere saldırabilir mi?
C: Hayır, oyuncuların NPC askerlere verdiği hasar otomatik olarak engellenir.
S: Askerler chunk unload olduğunda kaybolur mu?
C: Hayır, Citizens NPC sistemi chunk unload koruması sağlar.
S: Maaş ödeyemezsem ne olur?
C: Kışladaki her sınıftan askerlerin yarısı firar eder (silinir).
Antlaşma ile İlgili
S: Mağlup antlaşmayı reddederse ne olur?
C: Kasaba zorla yağmalanır (istenen tutarın yarısı alınır) ve "Yıkım Modu"na girer. Sunucu geneline diplomatik kriz duyurusu yapılır.
S: İlhak hakkımı nerede kullanırım?
C: Mağlup kasabanın sınır arsalarından birine gidip /aserwar ilhak yazmanız yeterlidir. Sadece dış çeperdeki arsalar ilhak edilebilir.
AserWar Towny Legions — Kasabalar arası stratejik savaşın yeni boyutu.
© 2026 AserLand — www.aserland.com