Sunucunuza FiveM MLO Nasıl Eklenir

Kitle: Zaten işlevsel bir FiveM örneği işleten ve bunu özel iç/dış harita varlıklarıyla (MLO'lar) genişletmek isteyen sunucu sahipleri ve geliştiriciler.

1 · Ön koşullar

Gereklilik	Minimum Sürüm	Neden önemlidir?
FiveM sunucu eseri	6016 (build 7116) veya daha yeni	Daha eski eserler modern olarak yüklenemez `cerulean` fx manifestleri.
Harita yükleyici (zaten yerleşik)	Varsayılan olarak yerel	Ekstra bir eklentiye gerek yok—FiveM akış harita dosyalarını otomatik olarak eşler.
Sunucuya Erişim	SFTP/SSH + yazma izinleri	Dosyaları yüklemeli ve düzenlemelisiniz sunucu.cfg.
Yasal lisans	Satın alma kanıtı / ücretsiz kullanım şartları	AB GDPR ve Rockstar politikaları lisanssız varlıkların dağıtımını yasaklamaktadır.

2 · MLO Paketini İndirin ve İnceleyin

Kaynak bütünlüğü – SHA‑256 imzalı zip dosyalarına veya genel Git etiketlerine sahip satıcıları tercih edin.
Yapıyı doğrula – Uyumlu bir kaynak şuna benzer:

my-mlo/
 ├─ stream/
 │ ├─ *.ydr ↰ (models)
 │ ├─ *.ytyp ↰ (item definitions)
 │ ├─ *.ybn ↰ (collisions‑―if supplied)
 │ └─ *.ytd ↰ (textures)
 ├─ fxmanifest.lua
 └─ README.md (optional)

Yaratmak fxmanifest.lua eğer eksikse – Minimal şablon:

fx_version 'cerulean'
games { 'gta5' }

author 'YourName'
description 'My Custom MLO'
version '1.0.0'

this_is_a_map 'yes'

files {
 'stream/**/*.ydr',
 'stream/**/*.ytyp',
 'stream/**/*.ytd',
 'stream/**/*.ybn'
}

data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'

ℹ️ Standartlar Kaynak manifestleri aşağıdaki şemayı takip eder: FiveM belgeleri → “Kaynak manifesti” (commit 20b7b15, 2025‑03‑11)

3 · Kaynağı Yükle

Sunucunuzun kök dizinine SFTP ile bağlanın.
Şuraya git: /resources/[maps]/—eğer mevcut değilse parantez klasörünü oluşturun.
Tümünü yükle my-mlo dizin değişmemişLinux yol sorunlarını önlemek için klasör adlarında boşluk ve büyük harf kullanmaktan kaçının.

4 · Kayıt olun `server.cfg`

Ekle (veya değiştir) start) sonrasında temel temel kaynaklar:

ensure my-mlo # loads on boot; restarts automatically on txAdmin soft‑restarts

Dosyayı kaydedin ve tekrar başlat sunucu veya yürütme refresh ➜ ensure my-mlo canlı konsolda.

5 · Önbelleği Temizle ve Yeniden Başlat (gerekirse)

FiveM harita verilerini önbelleğe alır. Eski sürümlerin hayaletlerinden kaçınmak için:

# Linux
rm -rf cache/*
./run.sh +exec server.cfg

# Windows (PowerShell)
Remove-Item -Recurse -Force .cache*
run.cmd +exec server.cfg

FiveM sunucularının önbelleği nasıl temizlenir

6 · Oyun İçi Doğrulama Kontrol Listesi

Kontrol etmek	Komut/araç	Geçme kriterleri
Işınlanma	vMenu → Çeşitli → Teleport → Koordinatları Gir	Oyuncu yeni iç/dış mekanda belirir.
Doku bütünlüğü	`profile_frame` sonra etrafta dolaş	Pembe/beyaz yer tutucu yok; FPS kaybı < 10%.
Çarpışma	Yürüyüş duvarları ve rampalar	Görünmez bir engel veya zeminden düşme yok.
Aydınlatma	Zaman döngüsü değişikliği ile `/time 23 0`	İç kısım, eser bırakmadan doğru şekilde koyulaştırılır/aydınlatılır.

Herhangi bir arıza meydana gelirse, dosya listesini yeniden ziyaret edin - eksik .ytd veya .ybn her zamanki suçludur.

7 · Birden Fazla MLO'yu Güvenli Şekilde Yayınlama

MLO başına bir kaynakBu, karma çakışmalarını önler.
Örneğin, satıcı etiketiyle adların önüne ekleyin bh-bank-lobby, daha kolay devre dışı bırakmak için.
Ayrıştırma uyarılarından kaçınmak için tüm harita kaynaklarında aynı manifesto sürümünü kullanın.

8 · Hızlı Başvuru Sorun Giderme

Belirti	Muhtemel Neden	Çözünürlük
Konsol: Manifest ayrıştırılamadı	Kötü Lua sözdizimi	Koşmak `lua -p fxmanifest.lua` yerel olarak; tırnak işaretlerini/virgülleri düzelt.
MLO görünür, dokular eksik	`.ytd` dosyalar başvurulmadı	Bunları ekleyin `files{}` veya yerleştirmek `stream/`.
Oyuncular katılırken çöküyor	Haritalarda yinelenen prop hash'i	Çifti yeniden adlandır `.ydr` veya çakışan kaynağı boşaltın.
Uzun indirme süresi	Büyük `.ytd` dokular	Dokuları sıkıştırın (DXT5 / BC3) veya küçültün.

9 · Uyumluluk ve Veri Koruma Notları

Yönetmelik / Politika	Yapmanız gerekenler
Rockstar Modlama Politikası (2015‑09‑15)	Rockstar IP'sini içeren varlıkları satmayın.
AB GDPR Madde 44‑49	Satıcı faturalarını saklayın; kullanıcı talebi üzerine varlık kaynağını açıklayın.
FiveM Hizmet Şartları §3.2	Kredileri olduğu gibi bırakın; ücretli modları kamuya açık şekilde yeniden dağıtmayın.

Çözüm

Yükle → ensure → yeniden başlatın; manifesto geçerliyse, yeni iç mekanınız iki dakika içinde yayına girer.

Yeni MLO'lara mı ihtiyacınız var?

Kaynaklar

FiveM Belgeleri – Kaynak Manifestleri (erişim: 22 Mayıs 2025)
Rockstar Games – Modding Politikası, 15 Eylül 2015
Regulation (EU) 2016/679 (GDPR), Madde 44‑49