FiveM sunucu sahiplerinin ve geliştiricilerinin en çok vakit harcadığı konulardan biri, sunucuya özel mekanlar (MLO) ve harita düzenlemeleri (YMAP) eklemektir. Yanlış kurulan bir harita paketi; oyuncuların haritadan aşağı düşmesine, görünmez duvarlara çarpmasına veya iki farklı mekanın üst üste binerek (overlapping) grafiklerin çıldırmasına neden olabilir.
2026 yılı standartlarında, doğru dosya mimarisi ve manifest yapılandırmasıyla bu sorunların tamamının önüne geçebilirsiniz. Bu rehberde, sıfırdan MLO kurulumundan harita çakışmalarının (map conflicts) tespit edilip çözülmesine kadar tüm adımları detaylandırıyoruz.
1. MLO ve YMAP Nedir? Arasındaki Farklar
Harita optimize işlemlerine geçmeden önce neyle çalıştığımızı anlamak kritik önem taşır:
- YMAP (.ymap): GTA V dünyasına nesne (object), ışık veya bitki örtüsü eklemek ya da var olanları kaldırmak için kullanılan yerleşim dosyalarıdır.
- MLO (Interior): Binaların içine girilebilir alanlar kazandıran, 3D modelleme yazılımlarıyla (3ds Max, Blender vb.) üretilmiş 3 boyutlu iç mekan tasarımlarıdır.
- YTYP (.ytyp): MLO içerisindeki kapıların, ışıkların ve nesne tiplerinin fiziksel özelliklerini tanımlayan archetypes (tipler) belgesidir.
2. Adım Adım MLO ve Harita Kurulumu
Bir harita eklentisini sunucunuza eklerken klasör hiyerarşisi en önemli unsurdur.
Adım 1: Klasör Yapısını Oluşturun
Sunucunuzun resources/ dizininde kategorize edilmiş bir klasör açın. Örneğin: resources/[mapping]/dexta_police_mlo/.
Dosya yapınız tam olarak şu şekilde olmalıdır:
dexta_police_mlo/
├── fxmanifest.lua
└── stream/
├── police_shell.ydr
├── police_placement.ymap
└── custom_ityp.ytypAdım 2: Modern fxmanifest.lua Dosyasını Hazırlayın
2026 standartlarında __resource.lua kullanımı tamamen terk edilmiştir. Haritanızın sorunsuz yüklenmesi için fxmanifest.lua dosyanızda YTYP tanımlamasını doğru yapmalısınız.
fx_version 'cerulean'
game 'gta5'
author 'Dexta Store'
description 'Modern Emniyet Müdürlüğü MLO Tasarımı'
version '1.0.0'
-- MLO içerisindeki özel nesne ve kapı tiplerini tanımlıyoruz
this_is_a_map 'yes'
data_file 'DLC_ITYP_REQUEST' 'stream/custom_ityp.ytyp'.ytyp dosyası varsa, her biri için ayrı bir data_file 'DLC_ITYP_REQUEST' satırı eklemelisiniz.3. Harita Çakışmaları (Map Conflicts) ve Görünmez Duvar Sorunları
Sunucuya yeni bir MLO eklediğinizde en sık karşılaşılan sorun, GTA V'in varsayılan (vanilla) haritasındaki orijinal bina ile yeni eklediğiniz MLO'nun çakışmasıdır.
Problem 1: İki Binanın Üst Üste Binmesi veya Varsayılan Kapıların Durması
Çözüm: Yeni MLO mekanının olduğu bölgedeki orijinal GTA V nesnelerinin kaldırılması gerekir. MLO geliştiricileri genellikle occlusion veya manifest temizleme YMAP'leri sunarlar.
- 1Harita paketiniz içindeki
_occlusion.ymapveya_manifest.ymapdosyalarınınstream/klasöründe yer aldığından emin olun. - 2Eğer varsayılan GTA kapıları yeni MLO kapılarıyla üst üste biniyorsa,
bob737_iplveya modern harita sökücü scriptler kullanarak ilgili IPL bölgesini disable etmeniz gerekebilir.
Problem 2: Görünmez Duvarlar (Collision Issues)
Eğer oyuncular bir odaya girdiğinde görünmez bir duvara çarpıyorsa:
.ybn(Collision - Çarpışma) dosyasıstreamklasörüne eksik yüklenmiştir.- Veya MLO
manifest.ymapdosyasıfxmanifest.luaiçerisindethis_is_a_map 'yes'olarak tanımlanmamıştır.
4. server.cfg Üzerinden Haritayı Başlatma
Haritanızı hazırdan sonra server.cfg dosyanıza ekleyin:
# [mapping] grubunu topluca başlatabilir veya tekil isim verebilirsiniz
ensure [mapping]
# veya
ensure dexta_police_mloSıkça Sorulan Sorular (SSS)
1. MLO kurduktan sonra oyuncular haritadan aşağı düşüyor, nedeni nedir?
Bu durum genellikle .ybn (collision) dosyalarının eksik yüklenmesinden veya fxmanifest.lua dosyasında this_is_a_map 'yes' satırının unutulmasından kaynaklanır. Ayrıca istemci tarafında harita yüklenme hızı (streaming) yavaşsa oyuncu henüz yüklenmemiş zemine basıp düşebilir.
2. İki farklı harita paketinin birbiriyle çakıştığını nasıl anlarım?
Mekan içerisinde kameranızı çevirdiğinizde duvarlar gidip geliyorsa (flickering/z-fighting) veya varsayılan GTA V binasının parçaları görünüyorsa çakışma var demektir. Codewalker veya OpenIV kullanarak o koordinattaki çakışan YMAP dosyalarını tespit edip kaldırmalısınız.
3. MLO kapılarını kilit sistemine (Doorlock) nasıl bağlarım?
MLO dosyasındaki kapıların model adını (prop hash) veya koordinatlarını alarak ox_doorlock veya qb-doorlock konfigürasyon dosyasına eklemeniz gerekir. MLO yapımcıları genelde bu koordinatları bir readme.txt içinde hazır sunarlar.