این راهنما شما را در مراحل راهاندازی سرور FiveM (چندنفره GTA V) میزبانی شده توسط Legion Hosting راهنمایی میکند — از دریافت کلید لایسنس CFX و پیکربندی TXAdmin، تا ویرایش server.cfg و اتصال بازیکنان.
قبل از شروع: مطمئن شوید که اطلاعات ورود GPanel را از ایمیل خوشآمدگویی خود دارید و سرور FiveM شما در حساب کاربریتان ایجاد شده است. اگر قبلاً سروری راهاندازی نکردهاید، ابتدا راهنمای راهاندازی سرور را مطالعه کنید.
پیشنیازها
- یک سرور FiveM از Legion Hosting (فعال در حساب کاربری شما)
- یک حساب کاربری انجمن Cfx.re (رایگان — برای ایجاد کلید لایسنس ضروری است)
- دسترسی به GPanel
- کلاینت FiveM نصب شده روی کامپیوتر شما (fivem.net)
مرحله ۱: دریافت کلید لایسنس CFX
هر سرور FiveM به یک کلید لایسنس منحصر به فرد از Cfx.re (توسعهدهندگان FiveM) نیاز دارد. این کلید رایگان است و به حساب Cfx.re شما متصل میشود.
- به https://keymaster.fivem.net/ بروید و با حساب انجمن Cfx.re خود وارد شوید.
- روی New Server (یا Register a new server) کلیک کنید.
- جزئیات را پر کنید:
- Label: یک نام دوستانه برای سرور شما (مثلاً "My Legion FiveM Server")
- Server IP Address: آدرس IP سرور خود را از GPanel وارد کنید (به نحوه یافتن IP و پورت سرور مراجعه کنید)
- Server Type: نوع مناسب را انتخاب کنید (معمولاً "Other / Apache / nginx")
- روی Generate کلیک کنید.
- کلید لایسنس ایجاد شده را کپی کنید — در مراحل بعدی به آن نیاز خواهید داشت.
کلید لایسنس خود را محرمانه نگه دارید. آن را به صورت عمومی به اشتراک نگذارید. اگر کلید شما لو رفت، میتوانید آن را در صفحه Keymaster لغو کنید و یک کلید جدید ایجاد نمایید.
مرحله ۲: اولین راهاندازی سرور و تنظیمات TXAdmin
سرورهای FiveM میزبانی شده توسط Legion Hosting شامل TXAdmin هستند — یک پنل مدیریت تحت وب که در کنار سرور FiveM شما اجرا میشود. در اولین راهاندازی، TXAdmin شما را در تنظیمات اولیه راهنمایی میکند.
راهاندازی سرور
- وارد GPanel شوید و سرور FiveM خود را انتخاب کنید.
- به تب Startup بروید و متغیر FIVEM_LICENSE (یا متغیر مشابه) را پیدا کنید. کلید لایسنس CFX خود را اینجا وارد کنید و ذخیره نمایید.
- به تب Console بروید و روی Start کلیک کنید.
- خروجی کنسول را مشاهده کنید. در اولین راهاندازی، سرور فایلهای مورد نیاز FiveM را دانلود میکند — این ممکن است چند دقیقه طول بکشد.
- وقتی TXAdmin آماده شد، پیامی در کنسول حاوی آدرس TXAdmin و یک کد PIN مشاهده خواهید کرد.
یافتن آدرس TXAdmin: TXAdmin روی پورتی جداگانه از سرور بازی اجرا میشود. خروجی کنسول یا تب Network در GPanel را برای پورت TXAdmin بررسی کنید. فرمت آدرس
http://YOUR_SERVER_IP:TXADMIN_PORT است.
تکمیل تنظیمات TXAdmin
- آدرس TXAdmin را در مرورگر خود باز کنید.
- PIN نمایش داده شده در خروجی کنسول GPanel را وارد کنید.
- حساب کاربری مدیر TXAdmin خود را ایجاد کنید (نام کاربری و رمز عبور).
- TXAdmin شما را از طریق یک ویزارد تنظیمات راهنمایی میکند:
- Server Name: نامی را انتخاب کنید که در مرورگر سرور FiveM نمایش داده شود.
- Deployment Type: یک قالب انتخاب کنید (مثلاً "Popular Recipes" برای یک پایه از پیش پیکربندی شده، یا "Remote URL / Template" اگر تنظیمات سفارشی دارید).
- Server Data Folder: این را در حالت پیشفرض رها کنید مگر اینکه دلیل خاصی برای تغییر آن دارید.
- CFX Key: اگر دوباره خواسته شد، کلید لایسنس خود را وارد کنید.
- ویزارد را تکمیل کنید و اجازه دهید TXAdmin استقرار فایلهای سرور را به پایان برساند. این ممکن است چند دقیقه طول بکشد.
اطلاعات ورود TXAdmin خود را ذخیره کنید. اگر دسترسی به حساب مدیر TXAdmin خود را از دست بدهید، باید پروفایل TXAdmin را حذف کنید و تنظیمات را مجدداً اجرا نمایید. نام کاربری و رمز عبور خود را یادداشت کنید.
مرحله ۳: پیکربندی server.cfg
فایل server.cfg فایل پیکربندی اصلی سرور FiveM شما است. TXAdmin یک نسخه پایه را در هنگام تنظیمات ایجاد میکند، اما باید آن را بررسی و سفارشیسازی کنید.
دسترسی به server.cfg
- در GPanel، روی تب Files کلیک کنید.
- به پوشه داده سرور خود بروید (معمولاً پوشه ریشه یا پوشهای که توسط قالب TXAdmin ایجاد شده است).
- روی
server.cfgکلیک کنید تا در ویرایشگر داخلی باز شود.
تنظیمات ضروری
| تنظیم | توضیحات | مثال |
|---|---|---|
sv_hostname |
نام سرور که در مرورگر سرور FiveM نمایش داده میشود | "My Legion FiveM Server" |
sv_licenseKey |
کلید لایسنس CFX شما از Keymaster | "cfxk_xxxxxxxxxxxxxxxxxxxx" |
sv_maxclients |
حداکثر تعداد بازیکنان مجاز در سرور | 48 |
endpoint_add_tcp |
آدرس و پورت TCP برای گوش دادن | "0.0.0.0:YOUR_PORT" |
endpoint_add_udp |
آدرس و پورت UDP برای گوش دادن | "0.0.0.0:YOUR_PORT" |
sv_endpointprivacy |
مخفیسازی آدرس IP بازیکنان در لیست سرور | true |
sets sv_projectName |
نام کوتاه پروژه که در جزئیات مرورگر سرور نمایش داده میشود | "My RP Server" |
sets sv_projectDesc |
توضیح کوتاه که در جزئیات مرورگر سرور نمایش داده میشود | "A custom roleplay server" |
نمونه حداقلی server.cfg:
# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"
# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"
# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"
# Player Limit
sv_maxclients 48
# Privacy
sv_endpointprivacy true
# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat
پورت باید با GPanel مطابقت داشته باشد. پورت در
endpoint_add_tcp و endpoint_add_udp باید با پورت بازی اختصاص داده شده به سرور شما در GPanel مطابقت داشته باشد. تب Network در GPanel را برای مشاهده پورت خاص خود بررسی کنید.
مرحله ۴: اتصال به سرور FiveM
وقتی سرور شما پیکربندی شده و در حال اجراست، بازیکنان میتوانند از طریق مرورگر سرور FiveM یا اتصال مستقیم متصل شوند.
اتصال مستقیم
- کلاینت FiveM را باز کنید.
- F8 را فشار دهید تا کنسول FiveM باز شود، یا روی دکمه Direct Connect در صفحه اصلی کلیک کنید.
- IP و پورت بازی سرور خود را در فرمت
IP:PORTوارد کنید. - روی Connect کلیک کنید.
یافتن IP و پورت: تب Network در GPanel را بررسی کنید یا به نحوه یافتن IP و پورت سرور مراجعه نمایید.
مرورگر سرور
- کلاینت FiveM را باز کنید و روی Play کلیک کنید.
- در مرورگر سرور، نام سرور خود را جستجو کنید (مقدار
sv_hostnameاز server.cfg). - روی سرور خود کلیک کنید و سپس روی Connect کلیک نمایید.
سرور در مرورگر نمایش داده نمیشود؟ سرورهای جدید ممکن است ۵ تا ۱۵ دقیقه طول بکشد تا در لیست سرور FiveM ظاهر شوند. در این مدت از اتصال مستقیم استفاده کنید. همچنین بررسی کنید که
sv_licenseKey معتبر باشد و پورتها در server.cfg با پیکربندی شبکه GPanel مطابقت داشته باشند.
مدیریت سرور با TXAdmin
پس از تنظیمات اولیه، TXAdmin یک داشبورد تحت وب برای مدیریت روزانه سرور ارائه میدهد. از آدرس http://YOUR_SERVER_IP:TXADMIN_PORT به آن دسترسی پیدا کنید.
| ویژگی | توضیحات |
|---|---|
| Dashboard | مشاهده وضعیت سرور، تعداد بازیکنان و معیارهای عملکرد به صورت یکجا. |
| Players | مشاهده بازیکنان آنلاین، اخراج یا بن کردن بازیکنان، مشاهده تاریخچه بازیکنان. |
| Live Console | اجرای دستورات سرور به صورت بلادرنگ، مشابه کنسول داخل بازی. |
| Resources | شروع، توقف و ریستارت ریسورسهای فردی بدون نیاز به ریستارت کل سرور. |
| Server Log | مشاهده لاگهای عملیات برای بررسی اقدامات بازیکنان و مدیران. |
| CFG Editor | ویرایش server.cfg مستقیماً از TXAdmin بدون نیاز به مدیر فایل GPanel. |
| Scheduled Restarts | پیکربندی ریستارتهای خودکار در بازههای زمانی مشخص برای حفظ تازگی سرور. |
دریافت کمک
اگر این راهنما را دنبال کردهاید و همچنان با مشکل مواجه هستید:
- هرگونه پیام خطا را از کنسول GPanel یا لاگ TXAdmin کپی کنید.
- یادداشت کنید در کدام مرحله گیر کردهاید و چه اقداماتی انجام دادهاید.
- یک تیکت پشتیبانی در https://legionhosting.net/submitticket.php با این اطلاعات ارسال کنید. تیم ما در سریعترین زمان ممکن به شما کمک خواهد کرد.
