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

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

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

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

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

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

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

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

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

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

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 يحمّلان صلاحياتك وإعداداتك، وستنشئهما في الخطوة التالية. أما FiveM Enhanced فتمنع الموارد من الكتابة على القرص، وسطر 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 بمفتاح. هل تشغّل خادمك على Linux؟ ألقِ نظرة أيضًا على التشغيل على Linux.