Skip to content

KEYDALTR/kBungeeCord

Repository files navigation

kBungeeCord

Hazır yapılandırılmış, prodüksiyona hazır BungeeCord proxy paketi. 1.8'den 1.21.x'e kadar tam sürüm desteği, güvenlik eklentileri ve tek komutla kurulum.

License: MIT BungeeCord Java Platform KEYDAL Projects

Kurulum · Konfigürasyon · Sorun Giderme


Hakkında

kBungeeCord, Minecraft sunucu sahipleri için hazır yapılandırılmış bir BungeeCord proxy paketidir. Açtığınız anda çalışır: güvenlik eklentileri yüklü, ip forwarding doğru ayarlanmış, çoklu sürüm desteği hazır ve optimize edilmiş JVM flag'leri ile gelir.

Geliştirici: Egemen KEYDAL Kurum: KEYDALTR Web: keydal.net · keydal.tr Lisans: MIT — ücretsiz, açık kaynak, ticari kullanıma açık.


Özellikler

  • Hazır yapılandırılmış — Açtığın anda kullanıma hazır, sıfırdan config yazmayacaksın.
  • 1.8 → 1.21.x sürüm desteği — ViaVersion + ViaBackwards + ViaBungee ile tüm sürümler.
  • Güvenli IP forwarding — BungeeGuard token doğrulaması ile proxy bypass koruması.
  • LuckPerms entegrasyonu — Hazır yetki sistemi, web editör desteği.
  • Cracked mod desteği — SkinsRestorer ile premium skin gösterimi.
  • Markalı MOTD — MiniMOTD ile gradient renkli sunucu listesi mesajı.
  • İnteraktif kurulum sihirbazısetup.sh / setup.bat ile port, RAM, MOTD tek komutla.
  • Optimize JVM flags — Aikar's Flags, G1GC tuned, 512MB'dan itibaren.
  • Çift platform — Linux (bash) ve Windows (batch) başlatma scriptleri.

Kurulum

1. Paketi indir

# Git ile klonla
git clone https://github.com/KEYDALTR/kBungeeCord.git
cd kBungeeCord

Git kurulu değilse: GitHub sayfasından Code → Download ZIP ile indirebilirsin.

2. İnteraktif setup'ı çalıştır (önerilen)

# Linux / macOS
chmod +x setup.sh && ./setup.sh

# Windows
setup.bat

Setup sihirbazı sana şunları soracak:

  • Proxy portu (varsayılan: 25565)
  • Maksimum oyuncu sayısı (varsayılan: 100)
  • RAM miktarı (varsayılan: 512 MB)
  • Backend sunucu adresleri (lobi, ana sunucu)
  • MOTD mesajı

3. BungeeGuard token'ını ayarla

plugins/BungeeGuard/config.yml dosyasını aç ve güçlü bir token üret:

# Güvenli token üretmek için
openssl rand -hex 32
allowed-tokens:
  - "buraya-uretilen-tokeni-gir"

Önemli: Backend sunucularına da BungeeGuard kurup aynı token'ı girmelisin.

4. Backend sunucularını hazırla

Her backend Spigot/Paper sunucusunda:

# spigot.yml
settings:
  bungeecord: true
# server.properties
online-mode=false

5. Başlat

# Linux / macOS
./baslat.sh

# Windows
baslat.bat

Sunucu Yapısı

[Oyuncu] ──▶ [kBungeeCord :25565]
                      │
                      ├── lobi      (varsayılan giriş, :25566)
                      └── sunucu    (oyun sunucusu, :25567)

force_default_server: true sayesinde her bağlanan oyuncu lobiye düşer. Lobi kapanırsa priorities listesindeki sıradaki sunucuya yönlendirilir.


Eklentiler

Eklenti Sürüm Görev
BungeeCord Latest Ana proxy yazılımı
ViaBungee 0.2.0 Proxy-side sürüm çeviri köprüsü
ViaVersion 5.7.2 Yeni sürümlü oyuncuların eski sunuculara bağlanması
ViaBackwards 5.7.2 Eski sürümlü oyuncuların yeni sunuculara bağlanması
BungeeGuard Latest IP forwarding güvenlik token doğrulaması
LuckPerms 5.5.36 Network-wide yetki yönetimi
SkinsRestorer Latest Cracked modda skin yönetimi
MiniMOTD 2.2.2 Gradient renkli, markalı MOTD

plugins/ViaVersion/ klasörü ViaVersion ve ViaBackwards jar'larını içerir. Bu, ViaBungee'nin beklediği yapıdır.


⚙️ Konfigürasyon

Ana config

config.yml dosyasında backend sunucu adreslerini değiştir:

servers:
  lobi:
    motd: '&b&lKEYDAL &7- &fLobi'
    address: 127.0.0.1:25566
    restricted: false
  sunucu:
    motd: '&b&lKEYDAL &7- &fSunucu'
    address: 127.0.0.1:25567
    restricted: false

Yeni backend eklemek için servers altına yeni blok, priorities listesine de ekle.

MOTD özelleştirme

plugins/minimotd-bungee/main.conf dosyasından düzenle. 64x64 PNG dosyasını plugins/minimotd-bungee/icons/ klasörüne atarak sunucu ikonunu değiştirebilirsin.

Önemli ayarlar

Ayar Varsayılan
Port 25565
Online Mode Kapalı (cracked)
IP Forward Açık (BungeeGuard ile)
RAM 512 MB
Sürüm Desteği 1.8 → 1.21.x
Connection Throttle 4000ms
Max Players 100

Velocity mi, BungeeCord mu?

kBungeeCord Velocity
Minimum MC sürümü 1.8 1.16.5
Forwarding ip_forward + BungeeGuard Modern (native)
Java 8+ 17+
Performans İyi Daha iyi
Eklenti desteği Çok geniş Büyüyor
1.8 PvP desteği

kBungeeCord'u seç: 1.8 PvP sunucun varsa, geniş eklenti uyumluluğu gerekiyorsa, eski Java sürümlerinde çalıştıracaksan.


Güvenlik

  • BungeeGuard token'ını güçlü seç ve kimseyle paylaşma. Token'ı bilen biri backend'lere doğrudan bağlanarak yetki bypass'ı yapabilir.
  • Backend portlarını firewall ile dışarıya kapat — sadece proxy IP'sinden erişim aç:
    # iptables örnek
    iptables -A INPUT -p tcp --dport 25566 -s 127.0.0.1 -j ACCEPT
    iptables -A INPUT -p tcp --dport 25566 -j DROP
  • Online mode kapalı olduğundan backend'lere AuthMe veya benzeri bir doğrulama eklentisi kur.
  • ViaVersion paket sınırları temel bot saldırılarını yavaşlatır. Ciddi DDoS koruması için TCPShield öneriyoruz.

Sorun Giderme

Oyuncular bağlanamıyor
  • config.yml'daki backend IP ve port'larını kontrol et.
  • Backend sunucularının çalıştığını doğrula.
  • Firewall'da 25565 portunu aç.
  • Proxy ve backend arasında ping atabildiğini test et.
"If you wish to use IP forwarding..." uyarısı
  • Backend spigot.yml'da bungeecord: true olmalı.
  • Backend server.properties'te online-mode=false olmalı.
  • BungeeGuard hem proxy'de hem backend'de kurulu olmalı.
  • Token'ların tam olarak aynı olduğunu doğrula.
ViaVersion yüklenmiyor / sürüm desteği çalışmıyor
  • ViaVersion-*.jar ve ViaBackwards-*.jar dosyaları plugins/ViaVersion/ klasöründe olmalı, doğrudan plugins/ içinde değil.
  • ViaBungee-*.jar ise doğrudan plugins/ içinde olmalı.
  • Logları kontrol et: logs/latest.log içinde "ViaBungee loaded" mesajını ara.
Port 25565 zaten kullanımda
  • Başka bir proxy/sunucu çalışıyor olabilir. setup.sh ile farklı bir port seç.
  • Linux: lsof -i :25565 ile kim kullanıyor bak.
  • Windows: netstat -ano | findstr :25565
OutOfMemoryError
  • baslat.sh / baslat.bat içinde -Xmx değerini artır (örn. 1024M).
  • 100+ oyunculu sunucular için minimum 1 GB öneriyoruz.

Katkıda Bulunma

Pull request'ler açıktır. Büyük değişiklikler için önce bir issue açarak tartışmak istediğin konuyu belirt.

  1. Fork'la
  2. Feature branch oluştur (git checkout -b feature/harika-ozellik)
  3. Commit'le (git commit -m 'feat: harika özellik ekle')
  4. Push'la (git push origin feature/harika-ozellik)
  5. Pull Request aç

Lisans

Bu proje MIT Lisansı altında dağıtılmaktadır. Detaylar için LICENSE dosyasına bakın.

Paketle birlikte gelen üçüncü parti eklentiler (BungeeCord, LuckPerms, ViaVersion, vb.) kendi lisanslarına tabidir.


Geliştiren: Egemen KEYDAL Kurum: KEYDALTR · keydal.net · keydal.tr

Bu proje toplumun faydası için ücretsiz olarak sunulmaktadır. Beğendiysen ⭐ vermeyi unutma!

About

Hazır yapılandırılmış BungeeCord proxy paketi. 1.8 → 1.21.x sürüm desteği, güvenlik eklentileri ve tek komutla kurulum. KEYDALTR tarafından.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors