Kepler şu an kişisel test aşamasındadır ve indirme henüz mevcut değildir. Yayına çıktığında Windows, macOS ve Linux üzerinde çalışır; doğru Java sürümü Mojang'ın sürüm manifestosundan otomatik seçilip resmi kaynaklardan indirildiği için manuel Java kurmana gerek kalmaz.
- SmartScreen uyarısı neden çıkar: Kepler yeni bir uygulamadır ve bu aşamada henüz dijital kod imzalama (code-signing) sertifikası ile imzalanmamıştır. Windows Defender SmartScreen yeni dosyalar için mavi renkli Windows kişisel bilgisayarınızı korudu ekranını gösterebilir; bu uyarı bir virüs tespiti değildir, yalnızca dosyanın henüz tanınmadığını belirtir.
- Adım adım geçiş: Uyarı ekranında açıklama metninin altındaki Ek bilgi (More info) bağlantısına, ardından sağ altta beliren Yine de çalıştır (Run anyway) düğmesine tıklayarak kurulumu başlatabilirsin.
- SHA-256 doğrulaması: İndirdiğin dosyanın bütünlüğünü kontrol etmek için PowerShell'de
Get-FileHash .\KeplerClient-Kurulum.exe -Algorithm SHA256 komutunu çalıştırıp çıkan değeri resmi indirme sayfasındaki SHA-256 özetiyle karşılaştırabilirsin.
Başlatıcıyı ilk kez açtığında kurulum sihirbazı temel tercihlerini adım adım yapılandırır. İhtiyaç duyduğunda Ayarlar > Gelişmiş altından Kurulumu yeniden çalıştır düğmesiyle sihirbazı tekrar açabilir veya Ctrl+K komut paletini kullanabilirsin.
- Hesap ekleme: Sağ üstteki hesap menüsünden Microsoft ile giriş yap seçeneğiyle sistem varsayılan tarayıcında güvenli PKCE OAuth2 girişi yapabilir (yenileme belirteçleri işletim sistemi anahtarlığında saklanır) veya tek oyunculu kullanım için 3–16 karakterlik Çevrimdışı hesap oluşturabilirsin.
- Hazır veya özel profil: Kutudan çıktığı gibi hazır optimize profille başlayabilir ya da Kitaplık > + Yeni profil üzerinden temiz veya modlu (Fabric, Quilt) profil oluşturabilirsin. İlk olarak Fabric ile Minecraft 1.21.x desteklenir; 1.20'den 26.3'e kadar 6 sürüm test aşamasındadır.
- Başka başlatıcıdan taşıma: Bilgisayarındaki mevcut başlatıcıları (Prism Launcher, Modrinth App vb.) otomatik tarayarak profillerini dünyalarıyla birlikte içe aktarabilirsin.
Kepler'in mod kataloğu Modrinth ile başlar. Kepler modlu oyun paketi dağıtmaz; tüm mod dosyaları SHA-1 doğrulaması ile doğrudan resmi kaynaklardan indirilir.
- Mod arama ve kurulum: Keşfet ekranında hedef profilini seçip Modrinth kataloğunda arama yapabilirsin. Mod uyumluluğu ve gerekli bağımlılıklar seçtiğin profilin oyun sürümü için otomatik kontrol edilir.
- Mod yönetimi ve güncelleme: Kitaplık içindeki profilin Modlar sekmesinden kurulu modları Tümü, Açık veya Kapalı olarak filtreleyebilir, Güncellemeleri denetle düğmesiyle yeni sürümleri kontrol edebilirsin.
- .mrpack paketleri: Modrinth
.mrpack ve uyumlu .zip arşivlerini dizin güvenliği (path traversal koruması) ve izinli alan adı kontrolüyle içe aktarabilir veya kendi profilini dışa aktarabilirsin.
Profil yapılandırmanı büyük arşiv dosyaları taşımadan paylaşmak için kompakt KEPLER1: paylaşım kodunu kullanabilirsin.
- Kod içeriği:
KEPLER1: öneki ve URL-safe Base64 ile kodlanan JSON verisi; şema sürümünü, profil adını, Minecraft sürümünü, varsa mod yükleyici bilgisini ve Modrinth mod kimliklerini (project_id, version_id, filename) barındırır.
- Gizlilik ve sınırlar: Paylaşım kodu hiçbir zaman dosya içeriklerini, yerel dosya yollarını, hesap verilerini veya gizli ayarları içermez. İçe aktarma sırasında en fazla 64 KB boyut ve en fazla 500 mod sınırı doğrulanır.
- Ayarları taşıma: Başlatıcı ayarlarını, temalarını ve sunucu listesini ayrıca tek bir JSON dosyası olarak dışa veya içe aktarabilirsin.
Kısıtlı bellek veya daha mütevazı işlemcilere sahip bilgisayarlar için Kepler, donanım analizi ve hazır başlatma şablonları sunar.
- Düşük donanım ön ayarı: Profil ayarlarındaki Performans ön ayarı bölümünden Düşük donanım (zayıf PC modu), Dengeli veya Yüksek performans JVM bayrak şablonlarından birini seçebilirsin.
- Otomatik RAM ve kalibrasyon: Sisteminin toplam/kullanılabilir RAM'ine, CPU çekirdek sayısına, mod sayısına ve Minecraft sürümüne göre önerilen bellek (heap) otomatik hesaplanır. Başlatıcı içindeki 2‑3 dakikalık kalibrasyon testi 3–4 aday profili deneyerek donanımın için kazanan profili seçer.
- Hafif arayüz seçenekleri: Ayarlar > Oyun altından başlatıcı animasyonlarını kapatabilir ve Sıkı görünüm modunu etkinleştirebilirsin.
Her profilin oyun içinde aldığın ekran görüntüleri, ilgili kurulumun kendi <profil>/screenshots dizininde diğer profillerden bağımsız olarak saklanır.
- Listeleme ve önizleme: Profile ait
.png biçimindeki ekran görüntüleri en yeniden eskiye doğru (sorgu başına en fazla 500 görsel ve görsel başına 12 MB sınırıyla) başlatıcı içinde listelenir.
- Silme ve klasörü açma: İstemediğin ekran görüntülerini doğrudan arayüzden silebilir veya ekran görüntüleri klasörünü işletim sisteminin varsayılan dosya yöneticisinde açabilirsin.
Mod eklemeden veya sürüm değiştirmeden önce Kitaplık ekranındaki profil ayrıntısından Yedekler sekmesini kullanarak verilerini güvenceye alabilirsin.
- Atomik .zip yedeği: Yedek al düğmesiyle yalnızca Dünyalar kapsamını veya Tüm profil dizinini seçip isteğe bağlı etiket girerek tek tıkla
.zip yedeği oluşturabilirsin.
- Güvenli geri yükleme: Kayıtlı yedekleri tarih ve boyutuyla görüntüleyebilir, eski yedekleri silebilir ve Geri yüklemeyi başlat komutuyla otomatik güvenlik yedeği alarak önceki bir yedeğe geri dönebilirsin.
Çok oyunculu sunuculara hem başlatıcı içindeki Sunucular ekranından hem de komut satırı parametreleriyle doğrudan bağlanabilirsin.
- Sunucu listesi ve SLP ping: Kaydettiğin sunucuların çevrimiçi durumunu, anlık oyuncu sayısını ve gecikme (ms) değerini Server List Ping (SLP) protokolüyle tekil veya toplu olarak sorgulayabilir, Katıl düğmesiyle doğrudan oyuna girebilirsin.
- Komut satırı bayrakları: Başlatıcıyı
--server <adres[:port]>, --port <n> ve --profile <id> (veya --server=adres:port) parametreleriyle çalıştırarak seçili profilin doğrudan hedef sunucuya bağlanmasını sağlayabilirsin.
- Adres doğrulaması: Boşluk içeren geçersiz adresler ve yerel metaveri/link-local (
169.254.x.x) adresleri güvenlik nedeniyle reddedilir.
Oyun beklenmedik şekilde kapandığında süreç gözetmeni (stdout/stderr halka arabelleği) kapanış kodunu ve son günlük satırlarını otomatik olarak inceler.
- Çakışma tespiti: Performans > Sorun Giderici sekmesinde çökme raporu, olası nedenler ve çakışan şüpheli modlar listelenir; şüpheli modu Modu kapat veya Düzeltmeyi dene düğmesiyle arayüzden devre dışı bırakabilirsin.
- Gizlilik maskelemesi: Raporu kopyala veya Logu paylaş seçeneklerini kullandığında gizlilik filtresi kullanıcı adını ve bilgisayarındaki sistem dosya yollarını otomatik olarak maskeler.
Sık karşılaşılan uyarılar ve çözüm adımları:
- "Oyun zaten çalışıyor" (
already_running): Arka planda aktif bir Minecraft süreci vardır. Ana ekrandan Durdur düğmesine basarak veya mevcut sürecin kapanmasını bekleyerek yeniden başlatabilirsin.
- Oyun açılırken çöküyor: İki mod arasında API veya görüntüleme çakışması olabilir. Performans > Sorun Giderici sekmesinden listelenen şüpheli modu devre dışı bırakıp tekrar dene.
- Yetersiz bellek veya takılma: Profile çok az veya sistem belleğinin %75'inden fazla RAM ayrılmış olabilir. Profil ayarlarında Otomatik RAM seçeneğini açabilir veya kalibrasyonu yeniden çalıştırabilirsin.
- Desteklenmeyen Java (
unsupported_java): Seçilen sürüm için Performans > Java sekmesinden Java'yı otomatik bul/indir seçeneğini kullanabilirsin.
- Microsoft girişi tamamlanmıyor: Tarayıcı doğrulaması zaman aşımına uğradıysa İptal düğmesine basıp giriş akışını yeniden başlatabilirsin.
