PisanKus Client

Modern arayüzlü, açık kaynak bir Minecraft: Java Edition launcher'ı. Modrinth içeriklerini doğrudan profillerine kurar, skin ve pelerin yönetimi sunar, Microsoft oturumunu zorunlu tutar.

Özellikler

• Microsoft oturumu — Resmî MSA → Xbox Live → XSTS → Minecraft servisleri zinciri. İlk çevrimiçi başlatmada Java Edition lisansı doğrulanır; daha önce hazırlanmış profiller önbellekteki hesapla çevrimdışı ve yalnızca tek oyunculu kullanım için başlatılabilir.
• İzole profiller — Her profilin kendi mods, resourcepacks, shaderpacks, saves, datapacks klasörü, kendi bellek ve JVM ayarları vardır.
• Modrinth — Mod, mod paketi, doku paketi, shader ve veri paketi arama; profil sürümüne/yükleyicisine göre filtreleme; zorunlu bağımlılıkların otomatik kurulumu. Hesap ya da API anahtarı gerekmez.
• Mod paketi kurulumu — Modrinth .mrpack paketleri açılır, overrides içeriği uygulanır, profilin sürümü ve yükleyicisi pakete göre ayarlanır.
• Yerel içe aktarma — Elindeki .jar / .zip dosyalarını ve dünya arşivlerini profile aktar.
• Simge düzenleyici — Profil simgesini bir arka plan ve bir simge seçerek oluşturun. Şekiller görsel dosyası değil, birim karedeki geometri; aynı tablo Android'de de duruyor, yani telefonda yapılan simge bilgisayarda aynı resim.
• 3B skin değiştirici — Skin yükle, bağlantıdan uygula, klasik/ince model seç, pelerin değiştir. Model saf CSS 3D ile çizilir, sürüklenerek döndürülebilir.
• Otomatik Java — Sistemdeki JVM'leri tarar; sürümün gerektirdiği Java yoksa Eclipse Temurin runtime'ını indirir. İstenirse her profile ayrı Java ve pencere çözünürlüğü atanabilir.
• Yükleyiciler — Vanilla, Fabric, Quilt, NeoForge, Forge, OptiFine.
• Sağlam indirme — Paralel indirme havuzu, SHA-1 doğrulaması, yeniden deneme, yarım kalan dosyaların atlanması.
• Taşınabilir yedekler — Profil ve dünyaları .tgz PisanKus yedeği olarak dışa/içe aktarır. İçerik kurulumu hata verirse profil otomatik olarak işlem öncesi hâline döner; yarıda kesilen işlemler sonraki açılışta kurtarılır.
• Crash analizi — Oyun çıktısı launcher içinde akar, diske kaydedilir ve bilinen bellek, Java, mod bağımlılığı, Mixin, grafik, native, oturum ve ağ hataları için çözüm önerili rapor üretir.
• On yedi dil — Türkçe, İngilizce, Rusça, İspanyolca, Fransızca, Almanca, Çince, Japonca, Korece, İtalyanca, Arapça, Farsça, Azerbaycanca, Türkmence, Kazakça, Kırgızca, Özbekçe. Arayüzün tamamı — options.txt düzenleyicisinin ayar adları, tuş adları ve paketlerdeki mod açıklamaları dahil — çevrilidir. Varsayılan seçenek işletim sisteminin dilini izler; Arapça ve Farsça arayüzü sağdan sola çevirir.

Platformlar

Windows, macOS (Intel + Apple Silicon) ve Linux. Paketler her güncellemede otomatik derlenir.

Kurulum

Hazır paketler için indirme sayfasını veya Releases bölümünü kullanın.

Geliştirme

npm ci
npm run dev        # Electron + Vite geliştirme sunucusu
npm run typecheck  # TypeScript denetimi
npm test           # Güvenlik ve yardımcı işlev testleri
npm run build      # main / preload / renderer derlemesi
npm run dist       # Bulunduğun platform için kurulum paketi

Node.js 22+ gerekir.

Mimari

src/
├── main/                    Electron ana süreci — ağ, dosya sistemi ve oyun süreci burada
│   ├── auth/microsoft.ts    MSA → XBL → XSTS → Minecraft oturum zinciri
│   ├── minecraft/
│   │   ├── versions.ts      Sürüm manifesti, kalıtım (inheritsFrom) çözümlemesi
│   │   ├── libraries.ts     Kural değerlendirmesi, classpath, native ayıklama
│   │   ├── assets.ts        Varlık indeksi ve sanal varlıklar
│   │   ├── java.ts          JVM tarama ve Temurin indirme
│   │   ├── loaders/         Fabric, Quilt, NeoForge, Forge, OptiFine kurulumu
│   │   ├── downloader.ts    Paralel indirme + SHA-1 doğrulama
│   │   ├── crash.ts         Kalıcı günlük ve crash sınıflandırması
│   │   └── launcher.ts      Online/offline argüman üretimi ve süreç yönetimi
│   ├── content/             Modrinth istemcisi, kurulum/güncelleme/mod paketi mantığı
│   ├── profileArchive.ts    Profil/dünya yedeği içe-dışa aktarma
│   ├── profileTransaction.ts Kurulum geri alma günlüğü
│   ├── skins.ts             Skin ve pelerin işlemleri
│   ├── store.ts             JSON tabanlı yerel veritabanı
│   └── ipc.ts               Renderer'a açılan tek yüzey
├── preload/                 contextBridge ile tip güvenli API
├── renderer/                React arayüzü
├── shared/i18n/             Çeviri tabloları — anahtar, Türkçe metnin kendisi
└── shared/types.ts          İki tarafın paylaştığı tipler

Erişim jetonları hiçbir zaman renderer'a geçmez; ipc.ts hesapları PublicAccount biçimine indirger.

Çeviri anahtarı, ekranda yazan Türkçe cümlenin kendisidir: launcher Türkçe yazıldı ve metin hâlâ kodun içinde duruyor. Uydurulmuş bir anahtar yerine cümlenin kendisi kullanılınca, karşılığı olmayan bir satır yazıldığı gibi kalıyor — yanlış yazılmış bir anahtar yüzünden ekranın boş çıkması mümkün değil, ve yeni bir dil eklemek bir tabloyu doldurmaktan ibaret.

Yapılandırma

Microsoft istemci kimliği

Varsayılan olarak genel bir istemci kimliği kullanılır. Kendi Azure uygulamanı kaydetmek istersen:

1. Azure Portal → App registrations → New registration
2. Supported account types: Personal Microsoft accounts only
3. Redirect URI (Mobile and desktop applications): https://login.microsoftonline.com/common/oauth2/nativeclient
4. Authentication → Allow public client flows → Yes
5. İstemci kimliğini Ayarlar → Hesap bölümüne gir (ya da PISANKUS_MS_CLIENT_ID ortam değişkenini kullan).

Yayınlama

Yayınlama tamamen otomatiktir — elle sürüm çıkarmak gerekmez.

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗