التثبيت على FiveM Legacy

هذه الصفحة مخصصة لـ FiveM العادية، المبنية على GTA V الأصلية، والتي نسميها FiveM Legacy. هل تستخدم FiveM Enhanced بدلًا منها؟ إذن تحتاج إلى التثبيت على FiveM Enhanced. يقدّم vMenu Enhanced القوائم والميزات نفسها تمامًا على كليهما.

قبل أن تبدأCopy Anchor Link

• هذا ليس vMenu الأصلي. له أسماء صلاحيات خاصة به، ولا يقرأ أي شيء حفظه vMenu الأصلي. لا تشغّل الاثنين معًا أبدًا. أما vMenu الأصلي، بالإصدار v3.9.2 وما قبله، فلم يعد يتلقى تحديثات، لكن توثيقه ما زال متاحًا هنا.
• أبقِ server artifacts محدّثة. يرسل vMenu أمورًا مثل فحوصات التحديث وwebhooks عبر مساعد صغير مكتوب بـ Node.js، ويحتاج ذلك إلى Node.js الإصدار 22 الذي تأتي به الـ artifacts الحالية. إذا ظهر في وحدة التحكم أن net bridge لم يستجب أبدًا، فحدّث الـ artifacts لديك.

الطريقة السريعة، عبر txAdminCopy Anchor Link

txAdmin هو لوحة التحكم المرفقة مع كل خادم FiveM. و"الوصفات" (recipes) فيه تُعدّ لك خادمًا جديدًا بالكامل. وصفة vMenu تمنحك vMenu Enhanced، مع صلاحيات وإعدادات جاهزة، وإضافات routing buckets وtheme picker وcustom themes. ويستطيع المشرف الذي أعددته في txAdmin استخدام القائمة كاملة فورًا.

اختر وصفة vMenu في شاشة الإعداد في txAdmin. وإن لم تكن ظاهرة في القائمة، فاختر "Remote URL Template" والصق هذا الرابط، وهو يشير دائمًا إلى أحدث إصدار:

https://github.com/TomGrobbe/vMenu/releases/latest/download/txadmin-vmenu-legacy-recipe.yaml

هذا كل شيء، ويمكنك تجاوز بقية هذه الصفحة. ملف server.cfg الذي ينشئه txAdmin لك يشرح كيفية إعداد صلاحيات الإضافات.

الطريقة اليدويةCopy Anchor Link

1. نزّله وفك ضغطهCopy Anchor Link

نزّل vMenu-Enhanced-Legacy-v<version>.zip من أحدث إصدار وفك ضغطه داخل مجلد resources. ملف zip الذي يحتوي اسمه على "Legacy" هو الوحيد الذي يعمل هنا. أما الآخر فيرفض العمل ويخبرك بذلك في وحدة التحكم.

2. أضف الأسطر الأولى إلى server.cfgCopy Anchor Link

exec @vMenu.Enhanced/config/permissions.cfg
exec @vMenu.Enhanced/config/configuration.cfg
add_filesystem_permission vMenu.Enhanced write vMenu.Enhanced
ensure vMenu.Enhanced

سطرا exec يحمّلان صلاحياتك وإعداداتك، وستنشئهما في الخطوة التالية. أما سطر add_filesystem_permission فيتيح لـ vMenu الكتابة داخل مجلده الخاص. يجب أن تأتي الأسطر الثلاثة كلها قبل ensure، وإلا فلن يتمكن أحد من فتح القائمة ولن يستطيع vMenu حفظ أي شيء.

هل تستخدم تكاملًا (integration) مع مزامنة الأدوار، حيث يقرر التكامل من ينتمي إلى أي مجموعة صلاحيات؟ عندها يحتاج vMenu أيضًا إلى هذين السطرين، وهما موجودان أصلًا في أعلى ملف permissions.cfg المثال:

add_ace resource.vMenu.Enhanced command.add_principal allow
add_ace resource.vMenu.Enhanced command.remove_principal allow

3. أنشئ ملفات الصلاحيات والإعداداتCopy Anchor Link

افتح resources/vMenu.Enhanced/config/. انسخ permissions.cfg.example وconfiguration.cfg.example، واحذف .example من اسمي النسختين. ثم عدّل النسختين:

• permissions.cfg يحدد من يحق له استخدام أي جزء من القائمة. ويستخدم صلاحيات "ace"، وهي طريقة FiveM للقول "هذا اللاعب أو هذه المجموعة مسموح لها بفعل هذا".
• configuration.cfg يحدد كيف يتصرف vMenu وما الذي يكون مفعّلًا.

لا يغيّر vMenu نسختيك أبدًا. أما ملفات .example فتُعاد كتابتها في كل مرة يبدأ فيها vMenu، لذلك تعرض دائمًا كل صلاحية وإعداد موجود. وتحديث نسختيك مسؤوليتك: بعد كل تحديث لـ vMenu، راجع سجل التغييرات أو قارن نسختيك بملفات .example، وأضف بنفسك أي صلاحيات أو إعدادات جديدة تريدها.

تلعب مع أصدقائك فقط؟ هذا السطر الواحد في permissions.cfg يكفي لتبدأ:

add_ace builtin.everyone "vMenu.Enhanced.Everything" allow

انتهيتCopy Anchor Link

أعد تشغيل خادمك، وادخل إليه، واضغط M لفتح القائمة. راجع اختصارات المفاتيح لمعرفة كل ما يربطه vMenu بمفتاح.

الإضافات على FiveM LegacyCopy Anchor Link

الإضافات المكتوبة بـ Lua أو JavaScript أو TypeScript تعمل على النسختين، بما فيها كل الإضافات الرسمية. أما إضافة C# فتحتاج إلى بناء مخصص لـ FiveM Legacy، راجع إعداد C#.