🎮 Minecraft Web Yönetim Paneli

Bu proje, Minecraft sunucunuzu web tarayıcısı üzerinden tam kapsamlı, modern ve etkileşimli bir şekilde yönetmenizi sağlayan, Node.js tabanlı gelişmiş bir yönetim panelidir.

🚀 WebPanel V5 Güncellemesi (Yeni Sürüm): 👥 Oyuncu Yönetimi: Online, Tüm Oyuncular, Ops, Banlılar ve IP Ban listeleri gelişmiş sekmeli (Tabs) yapıya geçirildi. 🎒 Envanter Görüntüleyici: Çevrimdışı/çevrimiçi oyuncuların envanter ve Ender Chest içerikleri görsel slotlar halinde çözümlenip listeleniyor. 🧩 Mod & Eklenti Mağazası: Modrinth, Spiget ve DevBukkit entegrasyonu ile panelden doğrudan eklenti arama ve tek tıkla yükleme eklendi. ☕ Java Sürüm Seçici: Sistemdeki Java sürümleri otomatik taranıp ayarlardan kolayca değiştirilebilir hale getirildi. 📦 Kaynak Paketi (Resource Pack): Sunucu için .zip paketi yükleme, SHA-1 otomatik hesaplama ve silme eklendi. 🌍 Dünya Yöneticisi: Panelden yeni dünya oluşturma ve silerken yedekleme alma desteği sağlandı. 📈 Performans Grafikleri: Chart.js ile CPU/RAM geçmişi ve regex ile konsoldan anlık TPS izleme eklendi.

✨ Yeni ve Temel Özellikler

🔥 Öne Çıkan Yenilikler

• 🧠 Akıllı Konsol: Minecraft komutları ve oyuncu isimleri için TAB ile otomatik tamamlama, komut geçmişi (yukarı/aşağı ok) ve çok seçenekli öneri kutusu.
• 🌍 Gelişmiş Dünya Yöneticisi:
  • Yükle: Kendi haritanızı .zip olarak sürükleyip bırakın.
  • İndir: Sunucudaki dünyaları tek tıkla .zip olarak yedekleyin.
  • Aktif Et: server.properties ile uğraşmadan panelden aktif dünyayı seçin.
• 👥 Modern Oyuncu Yönetimi:
  • Sekmeli Yapı: Online, Yöneticiler (Ops), Banlılar ve IP Ban listeleri tek sayfada.
  • Anlık Tepki: Oyuncu işlemleri sayfa yenilemeden (Optimistic UI) gerçekleşir.
• 💬 İki Yönlü Discord Botu:
  • Oyundan Discord'a log akışı.
  • Discord'dan oyuna mesaj gönderme (Slash Command: /gönder mesaj).
• 📊 Canlı Grafikler: Chart.js ile geçmişe dönük CPU ve RAM kullanım grafikleri.

⚙️ Temel Özellikler

• 📂 Dosya Yöneticisi: Web üzerinden dosya düzenleme, silme, oluşturma ve yükleme.
• 🧩 Eklenti (Plugin) Yöneticisi: Marketten (Modrinth/Spiget/DevBukkit) veya dosya yükleyerek plugin kurma, açma/kapama.
• 💾 Yedekleme Sistemi: Sunucu açıkken bile güvenli (Hot Backup) yedek alma ve geri yükleme.
• ⏱️ Zamanlayıcı (Cron): Otomatik restart, komut gönderme veya yedekleme görevleri.
• 📋 Denetim Kaydı (Audit): Panel üzerindeki tüm işlemlerin (IP, Tarih, İşlem) kaydı.
• 🛠️ Yazılım Yöneticisi: PaperMC sürümlerini otomatik listeleme ve tek tıkla kurma/güncelleme.

🛠️ Gereksinimler

• Node.js (v16 veya üzeri önerilir)
• Java (Minecraft sürümünüze uygun Java sürümü - örn: 1.16.5 için Java 8/11, 1.20+ için Java 17/21)
• Modern bir Web Tarayıcısı

🚀 Kurulum

1. Projeyi İndirin:

   git clone <https://github.com/KULLANICI_ADINIZ/REPO_ADINIZ.git>

2. Klasöre Girin ve Modülleri Yükleyin:

   cd proje-klasoru
   npm install

⚙️ Klasör Yapısı (ÖNEMLİ)

Panelin sunucunuzu bulabilmesi için klasör yapınız aşağıdaki gibi yan yana olmalıdır:

Masaüstü/
├── Ana_Klasör/
│   ├── webpanel/       <-- (Bu projenin dosyaları)
│   │   ├── server.js
│   │   ├── config/     <-- (Ayarlar buraya otomatik oluşur)
│   │   └── ...
│   └── mc-server/      <-- (Minecraft sunucu dosyanız burada olmalı)
        ├── server.jar
        ├── server.properties
        └── ...

        Not: Eğer sunucu klasörünüzün adı mc-server değilse, server.js dosyasını açıp en üstteki SERVER_FOLDER_NAME değişkenini kendi klasör adınıza göre düzenleyin.

▶️ Çalıştırma

1. Terminali açın ve panel klasörüne gelin.

2. Paneli başlatın:

   node server.js

3. Tarayıcınızdan şu adrese gidin: http://localhost:1717 (Panel varsayılan olarak 1717 portunu kullanmaktadır.)

🧩 Discord Entegrasyonu Nasıl Yapılır?

1. Panelden DISCORD sayfasına gidin.

2. Discord sunucunuzda 3 farklı kanal için (Sohbet, Olaylar, Admin) Webhook oluşturun.

3. Webhook linklerini ilgili kutulara yapıştırın ve KAYDET butonuna basın.

📞 Destek ve Hata Bildirimi

Herhangi bir hata ile karşılaşırsanız veya geliştirme öneriniz varsa lütfen iletişime geçin.

Geliştirici: Kerem Zayim

GitHub: https://github.com/KeremZayim

Hata Bildirimi: Lütfen GitHub Issues kısmını kullanın.

Kullanıcı Neleri Değiştirmeli? (Özet)

Projeyi indiren birisi sadece şunlara dikkat etmeli:

1. Klasör Yapısı: server.js dosyasının bulunduğu klasör ile Minecraft sunucu klasörü yan yana olmalıdır.
2. Klasör Adı: server.js içindeki const SERVER_FOLDER_NAME = 'mc-server'; satırı, yan taraftaki klasörün adıyla birebir aynı olmalıdır.
3. Jar Adı: Sunucu dosyasının adı server.jar olmalıdır (veya koddan değiştirilmelidir).
4. Kurulum: npm install komutu ile kütüphaneleri indirmelidir.

📖 Sürüm Değişiklik Günlüğü (Changelog)

🛠️ WebPanel V5 Güncelleme Detaylarını Göster (Tıkla Aç)

🚀 Yeni Özellikler & Geliştirmeler

• 👥 Sekmeli Oyuncu Yönetimi: Online, Tüm Oyuncular, Ops, Banlılar, IP Banlılar ve İstatistikler sekmeleri eklendi. Oyuncu ismi önerme desteği sağlandı.
• 🎒 Çevrimdışı Oyuncu Envanter Görüntüleyici: Oyuncu .dat dosyaları (NBT) çözümlenerek envanter, zırh, ikincil el (off-hand) ve Ender Chest içerikleri görsel slotlar halinde modala döküldü (Minecraft 1.20.5+ dahil).
• 📊 Liderlik Tabloları: En çok oynayanlar, en çok yaratık öldürenler ve en çok ölenler istatistikleri taranarak sıralandı.
• 🧩 Mod & Eklenti Mağazası: Modrinth, Spiget ve DevBukkit API entegrasyonu ile panel üzerinden doğrudan eklenti/mod arama ve yükleme özelliği getirildi.
• 🖥️ Sunucu Yazılım & Sürüm Yöneticisi: Paper, Spigot ve CraftBukkit için kararlı/deneysel sürüm tespiti ve otomatik kurulum sistemi kuruldu.
• ☕ Dinamik Java Sürüm Seçici: Sistemdeki yüklü Java yollarını otomatik tarayan ve ayarlardan tek tıkla seçebilmeyi sağlayan sistem entegre edildi.
• 📦 Kaynak Paketi (Resource Pack) Yönetimi: Kaynak paketi yükleme, indirme, SHA-1 kodunun otomatik hesaplanarak server.properties'e işlenmesi ve silinmesi eklendi.
• 🌍 Dünya Yönetimi Yenilikleri: Yeni dünya oluşturma modalı, silerken önce yedekleme seçeneği ve sürükle-bırak zip yükleme desteği eklendi.
• 📈 Performans & TPS İzleme: Chart.js grafikleriyle CPU/RAM izleme ve konsol loglarından anlık TPS değerini regex ile yakalama sistemi kuruldu.
• ⚙️ Güvenlik & İyileştirmeler: ops.json temizleyici (cleanOpsJson) ile UUID mükerrer kayıtları düzeltildi, denetim günlüklerine sayfalandırma (pagination) ve Excel dışa aktarım desteği (SheetJS) eklendi. .gitignore güncellenerek hassas veriler koruma altına alındı.

Panel Resimleri

🌟 Projeyi Beğendiniz mi?

Eğer bu proje işinize yaradıysa veya geliştirmemi desteklemek istiyorsanız, lütfen sağ üst köşedeki Star (Yıldız) ⭐ butonuna tıklamayı unutmayın!

Bu, projeyi geliştirmeye devam etmem için beni motive edecektir. Teşekkürler! ❤️