این راهنما تمام آنچه برای راهاندازی سرور 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 خود را برای اولین بار دریافت میکنید، این مراحل را برای آنلاین کردن آن دنبال کنید:
- به GPanel وارد شوید و سرور alt:V خود را انتخاب کنید.
- به تب Startup بروید و نام سرور، حداکثر بازیکنان و سایر متغیرهای راهاندازی را پیکربندی کنید.
- به تب Console بروید و روی Start کلیک کنید.
- سرور در اولین بوت فایلهای سرور alt:V را دانلود میکند. این ممکن است چند دقیقه طول بکشد.
- هنگامی که کنسول نشان دهد سرور در حال گوش دادن و آماده اتصال است، سرور شما آنلاین است.
- به صورت پیشفرض، سرور بدون ریسورس گیممود شروع میشود. شما باید ریسورسها را برای ایجاد گیمپلی اضافه کنید. برای جزئیات به راهنمای مدیریت و تنظیم ریسورس alt:V مراجعه کنید.
متغیرهای راهاندازی GPanel
alt:V چندین گزینه پیکربندی را به عنوان متغیرهای راهاندازی در GPanel ارائه میدهد. به تب Startup بروید تا آنها را تغییر دهید. تغییرات نیاز به ریاستارت سرور دارند.
| متغیر | پیشفرض | توضیحات |
|---|---|---|
PASSWORD |
ChangeMe |
رمز عبور برای ورود به سرور. حداقل ۶ کاراکتر. |
SERVER_DESC |
A Pterodactyl Hosted Server |
توضیحات سرور که در مرورگر سرور alt:V نمایش داده میشود. |
BUILD |
release |
شاخه سرور alt:V: release (پایدار)، rc (کاندیدای انتشار)، یا dev (توسعه). |
پیکربندی سرور (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 نیاز دارید:
- به وبسایت alt:V بروید و وارد شوید یا یک حساب بسازید.
- به بخش مدیریت سرور بروید و یک توکن سرور جدید ایجاد کنید.
- توکن را کپی کرده و در فیلد
tokenدرserver.tomlقرار دهید. - مطمئن شوید
announce = trueدر پیکربندی شما تنظیم شده باشد. - سرور را ریاستارت کنید. اکنون باید در مرورگر عمومی نمایش داده شود.
server.toml شما باشد.
ریسورسهای گیممود
سرورهای 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 = 0bitrate کیفیت صدا را کنترل میکند (64000 استاندارد است). فیلدهای external* یک سرور صوتی خارجی را پیکربندی میکنند — آنها را خالی/صفر بگذارید تا از سرور صوتی داخلی استفاده شود که برای اکثر تنظیمات توصیه میشود. گزینه سرور صوتی خارجی فقط برای پیکربندیهای پیشرفتهای لازم است که پردازش صدا به یک ماشین جداگانه منتقل میشود.
نحوه اتصال بازیکنان
بازیکنان از طریق لانچر alt:V به سرورهای alt:V متصل میشوند، نه مستقیماً از طریق GTA V.
از طریق مرورگر سرور
- لانچر alt:V را از altvmp.com دانلود و نصب کنید.
- لانچر alt:V را اجرا کنید. نصب GTA V را شناسایی و تأیید خواهد کرد.
- از لانچر، Server Browser را مرور کنید.
- سرور خود را بر اساس نام جستجو کنید یا از فیلترها (گیممود، تگها، تعداد بازیکنان) استفاده کنید.
- روی سرور خود کلیک کرده و Connect را انتخاب کنید.
- اگر سرور رمز عبور دارد، از بازیکن خواسته میشود آن را وارد کند.
- GTA V با مود چندنفره alt:V اجرا شده و به سرور شما متصل میشود.
از طریق اتصال مستقیم
- در لانچر alt:V، Direct Connect را انتخاب کنید.
- آدرس IP و پورت سرور خود را در قالب
IP:PORTوارد کنید (مثلاً192.168.1.1:7788). - روی Connect کلیک کنید.
برای یافتن آدرس IP و پورت سرور، به نحوه یافتن IP و پورت سرور مراجعه کنید.
announce = true در server.toml تنظیم شده و یک توکن اعلان معتبر دارید. ممکن است سرور پس از راهاندازی یک دقیقه طول بکشد تا ثبت شود. کنسول را برای خطاهای اتصال به سرور اصلی بررسی کنید. توجه داشته باشید که پورت شما به صورت تصادفی اختصاص داده میشود مگر اینکه IP خصوصی داشته باشید -- مقدار صحیح را در GPanel بررسی کنید.
حداکثر بازیکنان و عملکرد
سرورهای alt:V میتوانند تعداد بالای بازیکنان را پشتیبانی کنند، اما عملکرد به شدت به ریسورسها و پلن سرور شما بستگی دارد:
- ۳۲–۱۲۸ بازیکن: محدوده رایج برای اکثر سرورها. گیممودهای ساده با تعداد بالاتر به خوبی اجرا میشوند.
- ۱۲۸–۵۱۲+ بازیکن: برای سرورهای بهینهسازی شده با ریسورسهای کارآمد امکانپذیر است. نیاز به CPU و RAM بیشتر دارد.
- کارایی ریسورس: اسکریپتهای بهینهسازی نشده اصلیترین دلیل مشکلات عملکرد هستند. اسکریپتهای سمت سرور که عملیات سنگین در هر تیک اجرا میکنند یا ساختارهای داده بزرگ در حافظه نگه میدارند، میتوانند سرور را گلوگاه کنند.
- کوئریهای پایگاه داده: گیممودهایی که از پایگاه داده (MySQL، MongoDB) استفاده میکنند باید از کوئریهای async استفاده کنند تا ترد اصلی مسدود نشود.
مقالات مرتبط
- راهنمای مدیریت و تنظیم ریسورس alt:V — توسعه ریسورس، تنظیم پایگاه داده، ابزارهای ادمین و عیبیابی
- نحوه یافتن IP و پورت سرور
- نحوه آپلود فایل از طریق SFTP
- راهنمای راهاندازی سرور — راهنمای عمومی برای شروع هر سرور بازی در Legion Hosting
به کمک بیشتری نیاز دارید؟
اگر مشکلاتی دارید که در این راهنما پوشش داده نشده است، تیم پشتیبانی ما آماده کمک است. یک تیکت در legionhosting.net/submitticket.php با جزئیات سرور و شرح مشکل باز کنید.
