Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://support.zonely.gen.tr/llms.txt

Use this file to discover all available pages before exploring further.

​
Minecraft Web Client

Minecraft Web Client, oyuncuların Minecraft launcher kurmadan doğrudan tarayıcı üzerinden sunucuna giriş yapmasını sağlar. Oyuncular web giriş sayfasını açar, kullanıcı adını yazar ve sunucuya bağlanır. Sunucu tarafındaki bağlantı ayarları panel üzerinden hazırlanır.
Kurulum için yönetim panelindeki Minecraft Web Client eklentisini aktif etmen yeterlidir.

​
Kurulumdan Önce Bilmen Gerekenler

Web Client tarafında normal Minecraft IP’si yerine genellikle wss:// ile başlayan bağlantı adresi kullanılır. Normal Minecraft adresi: 
play.sunucun.com
Web Client adresi: 
wss://play.sunucun.com
Portlu kullanım: 
wss://play.sunucun.com:8081
Siten https:// ile açılıyorsa bağlantı adresinin de wss:// ile başlaması gerekir. ws:// bağlantıları güvenli sitelerde çalışmayabilir.

​
Web Client Eklentisini Aktif Et

1

Yönetim paneline gir

Site veya sunucu yönetim paneline giriş yap.
2

Eklentiler bölümünü aç

Ayarlar > Eklentiler bölümüne gir.
3

Minecraft Web Client eklentisini bul

Listeden Minecraft Web Client eklentisini aç.
4

Eklentiyi aktif et

Eklentiyi aktif et ve ayar sayfasına geç.
5

Web Client bağlantısını kopyala

Panelde verilen wss:// bağlantısını olduğu gibi kopyala.
Panelde görünen bağlantı genellikle şu formatlardan biri olur: 
wss://sunucu-adresiniz
veya: 
wss://sunucu-adresiniz:port
En sağlıklı kullanım için panelde verilen adresi değiştirmeden kullan.

​
Oyunculara Hangi Adres Verilecek?

Oyunculara Web Client sayfasının linkini verebilirsin. Örnek: 
https://siteniz.com/web-join
Oyuncu sayfaya girdiğinde kullanıcı adını yazar ve bağlantı bilgisi hazırsa direkt sunucuya girer. Eğer Web Client sunucu adresi isterse, oyuncu normal Minecraft IP’si yerine panelde verilen wss:// adresini girmelidir. Doğru: 
wss://play.sunucun.com
Yanlış: 
play.sunucun.com

​
Sunucu Tarafı Kurulum

Web Client bağlantısının çalışması için sunucu tarafında EaglerXServer kullanılır. EaglerXServer, tarayıcı tabanlı Minecraft istemcilerinin Spigot, Paper, BungeeCord veya Velocity sunucularına bağlanabilmesini sağlayan sunucu tarafı plugindir.
Normal kurulum için çoğu zaman sadece EaglerXServer.jar dosyası yeterlidir. Diğer jar dosyaları ek özellikler içindir.

​
İndirme Linkleri

GitHub Releases

Tüm EaglerXServer sürümlerini ve jar dosyalarını bu sayfadan indirebilirsin.

EaglerXServer.jar

Ana plugin. Normal kurulumda ilk indirilecek dosyadır.

EaglerXRewind.jar

Eski 1.5.2 istemci desteği gerekiyorsa kullanılır.

EaglerXBackendRPC.jar

BungeeCord veya Velocity API özelliklerini backend Spigot/Paper tarafında kullanmak için eklenir.

EaglerMOTD.jar

Web Client oyuncuları için MOTD özelliği ekler.

EaglerWeb.jar

Sunucu adresi üzerinden HTTP dosya yayınlamak için kullanılır.

EaglerXPlan.jar

Plan player analytics eklentisiyle Eagler oyuncularını analiz etmek için kullanılır.

EaglerXSupervisor.jar

Çoklu proxy kurulumlarında kullanılan standalone supervisor servisidir.

​
Hangi Dosya Gerekli?

Çoğu sunucu için sadece şu dosya yeterlidir:
EaglerXServer.jar
Tüm jar dosyalarını rastgele kurmana gerek yok. Önce sadece EaglerXServer.jar ile başlamak daha sağlıklıdır.

​
EaglerXServer Kurulumu

1

Java sürümünü kontrol et

Java 17 veya üzeri kullanman önerilir.
java -version
2

Ana plugin dosyasını indir

EaglerXServer.jar dosyasını indir.
3

Plugins klasörüne at

Dosyayı sunucunun plugins klasörüne yükle.
/plugins/EaglerXServer.jar
4

Sunucuyu yeniden başlat

Sunucuyu yeniden başlat. İlk açılışta plugin kendi ayar dosyalarını oluşturur.
5

Ayarları kontrol et

Bağlantı çalışmazsa plugin config dosyalarını, portları ve listener ayarlarını kontrol et.
BungeeCord veya Velocity kullanıyorsan listener ve inject_address ayarlarını ayrıca kontrol etmen gerekebilir.

​
EaglerXServer Ek Modülleri

EaglerXServer release sayfasında birden fazla jar dosyası görünür. Bunların hepsini kurmak zorunda değilsin.

EaglerXServer

Ana bağlantı pluginidir. Web Client oyuncularının sunucuya bağlanmasını sağlar.

EaglerXRewind

Eski Eaglercraft 1.5.2 istemcileri desteklemek için kullanılır.

EaglerXBackendRPC

Proxy tarafındaki Eagler API’sine backend Spigot/Paper sunucularından erişmek için kullanılır.

EaglerMOTD

Web Client oyuncuları için MOTD tarafında ek özellikler sağlar.

EaglerWeb

Sunucu adresinden HTTP dosyaları veya web içeriği yayınlamak için kullanılır.

EaglerXPlan

Plan analytics eklentisiyle Eagler oyuncularını takip etmek için kullanılır.

EaglerXSupervisor

Çoklu proxy yapılarında proxy’leri senkronize etmek için kullanılan standalone servistir.

​
RPC Nedir?

RPC, proxy tarafındaki EaglerXServer özelliklerine backend Spigot/Paper sunucularından erişmek için kullanılır. Bu özellikle BungeeCord veya Velocity kullanan yapılarda işe yarar. Örnek yapı: 
Oyuncu
  -> BungeeCord / Velocity
  -> Backend Spigot / Paper sunucusu
Bu yapıda EaglerXServer proxy tarafında çalışıyorsa, backend Spigot sunucusundaki özel pluginlerin Eagler oyuncularını tanıması veya Eagler API’sindeki bazı bilgilere erişmesi gerekebilir. Bunun için EaglerXBackendRPC.jar kullanılır.

​
RPC Ne Zaman Gerekir?

Sadece oyuncuların Web Client üzerinden sunucuya girmesini istiyorsan RPC kurman gerekmez.Normal kurulumda EaglerXServer.jar yeterlidir.

​
RPC Kurulumu

1

Proxy tarafında EaglerXServer kurulu olsun

BungeeCord veya Velocity tarafında EaglerXServer.jar çalışıyor olmalıdır.
2

Backend sunucuya RPC jar dosyasını ekle

Backend Spigot/Paper sunucusunun plugins klasörüne şunu ekle:
EaglerXBackendRPC.jar
3

RPC ayarını aç

EaglerXServer ayarlarında backend RPC desteğini aktif et.
enable_backend_rpc_api: true
4

Sunucuları yeniden başlat

Hem proxy tarafını hem backend sunucuları yeniden başlat.
RPC ileri seviye kullanım içindir. Sadece normal Web Client girişi için gerekli değildir.

​
Ses / Voice Chat Ayarı

EaglerXServer içinde Eagler oyuncuları için voice chat servisi ayarları bulunur. Bu özellik varsayılan olarak kapalıdır. 
enable_voice_service: false
Ses özelliğini kullanmak istiyorsan ayar dosyasında voice servisini açabilirsin: 
enable_voice_service: true
Voice chat özelliği büyük public sunucularda dikkatli kullanılmalıdır. Açmadan önce rate limit, performans ve güvenlik ayarlarını kontrol etmen önerilir.

​
Ses Ayarlarında Bilmen Gerekenler

enable_voice_service

Ses sistemini açar veya kapatır. Varsayılan olarak kapalıdır.

enable_voice_all_servers

BungeeCord veya Velocity tarafında tüm sunucularda voice kullanımını belirler.

enable_voice_all_worlds

Bukkit tarafında tüm dünyalarda voice kullanımını belirler.

separate_server_voice_channels

Her sunucunun ayrı voice kanalı kullanıp kullanmayacağını belirler.

separate_world_voice_channels

Her dünyanın ayrı voice kanalı kullanıp kullanmayacağını belirler.

voice_backend_relayed_mode

Voice paketlerinin backend Spigot sunucusu üzerinden yönetilmesini sağlar. Bu kullanım için RPC gerekir.

​
STUN / TURN Sunucuları

Voice sistemi WebRTC mantığıyla çalıştığı için STUN/TURN sunucuları kullanılabilir. Varsayılan olarak bazı STUN sunucuları gelir: 
stun:stun.l.google.com:19302
stun:stun1.l.google.com:19302
stun:stun2.l.google.com:19302
stun:stun3.l.google.com:19302
stun:stun4.l.google.com:19302
Bazı ağlarda sadece STUN yeterli olmayabilir. Daha sağlam voice bağlantısı için kendi TURN sunucun gerekebilir.

​
Cloudflare ve WSS Ayarı

Web Client bağlantısı için özel bir alt alan adı kullanmak istiyorsan Cloudflare üzerinden wss kaydı oluşturabilirsin. Örnek WSS adresi: 
wss://wss.siteadresin.com
Cloudflare DNS kaydı: 
Type: A
Name: wss
IPv4 address: Sunucu IP adresin
Proxy status: Proxied
Kolay kullanım için Cloudflare tarafında proxy durumu Proxied olarak kalabilir.
Cloudflare SSL/TLS bölümünde kolay kurulum için şu mod kullanılabilir: 
SSL/TLS encryption mode: Flexible
Daha güvenli kurulumlarda Full strict kullanılabilir. Bunun için sunucu tarafında SSL sertifikası gerekir.

​
Alternatif: XAMPP / Apache Proxy

Bu bölüm sadece ayrı WebSocket proxy kullanıyorsan gereklidir. Panelde verilen bağlantı ve EaglerXServer kurulumu işini görüyorsa bu bölümü atlayabilirsin.

​
Apache Ayarı

httpd.conf dosyasında şu modüller aktif olmalıdır: 
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so
httpd-vhosts.conf dosyasına şu yapı eklenebilir: 
<VirtualHost *:80>
    ServerName wss.siteadresin.com

    ProxyRequests Off
    ProxyPreserveHost On

    ProxyPass / ws://127.0.0.1:8081/
    ProxyPassReverse / ws://127.0.0.1:8081/
</VirtualHost>
wss.siteadresin.com kısmını kendi alan adınla değiştir. 8081 ise WebSocket proxy’nin çalıştığı porttur.

​
Sürüm Uyumluluğu

Oyuncular farklı Minecraft sürümleriyle giriş yapacaksa sürüm uyumluluk eklentileri gerekebilir. Kullanılabilecek eklentiler:
  • ViaVersion
  • ViaBackwards
  • ViaRewind
  • EaglerXRewind
Sunucu ve oyuncular aynı sürümü kullanıyorsa bu eklentiler her zaman gerekli olmayabilir.

​
Test Etme

Kurulumdan sonra şu şekilde test edebilirsin:
1

Web Client sayfasını aç

Oyuncuların kullanacağı web giriş sayfasına gir.
2

Kullanıcı adı yaz

Test için bir kullanıcı adı gir.
3

WSS adresini gir

Sunucu adresi alanına paneldeki veya hazırladığın wss:// adresini gir.
4

Bağlanmayı dene

Bağlan butonuna bas ve sunucuya giriş yapmayı test et.
Giriş başarılıysa kurulum tamamlanmıştır.

​
Sık Karşılaşılan Sorunlar

Panelde verilen wss:// adresinin doğru yazıldığından emin ol. Normal Minecraft IP’si yerine Web Client bağlantısı kullanılmalıdır.
Sunucu kapalı olabilir, Web Client eklentisi aktif olmayabilir veya plugin düzgün yüklenmemiş olabilir.
Siten https:// ile açılıyorsa bağlantı adresi de wss:// ile başlamalıdır. ws:// bağlantıları güvenli sitelerde çalışmayabilir.
Java sürümü, sunucu sürümü, port veya listener ayarları uyumsuz olabilir.
Proxy tarafında backend RPC desteği açık olmayabilir veya EaglerXBackendRPC.jar backend Spigot/Paper sunucusuna kurulmamış olabilir.
enable_voice_service kapalı olabilir, STUN/TURN ayarları eksik olabilir veya oyuncuların tarayıcı mikrofon izni kapalı olabilir.
ViaVersion, ViaBackwards, ViaRewind veya EaglerXRewind gibi uyumluluk eklentileri gerekebilir.

​
Kurulum Tamam

Minecraft Web Client kurulumu tamamlandı. Artık oyuncularına web giriş bağlantısını paylaşabilirsin. Oyuncular launcher kurmadan doğrudan tarayıcı üzerinden sunucuna giriş yapabilir.

Kısa Özet

Panelden Minecraft Web Client eklentisini aktif et ve panelde verilen wss:// adresini kullan. Manuel sunucu tarafı kurulum gerekiyorsa EaglerXServer.jar dosyasını plugins klasörüne at. RPC ve voice özellikleri normal giriş için şart değildir; sadece ihtiyaç varsa açılmalıdır.