Web Panel Dosya Yöneticisi Kullanımı

Web panel dosya yöneticisi, Minecraft sunucunuzun tüm dosyalarını tarayıcı üzerinden gördüğünüz, yüklediğiniz ve düzenlediğiniz bölümdür. Panele girip sunucunuzu seçtikten sonra “Files” (Dosyalar) sekmesine tıklarsınız; karşınıza sunucunun kök klasörü çıkar. Eklenti yüklemek, server.properties düzenlemek, dünya klasörünü indirmek ve modpack ZIP’i açmak için gereken her şey bu tek ekranda yapılır. FTP programına, SSH bağlantısına ya da komut satırına gerek yoktur.

Bu rehber, paneli ilk kez açan biri için yazıldı. Klasör yapısının ne anlama geldiğini, dosya yükleme ve düzenlemenin doğru sırasını, ZIP açmayı, izinleri ve büyük dosyalarda karşınıza çıkan yükleme sınırını adım adım göreceksiniz. Panelin genel kullanımını hiç bilmiyorsanız önce web panel ile Minecraft sunucusu kurma sayfasını okuyun; burada doğrudan dosya tarafına odaklanıyoruz.

Dosya Yöneticisi Nerede? Panele Girip Ekranı Tanıyalım#

Oyun sunucusu panellerinin büyük çoğunluğu Pterodactyl ya da ondan çatallanan Pelican tabanlıdır. Arayüz renkleri sağlayıcıya göre değişse de sekme adları aynıdır. Sunucunuzu açtığınızda şu sekmeleri görürsünüz:

Console

Sunucu konsolu. Komut yazdığınız, log akışını izlediğiniz yer. Ayrıntı için panel konsolundan komut çalıştırma sayfasına bakın.

Files

Dosya yöneticisi. Bu sayfanın konusu.

Databases

Eklentilerin kullandığı MySQL veritabanları.

Backups

Yedek alma ve geri yükleme bölümü.

Startup

Başlatma değişkenleri: Minecraft sürümü, jar dosyası adı, Java sürümü (Docker Image).

Settings

SFTP bilgileri, sunucu adı ve yeniden kurulum düğmesi.

“Files” sekmesine tıkladığınızda üstte /home/container yazan bir yol çubuğu (breadcrumb) görürsünüz. Bu, sunucunuzun kök dizinidir; panelde bu klasörün dışına çıkamazsınız ve çıkmanız da gerekmez. Sağ üstte “New File” (Yeni Dosya), “New Folder” (Yeni Klasör) ve “Upload” (Yükle) düğmeleri bulunur. Her satırın sağındaki üç nokta menüsünde ise yeniden adlandırma, taşıma, kopyalama, indirme, arşivleme ve silme seçenekleri vardır.

Sunucu Klasör Yapısı: Hangi Dosya Ne İşe Yarar?#

Dosya yöneticisini açtığınızda karşınıza çıkan liste ilk bakışta kalabalık görünür. Aslında düzen basittir. Tipik bir Paper sunucusunun kök dizini şöyledir:

/home/container/
├── server.jar             <-- sunucu yazılımı (Paper, Purpur, Fabric...)
├── server.properties      <-- temel sunucu ayarları
├── eula.txt               <-- eula=true olmalı
├── ops.json               <-- OP yetkisi olan oyuncular
├── whitelist.json         <-- beyaz liste
├── banned-players.json    <-- yasaklı oyuncular
├── plugins/               <-- eklenti .jar dosyaları buraya
├── mods/                  <-- modlu sunucuda mod .jar dosyaları
├── world/                 <-- ana dünya
├── world_nether/          <-- Nether boyutu
├── world_the_end/         <-- End boyutu
├── logs/                  <-- günlük kayıtları
└── cache/                 <-- geçici dosyalar, silinebilir

En sık dokunacağınız dosyaları tablo hâlinde toplayalım:

server.properties içindeki her satırın ne yaptığını merak ediyorsanız server.properties ayarlarının tam listesi sayfasında hepsi tek tek açıklanıyor.

Dosya Yükleme: Sürükle Bırak ve “Upload” Düğmesi#

Panelde dosya yüklemenin iki yolu vardır ve ikisi de aynı sonucu verir.

1. Hedef klasöre girin#

   Bu en kritik adımdır. Eklenti yüklüyorsanız önce plugins klasörüne çift tıklayıp içine girin. Üstteki yol çubuğunda /home/container/plugins yazdığını doğrulayın. Kök dizinde dururken yüklenen bir eklenti hiçbir zaman çalışmaz.

2. Dosyayı sürükleyip bırakın#

   Bilgisayarınızdaki .jar dosyasını fare ile tutup panel penceresinin üzerine bırakın. Ekranın ortasında “Drag and drop files to upload” benzeri bir kutu belirir. Bırakınca yükleme çubuğu görünür.

3. Ya da “Upload” düğmesini kullanın#

   Sağ üstteki Upload düğmesine basıp klasik dosya seçme penceresinden dosyayı seçin. Ctrl tuşuyla birden fazla dosya seçebilirsiniz; panel hepsini sırayla yükler.

4. Yüklemenin bittiğini doğrulayın#

   Liste yenilendiğinde dosya adı, boyutu ve değiştirilme tarihi görünür. Boyut 0 B görünüyorsa yükleme yarım kalmıştır; dosyayı silip yeniden yükleyin.

5. Sunucuyu yeniden başlatın#

   Konsol sekmesine geçip Restart düğmesine basın. Eklenti ya da mod, ancak sunucu yeniden açıldığında yüklenir.

Eklenti yükleme konusunun tamamını adım adım gösteren ayrı bir sayfamız var: web panelden Minecraft plugin yükleme.

Dosya Oluşturma ve Metin Düzenleyicide Değişiklik Yapma#

Panelin gömülü bir metin düzenleyicisi vardır. Bir dosyanın adına tıkladığınızda (indirmek yerine) düzenleyici açılır; satır numaraları ve renkli sözdizimi vurgusu ile birlikte gelir. YAML, JSON, properties ve düz metin dosyalarını burada rahatça düzenleyebilirsiniz.

Örneğin sunucunuzun görünen adını ve zorluk seviyesini değiştirmek isterseniz server.properties dosyasını açıp şu satırları düzenlersiniz:

motd=Batihost Test Sunucusu
difficulty=normal
max-players=40
view-distance=8
simulation-distance=6
enable-command-block=false

Düzenleme bitince sağ alttaki Save Content (İçeriği Kaydet) düğmesine basın. Kaydetmeden sekme değiştirirseniz yaptığınız değişiklikler kaybolur. Bazı panellerde Ctrl + S kısayolu da çalışır.

Yeni bir dosya oluşturmak için sağ üstteki New File düğmesini kullanırsınız. Panel önce dosya adını, sonra içeriği sorar. Örneğin sunucunuz EULA hatası veriyorsa eula.txt dosyasını açıp içeriği şu hâle getirmeniz yeterlidir:

#By changing the setting below to TRUE you are indicating your agreement to our EULA.
eula=true

Bu hatayla ilk kurulumda çok karşılaşılır; ayrıntısı Minecraft EULA hatası çözümü sayfasında.

ZIP Dosyası Yükleme ve Panelde Açma#

Modpack server pack’i, hazır bir harita ya da toplu eklenti paketi yüklerken ZIP kullanırsınız. Sıra şudur:

1. ZIP’i doğru klasöre yükleyin#

   Harita yüklüyorsanız kök dizine, eklenti paketi yüklüyorsanız plugins içine yükleyin. Arşiv, bulunduğu klasörün içine açılır; yanlış yerde açılan bir arşivi toplamak zahmetlidir.

2. Sağdaki üç nokta menüsünü açın#

   Dosya satırının en sağındaki üç nokta simgesine tıklayın. Menüde Unarchive ya da panelin sürümüne göre Decompress yazar.

3. Açılmasını bekleyin#

   Büyük arşivlerde bu işlem birkaç dakika sürebilir. Panel arka planda çalışır; sekmeyi kapatmayın, sayfayı yenilemeyin.

4. İçeriği kontrol edin ve ZIP’i silin#

   Açılan klasörlerin doğru yerde olduğunu doğrulayın. Bazı arşivler tek bir üst klasörün içine açılır; bu durumda içerikleri bir seviye yukarı taşımanız gerekir. İşiniz bitince ZIP dosyasını silin, boş yere disk yer.

Klasör İşlemleri: Taşıma, Kopyalama, Yeniden Adlandırma, Silme#

Dosya adının solundaki kutucuğu işaretlediğinizde ekranın altında toplu işlem çubuğu belirir. Birden çok dosyayı aynı anda taşıyabilir, silebilir ya da arşivleyebilirsiniz.

• Rename (Yeniden adlandır): Dosya adını değiştirir. Bir eklentiyi geçici olarak devre dışı bırakmak için Essentials.jar adını Essentials.jar.disabled yapmak yaygın bir yöntemdir; sunucu .jar uzantısı olmayan dosyayı yüklemez.
• Move (Taşı): Hedef yolu elle yazarsınız, örneğin /plugins/eski. Klasör yoksa panel oluşturur.
• Copy (Kopyala): Aynı klasöre “dosya adı copy” şeklinde bir kopya bırakır. Riskli bir düzenlemeden önce yapılacak en hızlı yedektir.
• Download (İndir): Dosyayı bilgisayarınıza indirir. Klasörleri doğrudan indiremezsiniz; önce arşivlemeniz gerekir.
• Archive (Arşivle): Seçtiğiniz dosya ve klasörleri .tar.gz olarak paketler. Dünya klasörünü indirmek için doğru yol budur.
• Delete (Sil): Kalıcı olarak siler. Onay penceresi çıkar ama geri alma yoktur.

Dosya İzinleri, Sahiplik ve Panelde Görünmeyen Ayrıntılar#

Kendi VDS’inizde sunucu kurarken chmod ve chown ile boğuşursunuz. Panelde bu iş sizden alınmıştır: yüklediğiniz her dosya otomatik olarak sunucunun çalıştığı kullanıcıya ait olur ve doğru izinlerle kaydedilir. Bu yüzden panelde “Permission denied” hatası neredeyse hiç görülmez.

Yine de bilmeniz gereken iki nokta var:

• Çalıştırılabilir betikler: Modlu sunucularda run.sh gibi betikler bulunur ama panel bunları çalıştırmaz; başlatma komutunu panelin kendisi belirler. Bu yüzden run.sh dosyasını düzenlemeniz genelde bir işe yaramaz, ayarı “Startup” sekmesinden yapmanız gerekir.
• Sembolik bağlar: Forge ve NeoForge kurulumlarında kök dizinde unix_args.txt adında, aslında başka bir dosyaya işaret eden bir kısayol görebilirsiniz. Bunu silmeyin; sunucu başlatma komutu doğrudan bu dosyayı okur.

Büyük Dosyalar ve Yükleme Sınırı: 413 Hatası#

Tarayıcıdan yükleme, panel ile web sunucusu arasındaki boyut sınırına takılabilir. Sınırı aştığınızda karşınıza şu satır çıkar:

413 Request Entity Too Large
nginx

Bu bir hata değil, bilinçli bir sınırdır ve tarayıcıdan aşılamaz. İki çözümü vardır:

SFTP bağlantısı için gereken kullanıcı adı, adres ve port bilgisi panelin “Settings” sekmesinde yazar. Adım adım anlatımı panele FTP ve SFTP ile bağlanma sayfasında bulacaksınız.

Log Dosyalarını Dosya Yöneticisinden Okumak#

Sunucu açılmıyorsa ya da bir eklenti hata veriyorsa cevabı logs klasöründe bulursunuz. İçinde şunlar vardır:

• latest.log — en son çalıştırmanın kaydı. Sorun ararken ilk bakacağınız dosya budur.
• 2026-08-18-1.log.gz — sıkıştırılmış eski günlükler. İndirip bilgisayarınızda açabilirsiniz.
• Modlu sunucularda ayrıca crash-reports klasörü oluşur.

latest.log dosyasına tıklayıp düzenleyicide açabilirsiniz. Aradığınız satırlar genellikle ERROR, SEVERE ve Caused by: ile başlar. Örnek bir hata satırı şöyle görünür:

[12:04:31] [Server thread/ERROR]: Could not load 'plugins/EskiEklenti.jar'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError
Caused by: class file version 69.0, this version of the Java Runtime only recognizes up to 65.0

Bu örnekteki hata, eklentinin sunucudakinden daha yeni bir Java sürümüyle derlendiğini söyler. Minecraft 26.1 ve 26.2 sunucuları Java 25 ister; panelde “Startup” sekmesindeki Docker Image alanını Java 25 yapmanız gerekir. Log okuma mantığının tamamı crash report nasıl okunur sayfasında anlatılıyor.

Dosya Yöneticisinde En Sık Yapılan 6 Hata#

1. Eklentiyi kök dizine atmak. .jar dosyası plugins klasörünün içinde olmalı, kökte değil.
2. Modu plugins klasörüne atmak. Forge/Fabric modları mods klasörüne gider; iki klasör birbirinin yerine geçmez.
3. Sunucu çalışırken dosya kaydetmek. Sunucu kapanırken kendi kopyasını yazar ve değişikliğinizi siler.
4. ZIP’i alt klasör açmadan doğrudan köke açmak. Yüzlerce dosya kök dizine dağılır, temizlemek uzun sürer.
5. Yedeksiz silmek. Panelde geri alma yoktur.
6. Yanlış kodlamayla dosya yüklemek. Türkçe karakter içeren MOTD ve mesaj dosyalarını UTF-8 dışında kaydederseniz oyunda soru işareti görünür.

Dosya Yöneticisi mi, SFTP mi, Konsol mu?#

Üç aracın da kendi işi vardır ve birbirinin yerine geçmezler:

Panel kullanmak yerine sunucunun tamamına hâkim olmak istiyorsanız bir VDS paketi alıp kurulumu kendiniz yapabilirsiniz; hazır panelli çözüm arıyorsanız web panelli sunucu paketleri tüm bu ekranları kutudan çıktığı gibi sunar. Her iki tarafta da 8 GB RAM, Ryzen 9 işlemci ve NVMe SSD alt sınırdır — Minecraft ana döngüsü tek çekirdekte çalıştığı için yüksek saat hızı çekirdek sayısından önemlidir.

Özetle#

Panel dosya yöneticisi, sunucu yönetiminin gündelik işlerinin çoğunu tarayıcıya taşır. Eklentiyi plugins, modu mods klasörüne yükler; server.properties ve YAML dosyalarını gömülü düzenleyicide değiştirir; ZIP arşivlerini sağ tık menüsünden açarsınız. Üç kuralı unutmayın: dosyayı doğru klasöre koyun, sunucuyu durdurmadan düzenleme yapmayın ve silmeden önce yedek alın. 100 MB üzerindeki aktarımlarda tarayıcı yerine SFTP kullanmak hem hızlı hem de kesintiye dayanıklıdır.

Sıradaki adım olarak panelden eklenti yükleme ve Pterodactyl panel kullanım rehberi sayfalarına göz atabilirsiniz.