# التثبيت على FiveM Legacy (/ar/docs/enhanced/installing/fivem-legacy)

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

## قبل أن تبدأ [#قبل-أن-تبدأ]

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

## الطريقة السريعة، عبر txAdmin [#الطريقة-السريعة-عبر-txadmin]

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

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

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

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

## الطريقة اليدوية [#الطريقة-اليدوية]

### 1. نزّله وفك ضغطه [#1-نزّله-وفك-ضغطه]

نزّل `vMenu-Enhanced-Legacy-v<version>.zip` من [أحدث إصدار](https://github.com/TomGrobbe/vMenu/releases/latest) وفك ضغطه داخل مجلد `resources`. ملف zip الذي يحتوي اسمه على "Legacy" هو الوحيد الذي يعمل هنا. أما الآخر فيرفض العمل ويخبرك بذلك في وحدة التحكم.

:::danger[اسم المجلد مهم]
سمِّ المجلد `vMenu.Enhanced` تمامًا كما هو، بما في ذلك الأحرف الكبيرة، حتى وإن لم يكن خادمك FiveM Enhanced. فكل اسم صلاحية وإعداد مبني عليه، ويرفض vMenu العمل تحت أي اسم آخر.
:::

### 2. أضف الأسطر الأولى إلى server.cfg [#2-أضف-الأسطر-الأولى-إلى-servercfg]

```ini
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 حفظ أي شيء.

هل تستخدم [تكاملًا](https://github.com/TomGrobbe/vMenu/blob/main/docs/src/content/docs../integrations.md) (integration) مع مزامنة الأدوار، حيث يقرر التكامل من ينتمي إلى أي مجموعة صلاحيات؟ عندها يحتاج vMenu أيضًا إلى هذين السطرين، وهما موجودان أصلًا في أعلى ملف `permissions.cfg` المثال:

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

### 3. أنشئ ملفات الصلاحيات والإعدادات [#3-أنشئ-ملفات-الصلاحيات-والإعدادات]

افتح `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` يكفي لتبدأ:

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

:::danger[هذا يمنح الجميع كل شيء]
استخدم هذا السطر فقط على خادم بقائمة بيضاء لا يستطيع أي شخص عشوائي الانضمام إليه.
:::

### انتهيت [#انتهيت]

أعد تشغيل خادمك، وادخل إليه، واضغط `M` لفتح القائمة. راجع [اختصارات المفاتيح](../key-bindings.md) لمعرفة كل ما يربطه vMenu بمفتاح.

## الإضافات على FiveM Legacy [#الإضافات-على-fivem-legacy]

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