Sıfırdan Minecraft Plugin Paketi Nasıl Hazırlanır? Sunucu Sahipleri Rehberi

Hazır plugin paketi almak yerine kendim mi yapsam? sorusu, sunucu sahiplerinin kafasında uzun süre dolanır. Hazır paketlerin kontrolü sınırlı, özelleştirme zor, marka kimliği zayıftır. Kendi paketini hazırlamak ise özgürlük getirir ama ciddi bir zaman ve uzmanlık yatırımı ister. Bu rehber sıfırdan bir plugin paketi hazırlamanın tüm sürecini adım adım anlatır: mod tipi kararından plugin seçimine, config birleştirmeden permission tasarımına, test sürecinden bakım stratejisine kadar.

Rehberin sonunda, kendi paketini hazırlayacak donanıma sahip olacaksınız. Ama aynı zamanda şunu göreceksiniz: profesyonelce hazırlanmış bir pakete denk bir kalite için ortalama 80-120 saat harcamanız gerekir. Bu süreyi ayırmayacaksanız hazır pakete dönmek mantıklı olur.

# Adım 1: Mod Tipini Net Olarak Tanımlayın

Plugin paketi hazırlamanın ilk ve en önemli adımı sunucunuzun ne olacağına karar vermektir. Survival biraz faction biraz da skyblock diyen sunucular altı ay sonra kimsenin ilgilenmediği sunuculardır. Tek bir mod tipi seçin ve o tipi derinlemesine yapın.

Yaygın mod tipleri ve karakteristikleri:

Tek bir mod seçemiyorsanız küçük başlayın: Vanilla''ya en yakın Survival seçin. Popülerleşince yan mod eklersiniz.

# Adım 2: Plugin Stack''ini Katmanlı Olarak Kurgulayın

Plugin paketi zorunlu ve opsiyonel bileşenlerden oluşur. Zorunlulardan başlayıp opsiyonellere doğru gidin; bir plugin eklendikçe sunucuyu restart edip log''da hata olup olmadığını kontrol edin. Hatasız çalışıyorsa bir sonraki pluginle devam edin.

# Katman 1: Çekirdek (Her sunucuda olmalı)

• LuckPerms: Permission yönetimi
• Vault: Ekonomi/chat/permission API soyutlama
• PlaceholderAPI: Dinamik değişken sistemi
• ProtocolLib: Düşük seviye paket erişimi
• EssentialsX: Temel komutlar (home, spawn, tpa)
• EssentialsXChat: Chat biçimlendirme
• CoreProtect: Griefing geri alma / log

# Katman 2: Anti-Cheat ve Güvenlik

• Matrix / Vulcan / AAC: Hile koruması
• AuthMe: Login güvenliği (offline mode için)
• IPWhitelist / AutoBanPlus: VPN ve proxy engelleme
• BanManager: Gelişmiş ban sistemi
• Sentinel: Chat reklamı ve küfür filtresi

# Katman 3: Mod Özel Pluginler

Burada seçtiğiniz mod tipine göre spesifik pluginler gelir. Örnek SkyBlock için:

• BentoBox + SkyBlock modülü: Ada sistemi
• IslandUpgrades: Ada yükseltme
• Minions / AutoFarm: Otomasyon
• WildStacker: Mob yığma
• Shop / GUIShop: Market sistemi
• AuctionHouse: Açık arttırma

# Katman 4: UI ve Görsel

• TAB: Üst tablo oyuncu listesi
• FeatherBoard / Scoreboard: Yan panel
• Citizens + SkinsRestorer: NPC sistemi
• DecentHolograms: Uçan yazılar
• ServerUtils: Gereksiz mesajları filtreleme

# Katman 5: Quality of Life

• ChestShop / DeluxeMenus: GUI tabanlı market
• PlayerWarps: Oyuncu tarafından warp açma
• VoteParty: Vote toplayıp ödül verme
• RandomTeleport: Vahşi alana ışınlanma
• SilkSpawners / EpicSpawners: Spawner sistemi

# Adım 3: Plugin Seçiminde Kriterleri Belirleyin

Her görev için birden fazla plugin vardır. Hangisini seçeceğinize karar verirken şu kriterler baz alınmalı:

• Aktif bakım: Son güncelleme 6 aydan yeni mi?
• İndirme sayısı: Güvenilirlik göstergesi
• Oy/puan: 4.5+ yıldız iyi gösterge
• Developer itibarı: Tanınan geliştirici mi?
• Kaynak kodu açık mı? Açıksa güvenlik için artı puan
• Bağımlılık sayısı: Çok fazla bağımlılığı olan pluginler fragilite yaratır
• Performans profili: Spark ile ölçülebilir mi?
• Folia desteği: Gelecek planlı mı?

# Adım 4: Config Dosyalarını Birleştirin

Pluginlerin her birinin kendi config''i vardır ama birbiriyle tutarlı olmalı. Örneğin:

• Ekonomi para birimi tüm pluginlerde aynı olmalı (kredi ve altın karışmasın)
• Chat prefix sistemi tek plugin tarafından yönetilmeli (EssentialsXChat veya DeluxeChat, ikisi birden değil)
• Permission node''ları birbirlerini iptal etmemeli
• Tüm pluginlerin Türkçe mesajları tutarlı tonda olmalı (her plugin farklı tarzda konuşmamalı)
• Renk kodları standart (&4 kırmızı, &a yeşil gibi) olmalı — her pluginde farklı renk skalası olmasın

# Tutarlı Mesaj Örneği

# Tüm pluginlerde kullanılacak standart prefix
prefix: '&8[&6Sunucu&8] '

# Hata mesajları: kırmızı + ünlem
error_format: '&c&l! %prefix%&c%message%'

# Başarı mesajları: yeşil + onay
success_format: '&a&l✓ %prefix%&a%message%'

# Uyarı: sarı + dikkat
warn_format: '&e&l⚠ %prefix%&e%message%'

# Ekonomi simgesi: para birimi
currency_symbol: '₺'
currency_name: 'Kredi'
currency_plural: 'Kredi'

# Adım 5: Permission Yapısını Tasarlayın

Grupları ve yetkileri baştan net kurgulayın. Sonradan düzeltmeye çalışmak saatler alır. Önerilen grup yapısı:

default     ← Her yeni oyuncu otomatik
├── member  ← 1 saat oynamışlar
│   ├── vip    ← 1. rütbe bağışçı
│   │   ├── vip+    ← 2. rütbe
│   │   │   └── mvp    ← 3. rütbe
│   └── builder ← Yapı ekibi
├── moderator ← Orta düzey yetkili
│   └── admin  ← Tam yetkili
└── owner     ← Sunucu sahibi (*)

Her grubun inherit ile bir üsttekinden miras alması önemli. Böylece bir yetki sadece üst grupta tanımlanır; alt gruplar otomatik alır.

# LuckPerms ile grup yapısı kurma
/lp creategroup default
/lp creategroup member
/lp creategroup vip
/lp creategroup vip+
/lp creategroup mvp
/lp creategroup builder
/lp creategroup moderator
/lp creategroup admin
/lp creategroup owner

# Miras ilişkileri
/lp group member parent add default
/lp group vip parent add member
/lp group vip+ parent add vip
/lp group mvp parent add vip+
/lp group builder parent add member
/lp group admin parent add moderator
/lp group owner parent add admin

# Yetkiler
/lp group default permission set essentials.help true
/lp group default permission set essentials.spawn true
/lp group member permission set essentials.sethome true
/lp group member permission set essentials.home true
/lp group vip permission set essentials.fly true
/lp group vip+ permission set essentials.nick true
/lp group mvp permission set essentials.god true
/lp group builder permission set worldedit.* true
/lp group admin permission set essentials.ban true
/lp group owner permission set * true

# Adım 6: Ekonomi Sistemini Kalibre Edin

Ekonomi dengesi, paketinizin uzun ömrünü belirler. Dengesiz ekonomi 2 hafta içinde enflasyon yaratır ve oyuncular ayrılır. İyi bir ekonomi şu prensiplerle kurulur:

• Başlangıç parası düşük: Yeni oyuncu 500-1000 kredi ile başlasın, 100.000 ile değil
• Gelir kaynakları çeşitli: Satış, kill reward, oy ödülü, arena sıralaması, playtime
• Para çıkışı gerçek: VIP satın alma, warp kurma, cosmetic (kozmetik ürün), kit açma
• Exponential fiyatlar: Her yükseltme bir öncekinden 1.5x pahalı olsun
• Infinite exploit yok: Bir mob''u 1 saniyede 1000 kere öldürme gibi exploit yolları kapalı

# Örnek Item Satış Fiyatları (Survival)

Alış-satış arasındaki farkın 4x-10x olması, sunucuya para akışının kontrollü olmasını sağlar. Oran 1.5x civarındaysa oyuncular hızla zenginleşir ve ekonomi çöker.

# Adım 7: Anti-Cheat Yapılandırın

Anti-cheat kurulumu plugin yüklemek değildir; saatlerce config kalibre etmeyi gerektirir. En yaygın hatalar:

• Reach check çok sıkı: Lag olan oyuncu banlanıyor. 3.1 blok reach toleransı yerine 3.5 deneyin.
• Speed check statik: Slabı ve jump boost''u hesaba katmıyor. Whitelist kullanın.
• Fly check buggy: Jump pad''ler false positive üretiyor. O bölgeyi bypass''layın.
• Combat check sert: Ok atışları banlanıyor. Projectile check''i gevşetin.
• Killaura check yanlış: Crit yaparken false positive.
• No-swing: 1.9+ swing değişti; checkleri 1.8 ve 1.9+ için ayrı yapın.

Anti-cheat''i 1 hafta test sunucusunda çalıştırmadan productiona almayın. Beta test oyuncularıyla kill aura değil ama normal PvP yapın; hiç kimse ban yemezse hazırsınız.

# Adım 8: Test Süreci

Paketi hazırladığınızda 3 farklı test yapın:

# Test 1: Teknik Test

• Sunucuyu başlat → log''da hata var mı?
• Tüm pluginler yeşil mi? (/plugins)
• MySQL bağlantısı stabil mi?
• Spark ile 5 dakikalık profil al, TPS 19+ mı?
• RAM kullanımı sunucunun %80''i altında mı?
• Chunk gen hızı makul mü?

# Test 2: Oyuncu Testi

• 5-10 beta oyuncuyu 2 gün boyunca sunucuda dolaştırın
• Komutları test etsinler: /home, /tpa, /shop, /rtp
• Ekonomide infinite exploit deneyenleri rapor alın
• PvP yapılsın, false positive var mı?
• Menüler açılsın, GUI glitch var mı?

# Test 3: Stres Testi

• 50+ bot ile login simülasyonu yapın (MinecraftBot vs.)
• Chunk yükleme altında TPS düşüyor mu?
• Aynı anda 30 oyuncu /home yaparsa ne oluyor?
• MySQL connection pool dolmaya yaklaşıyor mu?
• 100 spawner patlama yapıldığında sunucu kilitleniyor mu?

# Adım 9: Dokümantasyon

Paketinizi kendiniz kullanacak olsanız da 6 ay sonra ne yaptığınızı hatırlamak için dokümantasyon şart. Minimum hazırlanacak dosyalar:

• README.md: Genel bakış, mod tipi, temel özellikler
• KURULUM.md: Adım adım kurulum talimatı
• PLUGIN-LIST.md: Tüm pluginler ve sürümleri
• PERMISSIONS.md: Grup ve yetki şeması
• ECONOMY.md: Ekonomi dengesi kararları ve gerekçeleri
• CHANGELOG.md: Her güncellemeyi not alma dosyası

# Adım 10: Bakım ve Güncelleme Stratejisi

Paket bir kere hazırlanıp terk edilemez. Düzenli bakım gerektirir. Minimum takvim:

# Ne Zaman Hazır Pakete Dönmeli?

Kendi paketinizi hazırlamak bu kadar meşakkatliyken neden bir sunucu sahibi bunu yapsın? Sadece şu durumlarda mantıklıdır:

• Oyuncu sayınız 500+ ve özel kimlik istiyorsunuz
• Mod tipiniz uniq (örneğin YemekFactions gibi tam özgün)
• Java/Kotlin geliştirici bir ekibiniz var
• Plugin paketinin ticari hakkını kendiniz istiyorsunuz
• Başkalarına paket satmak istiyorsunuz

Yukarıdakilerden hiçbiri geçerli değilse, hazır bir paket alıp config''leri düzenleyerek özelleştirmek yeterlidir. 100 saatlik emeği küçük bir config fark haline indirirsiniz.

# Yaygın Hatalar

• Çok fazla plugin ekleme: Her pluginin bedeli vardır; 150 plugin TPS yok eder
• Ekonomi testinin atlanması: İlk hafta enflasyon patlaması
• Permission miras sistemini kullanmama: Her gruba aynı yetkileri tek tek yazmak
• Beta test aşamasını atlama: Canlıda hata bulunca geç olur
• Plugin çakışmalarını görmezden gelme: İki /home plugini birden
• Bakım planı yapmama: Paketi 3 ay sonra kimse güncelleyemiyor

# Araçlar ve Kaynaklar Listesi

Sıfırdan plugin paketi hazırlarken kullanacağınız kritik araçlar:

• IntelliJ IDEA Community: Plugin geliştirmek isterseniz ücretsiz Java IDE
• VSCode + YAML eklentisi: Config dosyalarını kalabalık edit ederken hata bulma
• DBeaver: MySQL/MariaDB için grafik arayüz, SQL sorgu çalıştırma
• WinSCP / FileZilla: Windows''tan VPS''e dosya transferi
• MinecraftBot (BotFrame): Stres testi için bot sürüsü oluşturma
• Spark: Profil alma, memory analizi
• Paper dokümantasyonu: docs.papermc.io — kaynak numarası bir rehber
• Spigot forumu: Plugin önerileri ve sorun giderme
• GitHub: Plugin kaynak kodlarını incelemek için
• Markdown editörü: Dokümantasyon yazmak için (Typora, Obsidian)

# Sıfırdan Paket Hazırlama Takvimi

Realist bir zaman planlaması şöyle olur:

Toplamda 90-130 saat. Bu iş tam zamanlı yapılmıyor; günde 2-3 saat ayırsanız 8 hafta eder. Yarı zamanlı bir projeye denk.

# Sık Yapılan Hatalar: Paket Hazırlarken

• Her pluginin varsayılanını kabul etmek: Her plugin''in config''ini okumadan geçmek, sonra neden bu şöyle çalışıyor? diye saatlerce Google''da aramak
• Plugin''lerin yeni sürümlerini denemek: Son stable sürüm yerine latest snapshot yüklemek hatalara kapı açar
• Premium pluginleri karıştırmak: Cracked pluginle ilerlemek sonra güncelleyememek
• Beta''ya oyuncu almamak: Sadece kendi PC''nizde test etmek gerçek koşulları yansıtmaz
• Dokümantasyon yazmamak: 2 ay sonra kendinizin ne yaptığını unutursunuz
• Backup almamak: Test sunucusunda bir hata veri kaybetsin diye izin vermeyin

# Sık Sorulan Sorular

# Sıfırdan paket yaparken hangi pluginleri <q>zorunlu</q> kabul etmeliyim?

Her sunucuda bulunması gereken 7 çekirdek plugin: LuckPerms (permission), Vault (API soyutlama), PlaceholderAPI (dinamik değişken), EssentialsX (temel komutlar), CoreProtect (griefing rollback), Matrix/Vulcan/AAC (anti-cheat) ve bir scoreboard plugini. Bu 7''siz plugin paketi yarım kalır.

# Çok fazla plugin yüklemenin dezavantajı ne?

Her plugin RAM ve CPU tüketir. 100 plugin''li bir sunucu 50 plugin''liden %40 daha fazla RAM ister. Aynı zamanda plugin çakışmaları, event double handling, memory leak riski artar. Her özellik için bir plugin ekleyeceğim tutumu fragilite yaratır. Temel prensip: her plugin''in net bir işlevi olmalı; benzer işlevi yapan ikinci plugin yüklenmemelidir.

# Özel plugin yazdırmak ne kadar sürer ve maliyet ne?

Basit bir custom plugin (örneğin voted oyunculara otomatik ödül) 2-4 saatte yazılır ve piyasa fiyatı 200-500 TL''dir. Orta karmaşıklıkta biri (örneğin SkyBlock''ta ada sıralaması API''si) 10-20 saat ve 1500-3000 TL. Kompleks biri (özel dövüş sistemi, MMORPG mekaniği) 50+ saat ve 5000+ TL olabilir.

# Ekonomi testini nasıl hızlandırırım?

Gerçek test 2-4 haftalık canlı izleme ister. Ama simülasyon ile hızlandırabilirsiniz: Excel/Python ile her dakika oyuncuların teorik olarak kazanabileceği para akışını modelleyin. Başlangıçta 0 para, günde X saat oynayan ortalama oyuncu 1 haftada ne kadar kazanır? Bu rakam toplam sunucu ekonomisinin %5''ini geçmemeli.

# Test sunucusu için kaynak nasıl ayırmalı?

Test sunucusu production''ın %50 RAM''i ile çalıştırılabilir. Örneğin production 8 GB ise test 4 GB yeterli. Önemli olan plugin listesinin aynı olması; kaynak daha düşük olabilir. Test sunucusunu her zaman ayrı bir VPS''te tutun, asla production''la aynı makinede çalıştırmayın.

# Test Sunucu vs Production Sunucu Ayrımı

Ciddi sunucular her zaman iki sunucu çalıştırır: test ve production. Test sunucusunda denemeler yapılır; production''da sadece onaylanmış değişiklikler uygulanır. Bu ayrım yapmayan sunucu sahipleri günde 2-3 kez oyuncularını restart''larla rahatsız eder.

# Test Sunucusu Karakteristikleri

• RAM: Production''ın yarısı yeterli (örn: 2 GB)
• Oyuncu: Sadece staff ve beta test grubu (max 10)
• Dünya: Production dünyasının kopyası veya flat world
• Plugin: Production ile aynı sürümler + yeni test edilen
• Config: Production''dan çoğalt, sadece DB/port farklı
• Port: 25566 gibi farklı port

# Değişiklik Akışı

1. Plugin güncellemesi veya config değişikliği yapılır
        ↓
2. Test sunucusunda denenir
        ↓
3. Beta oyuncular feedback verir
        ↓
4. 2-3 gün stabil test edilir
        ↓
5. Production''a deploy edilir

Bu akış bir değişikliği doğrulamayı uzatır ama production''da hata çıkma olasılığını %90 düşürür.

# Versiyon Kontrol: Git ile Paket Yönetimi

Profesyonel sunucu yöneticileri plugin paketinizi git repository''si olarak takip eder. Her değişiklik commit''lenir, geri dönme (rollback) 1 saniyede yapılır. Kurulum:

# Sunucu klasöründe git başlat
cd /home/minecraft/sunucu
git init

# .gitignore yap — büyük/hassas dosyalar commit olmasın
cat > .gitignore <<EOF
world/
world_nether/
world_the_end/
logs/
cache/
backups/
crash-reports/
banned-players.json
banned-ips.json
*.jar.old
EOF

# İlk commit
git add .
git commit -m 'İlk paket kurulumu'

# Değişiklik sonrası
git add plugins/EssentialsX/config.yml
git commit -m 'EssentialsX: /home limiti 3->5 çıkarıldı'

# Geri dönmek isterseniz
git log                   # commit''leri görün
git revert <commit-id>    # spesifik commit''i geri al

# Plugin Güncelleme İş Akışı

Hazır paketi kendiniz yönetiyorsanız güncellemeleri sistemli yapın:

• Güncelleme öncesi full backup (world + plugins)
• Test sunucuda önce deneme
• Config değişiklikleri için changelog oku
• Breaking change varsa migrasyon planı hazırla
• Güncelleme sonrası 30 dakika sunucuyu izle
• Sorun olursa hızlıca geri dön

# Özet

Sıfırdan plugin paketi hazırlamak 10 adımda tamamlanır: mod tipi → plugin stack → plugin seçim → config birleştirme → permission tasarımı → ekonomi kalibrasyonu → anti-cheat → test → dokümantasyon → bakım. Her adım kendi başına 1-2 gün sürer; toplamda 80-120 saatlik bir projedir. Doğru araçlar, net bir takvim, sistematik bir yaklaşım ve gerçek beta test süreci ile profesyonel bir çıktıya ulaşabilirsiniz. Git versiyon kontrolü ile her değişikliği takip edin, güncellemeleri sistemli yönetin. Alternatifi daha ucuz: hazır paket alıp kişiselleştirin. Ama kendi paketinizi yapmaya karar verdiyseniz bu rehber sizi kısa yoldan profesyonel çıktıya götürür.

Kendi paketinizi yapmaya niyetlendiyseniz zaman yönetimi en kritik unsurdur. Haftada 3-4 saat ayırabilirseniz proje 6-8 ayda tamamlanır. Daha az ayırabilirseniz 1 yılı aşabilir. Bu süreyi ayırmayacaksanız hazır pakete dönmek mantıklıdır; hem paranızı hem zamanınızı daha verimli kullanırsınız.

Son tavsiye: öğrenme amacıyla sıfırdan paket hazırlamak harika bir pratiktir. Production için kullanmasanız bile süreç size plugin ekosistemi, performans, config ve oyuncu yönetimi konularında değerli deneyim kazandırır. Başlangıçta küçük bir test sunucusu için basit bir paket hazırlayın; oradan büyüyerek profesyonel çıktıya ulaşın.