Minecraft Modding API / Loader

EgeMods Client & Loader Kurulumu

EgeMods Mod Yükleyici (Forge / Fabric tabanlı mimari) altyapısını Minecraft'a entegre etme ve mod yönetimi rehberi.

Genel Bakış

EgeMods Client/Loader, Minecraft oyun istemcinize gelişmiş mod desteği, optimize edilmiş işleme (rendering) motorları ve custom API entegrasyonları kazandıran bağımsız bir mod yükleyici altyapısıdır.

Tıpkı Minecraft Forge veya Fabric gibi çalışarak, .jar uzantılı modların oyuna yüklenmesini ve birbiriyle uyumlu şekilde çalışmasını sağlar.

Gereksinimler & Java Bağımlılığı

EgeMods Mod Loader'ın hatasız çalışabilmesi için aşağıdaki bağımlılıkların sisteminizde yüklü olması gerekir:

  • Orijinal veya Uyumlu Minecraft Launcher: Oyunun en az bir kez vanilya (modsuz) olarak çalıştırılmış olması şarttır.
  • Java Development Kit / JRE:
    • Minecraft 1.16.5 ve altı için: Java 8 (64-bit)
    • Minecraft 1.17 – 1.20.4 için: Java 17 (64-bit)
    • Minecraft 1.20.5+ sürümleri için: Java 21 (64-bit)
İpucu: Java sürümünüzü kontrol etmek için komut satırına (CMD) java -version yazabilirsiniz.

1. EgeMods Loader Kurulumu

  1. Installer (.jar / .exe) Dosyasını İndirin

    Sürümünüze uygun EgeMods Loader yükleyicisini (örn: egemods-loader-1.20.1-installer.jar) resmi geliştirici portalından indirin.

  2. Yükleyiciyi Çalıştırın

    İndirdiğiniz dosyaya çift tıklayarak EgeMods Kurulum Ekranı'nı açın.

    Eğer .jar dosyaları açılmıyorsa komut satırından şu komutla çalıştırın:

    java -jar egemods-loader-1.20.1-installer.jar
  3. Install Client Seçeneğini Seçin

    Açılan pencerede "Install Client" seçeneğini işaretleyin. `.minecraft` dizininizin doğru algılandığından emin olun ve OK / Kur butonuna tıklayın.

    📁 Dizin: %appdata%\.minecraft

2. Launcher Profil Yapılandırması

Kurulum tamamlandıktan sonra Minecraft Başlatıcısı'nı açın:

  1. EgeMods Profilini Seçin

    Başlatıcıdaki sürüm/profil açılır menüsünden "EgeMods-Client-[Sürüm]" profilini seçin.

  2. RAM (Bellek) Ayarını Yapın

    Modlu Minecraft daha fazla bellek gerektirir. Profil Düzenle > Daha Fazla Seçenek altındaki JVM argümanlarından RAM miktarını artırın:

    Örnek JVM Argümanı (4 GB RAM için):

    -Xmx4G -XX:+UseG1GC -Dsun.rmi.dgc.client.gcInterval=3600000

3. Mod (.jar) Dosyalarını Yükleme

EgeMods Loader kurulduktan sonra istediğiniz modları oyuna ekleyebilirsiniz:

Mod Klasörüne Erişim

Klavyenizden Win + R tuşlarına basarak Çalıştır penceresini açın ve şu yolu yazıp Enter'a basın:

%appdata%\.minecraft\mods

Eğer mods klasörü yoksa kendiniz yeni bir klasör oluşturun.

Modların Kopyalanması

İndirdiğiniz EgeMods uyumlu .jar uzantılı mod dosyalarını doğrudan bu mods klasörünün içine sürükleyip bırakın.

Dikkat: Mod dosyalarının arşiv paketlerini (ZIP veya RAR) ayıklamayın; .jar formatında bırakın.

Çakışma ve Sorun Giderme

Sürüm Çakışması (Mod Rejection / Crash)

Yüklediğiniz modların EgeMods Loader sürümüyle birebir aynı Minecraft sürümü için yazıldığından emin olun (örn: 1.20.1 için indirilen modlar 1.16.5'te çalışmaz).

Eksik API Bağımlılıkları (Missing Dependencies)

Bazı modlar çalışmak için ek kütüphanelere ihtiyaç duyar (EgeMods API Core vb.). Hata ekranında ismi geçen bağımlılık .jar dosyasını da mods klasörüne ekleyin.

Crash Log İnceleme

Oyun çöktüğünde hatanın sebebini görmek için aşağıdaki dizinde yer alan en son log dosyasını inceleyebilirsiniz:

%appdata%\.minecraft\logs\latest.log
Geliştirici Desteği: Kendi modunuzu EgeMods API ile geliştirmek veya çakışma raporlamak için resmi Discord sunucumuz üzerinden bilet oluşturabilirsiniz.