Arkadan aydınlatmalı bilgisayar klavyesinin yakın plan fotoğrafı
Bilgisayarda kurulum işlemlerini temsilen kullanılan fotoğraf; Luanti ekran görüntüsü değildir.

İndirdiğiniz modu kullanmak için arşivi kullanıcı veri dizinindeki mods klasörüne açmanız, ardından oynayacağınız dünya için etkinleştirmeniz gerekir. Dosyaların bilgisayarda bulunması, modun dünyada çalıştığı anlamına gelmez.

Bu rehber bilgisayarda kendi yerel dünyasına normal bir oyun modu ekleyenler içindir. İstemci tarafı modlar (CSM) ve uzak sunucu yönetimi kapsam dışındadır. Menü adları arayüz dilinize göre değişebilir; ilgili İngilizce adlar aşağıda verilmiştir.

Paketi açmadan önce iki kontrol

İndirme sayfasından paketin hangi oyunla ve Luanti sürümüyle kullanılacağını okuyun. Yalnızca arşivin adına bakarak karar vermeyin. Geliştiricinin kurulum açıklaması yoksa veya paketin kaynağından emin değilseniz burada durun. Modu çalıştırabilmek için mod güvenliğini kapatmayın ve onu güvenilir mod listesine eklemeyin.

Mevcut dünyanızda denemeden önce dünyayı kapatıp dünya klasörünün ayrı bir yedeğini alın. Modlar dünya verisini değiştirebilir. İlk denemeyi aynı oyunun yeni bir deneme dünyasında yapmak, asıl kaydınıza dokunmadan kurulum sorunlarını görmenizi sağlar.

Doğru klasöre, doğru paketi yerleştirin

  1. Luanti ana menüsünde About bölümünü açın ve Open User Data Directory düğmesine basın. Böylece kullandığınız kurulumun veri dizinine ulaşırsınız.
  2. Açılan dizinde mods klasörünü bulun; yoksa oluşturun.
  3. İndirdiğiniz ZIP arşivini önce geçici bir klasöre çıkarın. İçeriği aşağıdaki tabloyla kontrol edin.
  4. Normal bir modsa, modun dosyalarını birlikte tutan klasörü mods içine taşıyın. ZIP dosyasını olduğu gibi bırakmayın.
Pakette ne görüyorsunuz? Nasıl ilerlemelisiniz?
Mod klasöründe init.lua ve genellikle mod.conf Normal mod yapısıyla uyumludur. Klasörü bütün olarak taşıyın; yalnızca Lua dosyasını ayırmayın.
Bir dış klasör, onun içinde asıl mod klasörü Gereksiz dış katmanı taşımayın. Modun başlangıç dosyasının hangi klasörde olduğunu bulun.
modpack.conf ve birden fazla mod klasörü Bu bir mod paketidir. Alt klasörleri rastgele birleştirmeyin; paket yapısını koruyun.
game.conf ve oyuna ait mods klasörü Bu bir oyun paketi olabilir. Mod kurulumu adımlarını burada durdurun. Oyunların dizini games altındadır; paketin oyun kurulum açıklamasını izleyin.

Aşağıdaki ornek_mod adı yalnızca klasör düzenini göstermek için kullanılmıştır; indirilecek gerçek bir mod önerisi değildir:

kullanıcı_veri_dizini/
└── mods/
    └── ornek_mod/
        ├── init.lua
        └── mod.conf

Normal tek mod için mods/ornek_mod/ornek_mod/init.lua görüyorsanız fazladan bir klasör katmanı oluşmuş olabilir. Ancak aynı işlemi gerçek bir mod paketine uygulamayın: mod paketlerinin içinde birden fazla mod klasörü bulunması normaldir.

mod.conf içindeki name değeri teknik mod adını belirtir. Bu değer, klasör adı farklı olsa da Luanti’nin modu tanımasını sağlayabilir. Bu nedenle her indirmede körlemesine -main veya -master silmek yerine paket talimatını kontrol edin; sırf klasör adına uydurmak için name değerini değiştirmeyin.

Modu kullanacağınız dünyada açın

Dünya listesinden doğru dünyayı seçip Configure düğmesini açın. Eklediğiniz modu bulun, etkinleştirin ve seçiminizi kaydedin. Yeni kurulan modlar varsayılan olarak dünyalarda kapalıdır; diğer dünyalarda da kullanacaksanız onların ayarlarını ayrıca yapın.

Bir mod paketi kurduysanız paket listesini genişleterek içindeki modları görebilir, bileşenleri ayrı ayrı etkinleştirebilirsiniz. İlk denemede ilgisiz modları topluca açmak yerine yalnızca hedef mod ve gerekli bağımlılıklarıyla ilerleyin.

Kurulumun hangi aşamada takıldığını bulun

  • Mod listede yok: Önce veri dizinini ve klasör katmanlarını yeniden kontrol edin. Aynı paketi farklı dizinlere çoğaltarak çözmeye çalışmayın.
  • Eksik bağımlılık bildiriliyor: Paketin mod.conf dosyasındaki depends alanını ve geliştirici açıklamasını okuyun. Buradaki zorunlu modlar önce yüklenmelidir. optional_depends alanındaki modların bulunmaması ise tek başına yükleme hatası oluşturmaz.
  • Dünya açılıyor ama değişiklik görünmüyor: Oyun içi sohbete /mods yazın. Bu komut çalışan oyundaki etkin modları listeler. Teknik mod adı listede varsa geliştiricinin tarif ettiği kullanım koşulunu kontrol edin; her mod yeni bir eşya veya görünür menü eklemez.

Başarıyı iki ayrı sonuçla değerlendirin: Mod etkin modlar listesinde görünüyor mu ve kendi açıklamasında vaat ettiği işlev deneme dünyasında kullanılabiliyor mu? İlk sonuç yüklenmeyi gösterir; bütün özelliklerin sorunsuz çalıştığını tek başına kanıtlamaz.

Sorun sürerse yardım isterken şu kısa kaydı doldurun: “Luanti sürümüm: …; oynadığım oyun ve sürümü: …; modun indirme adresi ve sürümü: …; Configure listesinde görünüyor/görünmüyor; hata metni: …”. Paylaşmadan önce yerel dosya yollarındaki kullanıcı adınızı çıkarın.

Belge kontrolü: 18 Eylül 2026. Adımlar resmî belgeler esas alınarak hazırlanmıştır; belirli bir modla uygulamalı kurulum testi yapılmamıştır.

Son kontrol: 2026-09-18