📑 İçindekiler
- Genel Bakış
- Kurulum ve Gereksinimler
- Komut Referansı
- Sanal Köylü Sistemi ve Limitler
- Takas Yenileme (Reroll) ve Restok
- Zombifikasyon (Zombification) Mekaniği
- Kahraman Özü (Hero Essence) Sistemi
- Global Pazar Yeri (Marketplace)
- GUI Menüleri
- Yapılandırma Dosyaları
- İzin Düğümleri (Permissions)
- Sık Sorulan Sorular (SSS)
🌍 Genel Bakış
AserVillagers, sunucu içi ekonomiyi canlandırmak ve vanilla köylü sistemindeki hantallığı ortadan kaldırmak için geliştirilmiş asenkron sanal köylü ve pazar yeri eklentisidir. Oyuncular kendi sanal köylülerini yönetebilir, takasları yenileyebilir (Reroll), zombifikasyon ile indirim kazanabilir ve global pazar üzerinden diğer oyuncularla etkileşime girebilirler.
Temel Özellikler
| Özellik | Açıklama |
|---|
| Sanal Köylü Yönetimi | Oyunculara özel GUI tabanlı asenkron sanal köylüler |
| Takas Yenileme (Reroll) | Bekleme süreli veya para karşılığı takasları sıfırlama sistemi |
| Otomatik Restok | Tükenen takasların belirli aralıklarla (5 dk) yenilenmesi |
| Zombifikasyon Mekaniği | Köylüleri zombiye çevirip iyileştirerek kalıcı takas indirimleri elde etme |
| Kahraman Özü (Hero Essence) | Özel takaslar ve prestij için kullanılan ekstra özellik sistemi |
| Global Pazar Yeri | Oyuncuların köylülerini ve eşyalarını sunucu genelinde sergileyebilmesi |
| VIP Limit Sistemi | Yetki bazlı (VIP, MVP vb.) maksimum köylü sayısı limitleri |
| Tam Asenkron Altyapı | Veritabanı işlemleri ve GUI yüklemeleri ana thread'i yormadan çalışır |
📦 Kurulum ve Gereksinimler
Zorunlu Bağımlılıklar
| Plugin | Amaç |
|---|
| Vault | Ekonomi entegrasyonu (Reroll ve Pazar işlemleri için) |
Kurulum Adımları
AserVillagers.jar dosyasını plugins/ klasörüne kopyalayın.- Sunucuyu başlatın. Eklenti otomatik olarak
config.yml ve diğer veri dosyalarını oluşturacaktır.
config.yml dosyasından ekonomik değerleri ve bekleme sürelerini ayarlayın.- Oyun içi yetkileri yapılandırın ve eklentiyi kullanmaya başlayın.
📜 Komut Referansı
Oyuncu Komutları
| Komut | Açıklama | Yetki |
|---|
/koylu veya /villager | Kendi sanal köylü yönetimi GUI'sini açar | Yok |
/koylupazar veya /vmarket | Global köylü pazarını açar | Yok |
Admin Komutları
| Komut | Açıklama | İzin |
|---|
/koylu reload | Config dosyalarını yeniden yükler | aservillagers.admin |
/koylu admin <oyuncu> | Başka bir oyuncunun sanal köylülerini yönetir | aservillagers.admin |
💡 İpucu
Oyuncularınıza /koylu komutunun kısayolu olarak /köylü komutunu da kullanabileceklerini hatırlatabilirsiniz.
🧑🌾 Sanal Köylü Sistemi ve Limitler
Oyuncular, vanilla Minecraft'taki gibi fiziksel varlıklara (entity) ihtiyaç duymadan, tamamen menü üzerinden çalışan köylülere sahip olurlar. Her oyuncunun sahip olabileceği sanal köylü sayısı yetkilerine göre sınırlandırılmıştır.
VIP Limitleri
Yetkilendirme gruplarına göre belirlenmiş varsayılan köylü limitleri:
| Grup / Yetki | Maksimum Köylü Limiti |
|---|
| Oyuncu (Default) | 2 Köylü |
| VIP | 5 Köylü |
| MVP | 10 Köylü |
| Admin (Sınırsız) | Limit Yok (-1) |
🔴 Dikkat
Limit aşıldığında oyuncuya "Maksimum köylü limitine ulaştınız: {limit}" uyarısı gösterilir ve yeni köylü eklemesi engellenir.
🔄 Takas Yenileme (Reroll) ve Restok
Reroll (Yenileme) Mekaniği
Oyuncular, sanal köylülerinin sunduğu takas tekliflerini beğenmediklerinde bunları yenileyebilirler. Reroll sistemi iki farklı modda çalışabilir:
- FREE (Ücretsiz + Bekleme Süreli): Oyuncular ücretsiz yenileme yapar ancak bir sonraki yenileme için belirli bir süre (ör. 5 saniye) beklemek zorundadır.
- PAID (Ücretli): Oyuncular her yenilemede ekonomi bakiyelerinden belirli bir miktar (ör. 500.0 TL) öderler. Bekleme süresi yoktur.
| Parametre | Varsayılan Değer | Açıklama |
|---|
reroll-mode | FREE | Yenileme modu (FREE veya PAID) |
reroll-cost | 500.0 | PAID modunda işlem başı ücret |
reroll-cooldown-seconds | 5 | FREE modunda bekleme süresi |
Otomatik Restok
Köylülerle yapılan takaslar tükenirse (maksimum takas sınırına ulaşılırsa), oyuncunun beklemesi gerekir.
Varsayılan Restok Süresi: 5 Dakika
Süre dolduğunda köylünün tüm kilitli takasları asenkron olarak arka planda yenilenir ve tekrar kullanılabilir hale gelir.
🧟 Zombifikasyon (Zombification) Mekaniği
Vanilla Minecraft'ın sevilen mekaniği olan Zombi Köylü iyileştirme sistemi, AserVillagers ile sanal ortama taşınmıştır.
İşleyiş
🧪 Zombifikasyon Başlatılır
(Oyuncu zombi menüsüne tıklar)
→
Köylü Zombi Forma Geçer
(Geçici olarak takas yapılamaz)
Altın Elma / İksir Uygulanır
→
⏱️ İyileştirme Süreci Başlar
(Varsayılan: 10 Dakika)
→
✨ İyileştirme Tamamlanır
Kalıcı Takas İndirimleri!
İyileştirme Süresi
config.yml içerisindeki curing-time-minutes parametresi ile belirlenir (Varsayılan 10 dakika). Bu süreç boyunca oyuncu bu köylü ile işlem yapamaz.
📝 Not
Zombifikasyon özelliği sunucu geneli için zombification-enabled: true/false ayarı ile tamamen açılıp kapatılabilir.
💎 Kahraman Özü (Hero Essence) Sistemi
Eklentiye özgü yenilikçi bir mekanik olan Kahraman Özü, elit oyuncuların köylüleri ile bağını güçlendirmesini sağlar.
- Sadece belirli şartları sağlayan veya özel etkinliklerden elde edilen bir para birimi / etkileşim aracıdır.
- Köylülerin seviyesini maksimuma taşımak veya gizli eşya takaslarını açmak için kullanılabilir.
hero-essence-enabled: true ayarı ile kontrol edilir.
🏪 Global Pazar Yeri (Marketplace)
Oyuncular, sadece kendi sanal köylüleri ile sınırlı kalmazlar. /koylupazar komutu ile sunucu genelindeki Global Pazar Yeri'ne erişebilirler.
Özellikler
| İşlev | Açıklama |
|---|
| 🛒 Açık Arttırma / Satış | Özel yetenekli veya indirimli köylüler pazar yerinde diğer oyunculara satılabilir. |
| 🔍 Detaylı Filtreleme | Meslek, seviye veya fiyata göre köylü arama imkanı. |
| 💰 Asenkron Ekonomi | Satın alınan köylünün parası çevrimdışı olsa bile satıcının hesabına asenkron aktarılır. |
⚠️ Önemli
Pazar yeri özelliği marketplace-enabled: true değeri ile aktiftir. Sunucunun ilk günlerinde ekonomiyi dengede tutmak isterseniz bu özelliği geçici olarak false yapabilirsiniz.
1. Ana Köylü Yönetimi Menüsü (/koylu)
| Bölüm | İşlev |
|---|
| Köylü İkonları | Oyuncunun sahip olduğu köylüleri gösterir. Tıklanarak takas menüsüne gidilir. |
| ➕ Yeni Köylü | Eğer limite ulaşılmadıysa yeni bir sanal köylü oluşturur. |
| 📊 İstatistikler | Mevcut limit ve kullanım durumunu gösterir. |
2. Takas ve İşlem Menüsü
Bir köylüye tıklandığında açılır.
| İtem | İşlev |
|---|
| Zümrüt / Eşyalar | Mevcut takas teklifleri. |
| 🔄 Reroll Butonu | Takasları yeniler (Ücretli veya Bekleme Süreli). |
| 🧪 Zombifikasyon Butonu | Köylüyü zombiye çevirme sürecini başlatır. |
| 📦 Restok Durumu | Takasların yenilenmesine kalan süreyi gösterir. |
3. Global Pazar Menüsü (/koylupazar)
Diğer oyuncuların satışa çıkardığı köylüleri listeleyen geniş, sayfalara ayrılmış bir menüdür.
⚙️ Yapılandırma Dosyaları
config.yml
Eklentinin tüm hayati ayarları burada bulunur:
# AserVillagers - Gelişmiş Konfigürasyon
settings:
zombification-enabled: true
hero-essence-enabled: true
marketplace-enabled: true
reroll-mode: 'FREE' # 'FREE' veya 'PAID'
reroll-cost: 500.0
reroll-cooldown-seconds: 5
restock-time-minutes: 5
curing-time-minutes: 10
limits:
default: 2
vip: 5
mvp: 10
admin: -1
messages:
prefix: "&8[&d&lAserVillagers&8] "
no-permission: "&cBu işlemi yapmak için yetkiniz yok!"
reroll-cooldown: "&cTekrar yenilemek için {time} saniye beklemelisiniz!"
reroll-no-money: "&cTakas yenilemek için {cost} TL gerekiyor!"
limit-reached: "&cMaksimum köylü limitine ulaştınız: &e{limit}"
🔐 İzin Düğümleri (Permissions)
| İzin | Açıklama |
|---|
aservillagers.limit.default | Oyunculara varsayılan köylü limiti tanımlar (2 adet) |
aservillagers.limit.vip | VIP oyunculara köylü limiti tanımlar (5 adet) |
aservillagers.limit.mvp | MVP oyunculara köylü limiti tanımlar (10 adet) |
aservillagers.limit.admin | Sınırsız köylü limiti sağlar (-1) |
aservillagers.admin | Eklentiyi yeniden yükleme ve diğer oyuncuların köylülerine müdahale yetkisi verir |
📝 Not
Limit izinlerinden birden fazlasına sahip olan oyuncularda, her zaman en yüksek limit değeri dikkate alınır.
❓ Sık Sorulan Sorular (SSS)
S: Sunucu yeniden başlatıldığında köylüler kaybolur mu?
C: Hayır, AserVillagers tüm köylü ve pazar verilerini asenkron bir biçimde veritabanına kaydeder. Hiçbir veri kaybı yaşanmaz.
S: Reroll süresi bittiğinde mesaj geliyor mu?
C: Oyuncu menüyü açık tutuyorsa ikon dinamik olarak yeşile döner, kapalıysa bir sonraki tıklamasında işlem anında gerçekleşir.
S: Zombi iyileştirme sırasında köylümü pazara koyabilir miyim?
C: Hayır, iyileştirme süreci devam eden (Curing State) köylüler kilitlidir ve pazar yerine eklenemezler.
S: Oyuncuların pazar yerindeki fiyatları manipüle etmesini nasıl engellerim?
C: marketplace-enabled ayarını kullanarak sunucunun ilk haftalarında pazarı kapalı tutup, oyuncular arasındaki rekabet oturduktan sonra aktif edebilirsiniz.
AserVillagers — Gelişmiş Sanal Köylü ve Pazar Deneyimi.
© 2026 AserLand — www.aserland.com