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

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

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

txAdmin هو لوحة التحكم المرفقة مع كل خادم FiveM. و"الوصفات" (recipes) فيه تُعدّ لك خادمًا جديدًا بالكامل. وصفة vMenu Enhanced تمنحك 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 استخدام القائمة كاملة فورًا. أما FiveM Legacy فلها [وصفتها الخاصة](./fivem-legacy.md)، ولم تعد لـ vMenu الأصلي وصفة.

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

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

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

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

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

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

:::danger[اسم المجلد مهم]
سمِّ المجلد `vMenu.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` يحمّلان صلاحياتك وإعداداتك، وستنشئهما في الخطوة التالية. أما FiveM Enhanced فتمنع الموارد من الكتابة على القرص، وسطر `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 بمفتاح. هل تشغّل خادمك على Linux؟ ألقِ نظرة أيضًا على [التشغيل على Linux](../running-on-linux.md).