Kurulum

Kurulum üç parçadır: veritabanı ve .env, siteyi başlatma ve altı adımlı kurulum sihirbazı (Minecraft sunucusu ekleme sihirbazın son adımıdır). Başlamadan önce Gereksinimler sayfasını kontrol edin.

1. Veritabanını oluşturun

   cPanel’de MySQL Veritabanı Sihirbazı’nı açın. Yeni bir veritabanı ve kullanıcı oluşturun, kullanıcıya tüm ayrıcalıkları verin (şemayı kurmak için en azından CREATE, ALTER ve DROP izni gerekir). SQL dosyası içe aktarmanız gerekmez; tablolar sihirbazın ilk adımında otomatik kurulur.

2. .env dosyasını hazırlayın

   Paketteki .env.example dosyasının adını .env yapın ve şu alanları doldurun:

   DATABASE_URL="mysql://kullanici:sifre@localhost:3306/veritabani"
   SITE_URL="https://sunucum.com"
   NEXT_PUBLIC_SITE_URL="https://sunucum.com"
   JWT_SECRET="kendi-urettiginiz-uzun-deger"
   APP_SECRET="kendi-urettiginiz-uzun-deger"
   TRUSTED_IP_HEADER=""

   Güvenli bir değer üretmek için bilgisayarınızda Node.js ile şu komutu çalıştırabilirsiniz:

   node -e "console.log(require('crypto').randomBytes(48).toString('base64'))"

3. Siteyi başlatın

   cPanel’de Setup Node.js App → Create Application yolunu izleyin:

   • Node.js sürümü: 18.17 veya üstü (20+ önerilir)
   • Application Mode: Production
   • Application Root: dosyaları yüklediğiniz klasör
   • Application Startup File: server.js

   Sırasıyla Run NPM Install ve Restart Application düğmelerine basın, ardından sitenizin adresini açın.

4. Kurulum sihirbazını tamamlayın

   İlk açılışta sihirbaz (/setup) sizi karşılar. Ekranın üstünden dili seçebilirsiniz; seçtiğiniz dil sitenin varsayılan dili olur.

Alan	Ne işe yarar
DATABASE_URL	Veritabanı bağlantı adresi.
SITE_URL	Sitenizin genel adresi. Lisans kontrolü, parola sıfırlama bağlantıları ve eklenti adresi bunu kullanır.
NEXT_PUBLIC_SITE_URL	Tarayıcıda çalışan kod için; SITE_URL ile aynı yazın.
JWT_SECRET, APP_SECRET	Oturum imzası ve lisans anahtarının şifrelenmesi. Her kurulumda size özel olmalı.
TRUSTED_IP_HEADER	Cloudflare arkasındaysanız cf-connecting-ip, değilse boş.
LICENSE_KEY	İsteğe bağlı. Boş bırakabilirsiniz; anahtarı sihirbazdan girersiniz.

Sihirbaz altı adımdır. Tamamlanmış bir adıma geri dönebilirsiniz.

1. Veritabanı: Bağlantı sınanır ve tablolar kurulur. Sayfada Node sürümü, disk alanı, yazma izinleri, .env sırları ve veritabanı yazma izni satırlarını gösteren bir gereksinim tablosu da bulunur; kırmızı satırları düzeltmeden devam etmeyin. Veritabanı yazma izni satırı, kullanıcının geçici bir tabloyu oluşturup (CREATE), değiştirip (ALTER) ve silebildiğini (DROP) sınar; mevcut tablolara dokunmaz. Bağlantı yeşil olsa bile bu izinlerden biri eksikse satır kırmızı olur ve eksik izinleri adıyla yazar. Barındırma panelinde veritabanı kullanıcısına tüm ayrıcalıkları verin, yoksa tablolar kurulamaz.
2. Site adresi: Adresinizi yazın ve Adresi doğrula’ya basın. Bu adım Koderia’ya gerçek bir lisans sorgusu yapar; alan adı lisansta tanımlı değilse hatayı burada görürsünüz.
3. Yönetici: İlk yönetici hesabını oluşturun. Kullanıcı adı 3 ile 16 karakter olmalı (harf, rakam, alt çizgi). Parola en az 10 karakter olmalı, yalnızca rakamdan oluşmamalı, kullanıcı adını içermemeli ve çok yaygın bir parola olmamalı.
4. Site kimliği (isteğe bağlı): Site adı (en çok 60 karakter), Türkçe ve İngilizce slogan (her biri en çok 120 karakter), sunucu adresi (play.sunucum.com ya da play.sunucum.com:25565), saat dilimi (örn. Europe/Istanbul) ve temel para birimi. Hepsi isteğe bağlıdır: boş bıraktığınız alan varsayılan değerini korur, Atla ile adımı tümden geçebilirsiniz. Geçersiz bir değer girerseniz hiçbir şey kaydedilmez ve hata gösterilir. Buraya yazdığınız sunucu adresi, son adımdaki Minecraft sunucu IP alanına otomatik gelir. Hepsini sonradan Genel ayarlar sayfasından değiştirebilirsiniz.
5. Lisans anahtarı: Anahtarı girin ve Anahtarı doğrula’ya basın; plan hakları ekranda listelenir. Anahtarınız yoksa adımı atlayabilirsiniz, ancak site kilitli açılır. Sonra Lisans sayfasından girersiniz.
6. Minecraft sunucusu: Sunucu adı, kimlik (server-id) ve IP girip anahtarları üretin. Ekrandaki API anahtarı ve secret değerlerini hemen kaydedin; anahtar bir daha gösterilmez.

Son adımdan sonra sihirbaz kilitlenir.

Kurulum biterken site kullanıma hazır görünsün diye şunlar otomatik yazılır; daha önce var olan bir kaydın üzerine yazılmaz:

• Şartlar, Gizlilik ve Kurallar sayfaları (sitenin varsayılan dilinde).
• Üst menü: Anasayfa, Mağaza, Forum, Blog, Destek, Yardım ve İndirmeler. Menüde zaten kayıt varsa dokunulmaz.
• SEO: Ana sayfa, mağaza, forum, blog, yardım, destek ve indirmeler için başlık ve açıklama; başlıklar “Sayfa | Site adı” biçimindedir. Daha önce girilmiş sayfalara dokunulmaz.
• Modül anahtarları: Kaydı olmayan modüller varsayılan açık/kapalı durumlarıyla yazılır.

Bunlardan biri yazılamazsa kurulum yine tamamlanır, ancak bitiş ekranında hangisinin yazılamadığını söyleyen bir uyarı çıkar. Eksik olanı giriş yaptıktan sonra yönetim panelinden elle ekleyebilirsiniz (sayfalar, üst menü, Ayarlar → SEO, Ayarlar → Modüller).

Kurulumdan sonra Lisans durumunuzu kontrol edin.