EcoDynamics Dokümantasyonu

Minecraft sunucunuza yaşayan ve nefes alan bir ekosistem entegre edin.

EcoDynamics, sıradan Minecraft çiftçiliğini gerçek bir deneyime dönüştürür. Bitkilerin arz-talep sistemine göre fiyat değiştirdiği, toprağın aynı bitkiyi ekmekten yorulduğu, dev mutant ekinlerin türediği ve doğanın dengesi bozulduğunda çekirge istilası ya da kuraklık gibi çevresel felaketlerin başladığı tam teşekküllü bir eklentidir.

Spigot API Uyumluluğu

Eklentimiz en zorlu animasyonları sıfır (0) lag garantisiyle sağlamak adına 1.19.4+ sürümlerinde gelen yeni nesil paketleri (Display Entities) aktif olarak kullanır.

Kurulum Rehberi

Eklentiyi kurmak diğer klasik eklentilerle tamamen aynıdır.

Satın aldığınız EcoDynamics.jar dosyasını sunucunuzun /plugins dizinine kopyalayın.
Eğer sunucunuzda ekomoni altyapısı kullanacaksanız Vault eklentisinin kurulu olduğundan emin olun.
Sunucuyu başlatın veya yeniden başlatın. Klasörler otomatik olarak oluşacaktır.

Her şey hazır!

Kurulumdan sonra komutları kullanmaya hemen başlayabilirsiniz.

Gereksinimler

Yazılım	Minimum Sürüm	Not / Gerekçe
Sunucu	Paper 1.20 - 1.21.x	Spigot tabanlı sürümler desteklenir ancak Paper MC tavsiye edilir.
Java	Java 17+	En modern ve güvenli performansı sağlamak için.
Vault	En güncel	Zorunlu Puan Economy özelliklerinin çalışması için Vault şarttır.

Borsa & Ekonomi (The Market)

EcoDynamics eklentisindeki ekonomi modülü dinamiktir. Oyuncular aynı bitkiyi sürekli üretip satarsa o bitkinin fiyatı düşer. Piyasada nadir bulunan bitkilerin değeri artar.

Arz ve Talep Algoritması

Her oyuncu satış yaptığında, satış yapılan ürünün global fiyatı -0.10 TL ile -5.00 TL arasında bir miktar düşüş yaşar. Aynı anda diğer ekinlerin değeri sunucu bazında küçük ivmelerle artar.

Piyasayı Okumak (The Eye)

Ekonomik İstihbarat adını verdiğimiz özellik sayesinde, Market menüsünün en altında yer alan Ender Gözü (The Eye) ikonuna tıklayarak sunucudaki tüm oyuncuların genel olarak en çok hangi ekinleri diktiğini yüzdelik dilimlerle görebilirsiniz.

Toprak Sağlığı (Soil Health)

Gerçek hayattaki gibi, aynı toprağa sürekli aynı ekini ekmeniz halinde toprağın mineralleri tükenir ve çoraklaşır (Monokültür etkisi). Rotasyon (Polikültür) şarttır.

Oyuncular toprağın verimliliğini çıplak gözle göremez. Büyülü bir ayna olan EcoLens'i (/ed lens) elinize aldığınızda ve ekrandan baktığınızda, bulunduğunuz chunk'un toprak sağlığını Boss Bar (Yukarıda) aracılığıyla görebilirsiniz.

AoE İşçi Sistemi

EcoDynamics, sunucunuza strateji oyunlarından alışık olduğunuz işçi (worker) sistemini getirir. Artık hammaddeleri sizin yerinize toplayan sadık işçileriniz var.

İşçi Türleri ve Görevleri

İşçi	Uzmanlık	Özellik
🌾 Çiftçi	Tarım	Farmland üzerindeki olgun ekinleri toplar ve kasaya taşır.
🪓 Oduncu	Lumberjack	Timber moduyla ağaçları kökten keser, saniyeler içinde kütükleri toplar.
⛏ Madenci	Mining	Bölgedeki değerli cevherleri (Demir, Altın, Elmas vb.) çıkarır.

İşçi Yönetim Paneli

Çekirdek (EcoCore) üzerinden erişilebilen **İşçi Yönetim Merkezi**, işçilerinizin verimliliğini takip etmenizi sağlar:

İstatistikler: Toplam toplanan kaynak, yapılan teslimat sayısı.
Verimlilik: İşçinin bir seferde ne kadar kaynak getirdiği (efficiency).
Durum Takibi: İşçinin o an ne yaptığını (Hasat ediyor, Eve dönüyor vb.) görebilirsiniz.

Sınır Görselleştirmesi (BlockDisplay)

Eklentimiz, arazilerinizi ve sunucu sınırlarını göstermek için en modern ve lag-free paketi olan **BlockDisplay** entity'lerini kullanır.

/ed toggle komutuyla açılan bu sistem, arazi sahipliğine göre farklı renklerle sınırları çizer:

Yeşil Çizgiler: Kendi araziniz.
Kırmızı Çizgiler: Rakip pazar arazisi.
Mavi Çizgiler: Sahipsiz vahşi doğa.

Estetik ve Performans

Bu sistem eski partikül sistemlerinin aksine daha net görünür, zincir direklerle estetik durur ve asenkron çalıştığı için FPS düşürmez.

Mutant Bosslar

Eğer bir oyuncu tarlasındaki toprak sağlığını %90 ve üstü oranlarda tutmayı başarabilirse ekinler Mutant Boss Crop'a dönüşebilir.

Animasyon: Her vuruşta "Squash & Stretch" yapar.
Ödül: Canı sıfırlanınca patlayarak etrafa zümrüt vb. saçar.

Çevresel Felaketler

1. Çekirge İstilası: Sağlığı %15'in altındaki topraklara musallat olur. Çözüm: Kamp Ateşi ile tarlayı dumanlamaktır.

2. Kuraklık (Drought): Sunucu genelinde ağaç sayısı kritik sınırın altına inerse başlar, sunucuya bir daha ağaç dikilene kadar yağmur yağmaz!

Yapılandırma (config.yml)

Eklentiyi tamamen kendi zevkinize göre modifiye edebilirsiniz:

config.yml

ecology:
  drought_threshold: 50         # Kuraklık başlangıcı için en az kaç ağaç olmalı
  soil_decay_rate: 1.5          # Monokültürde chunk'un çürüme hızı
  boss_spawn_chance: 5.0        # Sağlıklı chunk'da % kaç ihtimalle boss çıkar

boss:
  health: 100.0                 # Bossların ortak can miktarı
                

Komutlar

Komut	Açıklama
`/ed market`	Dinamik alış/satış borsasını (GUI) açar.
`/ed guide`	Toprak ekolojisi bilgi ekranını açar.
`/ed lens`	Sağlık durumunu gösteren EcoLens eşyasını verir.
`/ed reload`	Tüm konfigürasyonu yeniler (Admin).

İzinler (Permissions)

Yetki	Kapsam
`ecodynamics.spy`	Market üzerindeki "The Eye" istihbarat düğmesini görmeyi sağlar.
`ecodynamics.admin`	/ed reload gibi tüm admin komutlarına erişim sağlar.

Sürüm Notları (Changelog)

v1.5 - The Management & Visual Overhaul

[Yeni] Blok Bazlı Sınır Görselleştirmesi (BlockDisplay v2.0).
[Yeni] Premium İşçi Yönetim GUI (Stats & Efficiency).
[Yeni] İşçi İstatistikleri Kayıt Sistemi (SQL).

v1.4 - AoE Worker System

[Yeni] Yaşayan işçi sistemi (Çiftçi, Oduncu, Madenci).
[Yeni] Akıllı Kaynak Tarama ve AI Navigasyonu.
[Yeni] Timber Modu (Gerçekçi ağaç kesme).

v1.3 - Living World & Epic Animations

[Yeni] Çekirge İstilası (Locust Swarm) eklendi.
[Yeni] Interaction entity ile Mutant Boss hitbox optimizasyonu.
[Yeni] Kuraklık sistemi eklendi.

v1.2 "The Economist" Güncellemesi

Borsa fiyat algoritması (Arz-talep) yeniden yazıldı.
Black Market menüsüne The Eye (Ekonomik İstihbarat) düğmesi eklendi.