كيفية تركيب MLO (خرائط مخصصة) في سيرفر FiveM

MLO (كائنات مواقع الخرائط) تتيح لك إضافة تصميمات داخلية مخصصة أو تعديل التصميمات الداخلية الموجودة في GTA V على سيرفر FiveM الخاص بك. يشرح لك هذا الدليل كيفية تركيب مورد MLO بأمان ليُحمّل بشكل صحيح لجميع اللاعبين.

1) تنزيل حزمة MLO وفحصها

التحقق من المصدر

من أجل الأمان والاستقرار، نزّل دائماً ملفات MLO من مصادر موثوقة:

• البائعون الذين يوفّرون مجاميع التحقق SHA-256 أو مستودعات Git عامة.
• تجنّب الأرشيفات المُعاد تجميعها أو المعدّلة من مصادر غير معروفة.

التحقق من بنية المجلد

مورد MLO الصحيح يجب أن يتبع بنية مشابهة للمثال التالي:

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

إذا كانت هذه البنية موجودة، فأنت جاهز للمتابعة.

2) إنشاء مجلد Assets

بعد إعداد سيرفرك عبر txAdmin مع إطار عمل، ستتمكن من إضافة موارد إلى سيرفرك. سنستخدم QBCore في المثال التالي.

1. اذهب إلى لوحة تحكم DazcoHost.
2. انتقل إلى تبويب Files، وابحث عن المسار التالي: /txData/QBCore_XXXXX.base/resources.
3. أنشئ مجلداً في هذا المسار. في هذا المثال سنسميه: /[assets].

3) إنشاء Assets و fxmanifest.lua

1. انتقل إلى المسار /txData/QBCore_XXXXX.base/resources/assets.
2. أنشئ ملفاً جديداً بالضغط على زر New File وسمّه: fxmanifest.lua.
3. افتح ملف fxmanifest.lua. أدخل النص التالي داخله:

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'

4. احفظ الملف.

4) رفع مورد MLO

1. انتقل إلى /txData/QBCore_XXXXX.base/resources/ وأنشئ مجلد [maps] بالضغط على زر New Folder.
2. ارفع مجلد MLO بالكامل داخل المسار /[maps] (مثلاً: my-mlo) دون تعديل محتوياته، باستخدام زر Upload File(s).

5) تفعيل الخريطة و Assets في txAdmin

لكي يبدأ المورد تلقائياً، يجب إضافته إلى ملف server.cfg باستخدام أمر ensure resource-name. يمكنك إدارة هذا الملف بسهولة عبر CFG Editor في لوحة txAdmin.

1. اذهب إلى لوحة تحكم DazcoHost.
2. شغّل txAdmin.
3. انتقل إلى منطقة CFG Editor وأضف السطر: ensure [maps] و ensure [assets].
4. اضغط على زر Save File في الأسفل.