كيفية تثبيت MLO على خادم FiveM

ما هو FiveM MLO

MLO هو الاسم الذي يطلقه المجتمع على مساحة داخلية مخصصة تُضاف إلى خريطة GTA V، وتُبنى بالطريقة نفسها التي بُنيت بها المساحات الداخلية الخاصة بـ Rockstar. يدخلها اللاعبون من الشارع مباشرة، دون انتقال فوري أو شاشة تحميل.

يصنع مبدعو الخرائط ملفات MLO، إما مجاناً على منتدى Cfx.re أو مدفوعة تُباع عادةً عبر Tebex. بالنسبة إلى FiveM، فإن MLO مجرد مورد يبث ملفات خريطة، لذا يُثبَّت مثل أي خريطة أخرى.

كيف يبدو مورد MLO

مورد الخريطة هو مجلد يحتوي على ملف manifest ومجلد stream يضم ملفات اللعبة:

my_mlo/
├── fxmanifest.lua
└── stream/
    ├── my_mlo.ymap
    ├── my_mlo.ytyp
    ├── my_mlo.ybn
    ├── my_mlo.ydr
    └── my_mlo.ytd

تقدّم وثائق FiveM ملف manifest التالي للخريطة:

fx_version 'cerulean'
game 'gta5'
lua54 'yes'
this_is_a_map 'yes'

معظم ملفات MLO التي تنزّلها تتضمن الاثنين مسبقاً. إذا كان في ملف manifest الخاص بالمبدع أسطر إضافية، مثل إدخالات data_file، فاتركها كما هي.

ثبّت الـ MLO

1. فك ضغط الملف المنزَّل وابحث عن المجلد الذي يحتوي على fxmanifest.lua. هذا المجلد هو المورد؛ بعض التنزيلات تضعه داخل مجلد إضافي.
2. ارفعه إلى مجلد resources في خادمك، مع اسم مجلد بسيط: بلا مسافات.
3. أضفه إلى server.cfg:

   ensure my_mlo

4. حمّله. أعد تشغيل الخادم، أو نفّذ في وحدة تحكم الخادم refresh لاكتشاف المجلد الجديد، ثم ensure my_mlo.
5. زُر الموقع داخل اللعبة وادخل. إذا كانت الجدران مفقودة أو سقطت عبر الأرضية، فراجع وحدة التحكم بحثاً عن أخطاء تخص ذلك المورد.

إعادة تشغيل الخادم بالكامل هي الطريقة الأكثر أماناً لتحميل مورد خريطة جديد.

ملفات MLO المشفرة من Tebex

تستخدم كثير من ملفات MLO المدفوعة نظام asset escrow من Cfx.re: الملفات مشفرة ولا تعمل إلا على الخوادم التي يعود مفتاح ترخيصها (license key) إلى الحساب الذي اشتراها.

• اشترِ بالحساب الصحيح. يجب أن يكون حساب Cfx.re المرتبط عند الدفع هو الحساب الذي يملك مفتاح ترخيص خادمك.
• ارفع جميع الملفات، بما فيها الملف المخفي .fxap. بعض برامج FTP تتخطى الملفات المخفية، وبدونه يفشل المورد مع الخطأ "Failed to verify protected resource".
• ظهور "You lack the required entitlement" في وحدة التحكم يعني أن مفتاح الترخيص والشراء على حسابين مختلفين. تحقق من المفتاح، أو انقل الشراء إلى الحساب الصحيح عبر بوابة Cfx.re؛ يمكن نقل الشراء مرة واحدة.
• الملفات المشفرة لا يمكن تعديلها، لكن المبدعين عادةً يتركون ملفات الإعداد غير مشفرة للإعدادات المقصود أن تغيّرها.

ملفات MLO التي تحتاج إصدار لعبة أحدث

تستخدم بعض ملفات MLO عناصر (props) أو مساحات داخلية من تحديث لاحق لـ GTA Online. تحتاج هذه إلى أن يعمل الخادم على ذلك الـ game build؛ وعلى إصدار أقدم، تختفي أجزاء أو يرفض المورد العمل. عادةً ما تذكر صفحة المبدع الإصدار المطلوب.

اضبطه في server.cfg، على سبيل المثال:

sv_enforceGameBuild 3407

لا يسري إلا عند بدء تشغيل الخادم، وكل إصدار يتضمن محتوى الإصدارات السابقة، لذا استخدم أعلى إصدار تحتاجه ملفات MLO لديك. ينقل FiveM اللاعبين إلى ذلك الإصدار عند انضمامهم.

التعارضات والأداء

• MLO واحد لكل موقع. عادةً ما يتعارض ملفا MLO يستبدلان المبنى نفسه: جدران تومض، وأرضيات غير مرئية، وأبواب في غير مكانها. احتفظ بواحد فقط، أو اطلب من المبدعين نسخاً متوافقة.
• راقب وحدة التحكم بحثاً عن الأصول كبيرة الحجم. يحذّر FiveM من الملفات المبثوثة التي تستهلك أكثر من 16 MB من الذاكرة، وفوق 48 MB ينبّه إلى أنها ستسبب مشكلات في البث مثل عدم تحميل النماذج. فضّل ملفات MLO المحسّنة.
• لا تثبّت كل شيء دفعة واحدة. أضف بضعة ملفات MLO، واختبر، ثم أضف المزيد. عندما يتعطل شيء، ستعرف أيها السبب.

استخدم فقط ملفات MLO التي تملك حقوقها

يحظر ترخيص منصة FiveM استخدامها بطرق تنتهك حقوق الآخرين، ولا يسمح منتدى Cfx.re بالإصدارات التي تنتهك الملكية الفكرية لأطراف ثالثة، مثل العلامات التجارية الحقيقية والنماذج ثلاثية الأبعاد المأخوذة من ألعاب أخرى. عملياً:

• استخدم ملفات MLO المجانية من صفحة إصدارها الرسمية، والمدفوعة المشتراة من مبدعها؛
• لا تستخدم أبداً نسخاً مسرّبة أو "مكسورة" من ملفات MLO المدفوعة: فهي تنتهك ترخيص المبدع، والمشفرة منها لن تعمل على أي حال؛
• احتفظ بإشارات المبدع وملف الترخيص داخل المورد.

ملفات MLO على خوادم HytHost FiveM

على استضافة HytHost FiveM، يدير txAdmin خادمك، ويوجد ملف server.cfg ومجلد resources في مجلد بيانات txAdmin، أي txData. ارفع ملفات MLO إلى هناك عبر مدير الملفات في اللوحة أو SFTP، وعدّل server.cfg في محرر CFG الخاص بـ txAdmin.

• لا تلمس ملف server.cfg الموجود في المجلد الرئيسي: تعيد اللوحة كتابته عند كل تشغيل، وليس هو الملف الذي يشغّله txAdmin.
• أضف sv_enforceGameBuild بنفسك إلى server.cfg الخاص بـ txAdmin عندما يحتاجه أحد ملفات MLO.
• يتحدّث الخادم افتراضياً إلى أحدث FiveM artifacts عند كل تشغيل.

جديد على FiveM؟ ابدأ بدليل كيفية إنشاء خادم FiveM.