يغطي هذا الدليل كل ما تحتاجه لتشغيل سيرفر alt:V الخاص بك على Legion Hosting، من التشغيل الأول وإعداد server.toml إلى موارد أوضاع اللعب، وإعداد CDN، والدردشة الصوتية، وكيفية اتصال اللاعبين عبر مشغّل alt:V. لتطوير الموارد وإعداد قاعدة البيانات وإدارة المشرفين، راجع دليل إعداد الإدارة والموارد في alt:V.

---

ما هو alt:V؟

alt:V هو تعديل مجاني ومفتوح المصدر للعب الجماعي في Grand Theft Auto V. يتيح للاعبين الاتصال بسيرفرات مخصصة تعمل بأوضاع لعب فريدة مثل تقمص الأدوار (RP)، والقتال الحر، والسباقات، والتجول الحر، والمزيد. يعمل السيرفر بموارد مخصصة مكتوبة بلغة JavaScript أو TypeScript أو C#، مما يمنح مالكي السيرفرات تحكمًا كاملاً في منطق اللعب. يتصل اللاعبون عبر مشغّل alt:V الذي يعدّل GTA V للاتصال متعدد اللاعبين.

---

التشغيل الأول

عند استلام سيرفر alt:V الخاص بك لأول مرة، اتبع هذه الخطوات لتشغيله:

1. سجّل الدخول إلى GPanel واختر سيرفر alt:V الخاص بك.
2. انتقل إلى تبويب Startup وقم بتكوين اسم السيرفر والحد الأقصى للاعبين ومتغيرات التشغيل الأخرى.
3. اذهب إلى تبويب Console وانقر على Start.
4. سيقوم السيرفر بتنزيل ملفات سيرفر alt:V عند التشغيل الأول. قد يستغرق هذا بضع دقائق.
5. بمجرد أن تعرض وحدة التحكم أن السيرفر يستمع وجاهز للاتصالات، يكون سيرفرك متصلاً بالإنترنت.
6. بشكل افتراضي، يبدأ السيرفر بدون موارد أوضاع لعب. ستحتاج إلى إضافة موارد لإنشاء تجربة لعب. راجع دليل إعداد الإدارة والموارد في alt:V للتفاصيل.

---

متغيرات التشغيل في GPanel

يوفر alt:V عدة خيارات تكوين كمتغيرات تشغيل في GPanel. انتقل إلى تبويب Startup لتعديلها. تتطلب التغييرات إعادة تشغيل السيرفر.

---

تكوين السيرفر (server.toml)

ملف التكوين الرئيسي لسيرفرات alt:V هو server.toml، الموجود في المجلد الجذر للسيرفر. يمكنك تعديل هذا الملف من خلال تبويب Files في GPanel أو عبر SFTP.

مثال على server.toml

name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]

الإعدادات الرئيسية: name (اسم العرض في المتصفح)، host (اتركه 0.0.0.0)، port (يجب أن يتطابق مع GPanel)، players (الحد الأقصى للعدد)، password (اتركه فارغًا للسيرفر العام)، announce (true للظهور في المتصفح)، token (رمز الإعلان من موقع alt:V، مطلوب لظهور السيرفر في القائمة)، gamemode (تسمية المتصفح مثل "Roleplay")، modules (وحدات السكربتات: js-module أو csharp-module)، resources (مصفوفة مجلدات الموارد المراد تحميلها)، وtags (وسوم تصفية المتصفح).

---

رمز الإعلان

لكي يظهر سيرفرك في متصفح سيرفرات alt:V، تحتاج إلى رمز إعلان من السيرفر الرئيسي لـ alt:V:

1. قم بزيارة موقع alt:V وسجّل الدخول أو أنشئ حسابًا.
2. انتقل إلى قسم إدارة السيرفرات وقم بإنشاء رمز سيرفر جديد.
3. انسخ الرمز والصقه في حقل token في ملف server.toml الخاص بك.
4. تأكد من أن announce = true في التكوين الخاص بك.
5. أعد تشغيل السيرفر. يجب أن يظهر الآن في المتصفح العام.

---

موارد أوضاع اللعب

تعمل سيرفرات alt:V بالموارد — وهي سكربتات تحدد كل منطق اللعب. بدون موارد، لا يحتوي السيرفر على أي وظائف مخصصة. توضع الموارد في مجلد resources/.

هيكل الموارد

resources/
  myresource/
    resource.toml       <-- Resource configuration
    server/
      index.js          <-- Server-side script
    client/
      index.js          <-- Client-side script (runs on the player's GTA V)

تحميل الموارد

أضف أسماء الموارد إلى مصفوفة resources في server.toml لتحميلها عند بدء التشغيل:

resources = ["chat", "freeroam", "spawn"]

يجب أن يحتوي كل مورد على ملف resource.toml في مجلده يحدد نوعه واعتماداته ونقاط دخول السكربتات. للتفاصيل حول إنشاء وإدارة الموارد، راجع دليل إعداد الإدارة والموارد في alt:V.

---

إعداد CDN

يستخدم alt:V آلية CDN لتقديم الملفات من جانب العميل (النماذج، والأنسجة، والسكربتات) للاعبين المتصلين. يقوم CDN المدمج بتقديم الملفات مباشرة من السيرفر دون الحاجة إلى أي تكوين إضافي — وهذا هو الإعداد الافتراضي ويعمل بشكل جيد لمعظم السيرفرات. للسيرفرات الكبيرة التي تحتوي على العديد من الأصول المخصصة، يمكنك اختياريًا تكوين CDN خارجي عن طريق رفع ملفات العميل إلى سيرفر ويب وتعيين عنوان URL الخاص بـ CDN في تكوين المورد، مما يقلل استهلاك عرض النطاق الترددي لسيرفر اللعبة.

---

الدردشة الصوتية

يتضمن alt:V نظام دردشة صوتية مدمج يتيح التواصل الصوتي الموضعي (ثلاثي الأبعاد) بين اللاعبين. يتم تفعيل الدردشة الصوتية وتكوينها في server.toml.

تكوين الصوت

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

يتحكم bitrate في جودة الصوت (64000 هو المعيار). تُكوّن حقول external* سيرفر صوت خارجي — اتركها فارغة/صفر لاستخدام سيرفر الصوت المدمج، وهو الموصى به لمعظم الإعدادات. خيار سيرفر الصوت الخارجي مطلوب فقط للتكوينات المتقدمة حيث يتم نقل معالجة الصوت إلى جهاز منفصل.

---

كيفية اتصال اللاعبين

يتصل اللاعبون بسيرفرات alt:V من خلال مشغّل alt:V، وليس من خلال GTA V مباشرة.

عبر متصفح السيرفرات

1. قم بتنزيل وتثبيت مشغّل alt:V من altvmp.com.
2. شغّل مشغّل alt:V. سيكتشف ويتحقق من تثبيت GTA V.
3. من المشغّل، تصفح متصفح السيرفرات.
4. ابحث عن سيرفرك بالاسم أو استخدم الفلاتر (وضع اللعب، الوسوم، عدد اللاعبين).
5. انقر على سيرفرك واختر Connect.
6. إذا كان السيرفر يحتوي على كلمة مرور، سيُطلب من اللاعب إدخالها.
7. ستُشغّل GTA V مع تعديل alt:V للعب الجماعي وتتصل بسيرفرك.

عبر الاتصال المباشر

1. في مشغّل alt:V، اختر Direct Connect.
2. أدخل عنوان IP السيرفر والمنفذ بالتنسيق IP:PORT (مثال: 192.168.1.1:7788).
3. انقر على Connect.

للعثور على عنوان IP السيرفر والمنفذ، راجع كيفية العثور على عنوان IP السيرفر والمنفذ.

---

الحد الأقصى للاعبين والأداء

يمكن لسيرفرات alt:V دعم أعداد كبيرة من اللاعبين، لكن الأداء يعتمد بشكل كبير على مواردك وخطة السيرفر:

• 32–128 لاعب: نطاق شائع لمعظم السيرفرات. تعمل أوضاع اللعب البسيطة بسلاسة مع أعداد أكبر.
• 128–512+ لاعب: ممكن للسيرفرات المحسّنة ذات الموارد الفعّالة. يتطلب المزيد من المعالج والذاكرة.
• كفاءة الموارد: السكربتات غير المحسّنة هي السبب الرئيسي لمشاكل الأداء. السكربتات من جانب السيرفر التي تنفذ عمليات ثقيلة في كل دورة أو تحتفظ بهياكل بيانات كبيرة في الذاكرة يمكن أن تعيق السيرفر.
• استعلامات قاعدة البيانات: أوضاع اللعب التي تستخدم قواعد بيانات (MySQL، MongoDB) يجب أن تستخدم استعلامات غير متزامنة لتجنب حظر الخيط الرئيسي.

---

مقالات ذات صلة

• دليل إعداد الإدارة والموارد في alt:V — تطوير الموارد، إعداد قاعدة البيانات، أدوات الإدارة، واستكشاف الأخطاء
• كيفية العثور على عنوان IP السيرفر والمنفذ
• كيفية رفع الملفات عبر SFTP
• دليل بدء تشغيل السيرفر — دليل عام لبدء تشغيل أي سيرفر ألعاب على Legion Hosting

---

هل تحتاج مساعدة إضافية؟

إذا كنت تواجه مشاكل غير مشمولة في هذا الدليل، فإن فريق الدعم لدينا متاح للمساعدة. افتح تذكرة على legionhosting.net/submitticket.php مع تفاصيل سيرفرك ووصف المشكلة.