آموزش جامع و پیشرفته ساخت و مدیریت سرور FiveM

🚀 آموزش جامع و پیشرفته ساخت و مدیریت سرور FiveM 🚀

فایو ام (FiveM) چیست و چرا باید سرور خود را بسازیم؟

فایوم ام (Fivem) فراتر از یک لانچر ساده مولتی‌پلیر برای بازی محبوب GTA V است. این پلتفرم یک بستر قدرتمند و انعطاف‌پذیر را فراهم می‌کند که به شما امکان می‌دهد سرورهای کاملاً سفارشی‌شده با قوانین، حالت‌های بازی منحصر به فرد، و اسکریپت‌های خاص خود را ایجاد کنید و یک کامیونیتی اختصاصی بازیکنان را شکل دهید. این قابلیت‌ها FiveM را به گزینه‌ای ایده‌آل برای افرادی تبدیل می‌کند که به دنبال تجربه‌ای متفاوت و عمیق‌تر از GTA Online هستند.

قابلیت‌های کلیدی و مزایای راه‌اندازی سرور FiveM:

• ✨ انعطاف‌پذیری بی‌نظیر: قابلیت نصب هزاران پلاگین و اسکریپت (که در FiveM به آن‌ها Resources گفته می‌شود) به شما اجازه می‌دهد تا هر بخش از سرور خود را، از سیستم اقتصادی و شغل‌ها گرفته تا وسایل نقلیه، لباس‌ها، و حتی محیط بازی، کاملاً شخصی‌سازی کنید. این به معنای ساخت یک تجربه منحصر به فرد و دقیقاً مطابق با دیدگاه شماست.
• 🎮 تنوع حالت‌های بازی: در حالی که یکی از پرطرفدارترین حالت‌ها، رول‌پلی (Roleplay) است (که بازیکنان در آن نقش شخصیت‌های مختلف را ایفا کرده و یک زندگی مجازی واقعی را شبیه‌سازی می‌کنند)، FiveM تنها به آن محدود نمی‌شود. شما می‌توانید سرورهای مسابقه (Racing)، دثمچ (Deathmatch)، فری‌روم (Freeroam) و یا هر ایده خلاقانه دیگری را پیاده‌سازی کنید.
• 🌐 جامعه کاربری و توسعه‌دهندگان فعال: FiveM از یک کامیونیتی بسیار بزرگ و فعال در سراسر جهان بهره‌مند است. این بدان معناست که منابع فراوانی (شامل اسکریپت‌های رایگان و پولی، نقشه‌ها، مدل‌های سه‌بعدی) برای دانلود و استفاده وجود دارد. همچنین، در صورت بروز مشکل یا نیاز به راهنمایی، می‌توانید از دانش و پشتیبانی این جامعه بزرگ بهره‌مند شوید.
• 🛠️ پنل مدیریتی پیشرفته (txAdmin): این پنل تحت وب، مدیریت سرور را حتی برای افراد تازه‌کار نیز بسیار آسان و بصری می‌کند. از مانیتورینگ عملکرد سرور و مدیریت بازیکنان گرفته تا نصب، به‌روزرسانی و تنظیم پلاگین‌ها، تمامی ابزارهای لازم در دسترس شماست.
• 🔒 کنترل کامل: برخلاف سرورهای رسمی بازی، شما کنترل کاملی بر قوانین سرور، اعضای کامیونیتی، و حتی محتوایی که در سرور شما اجرا می‌شود، دارید. این آزادی به شما امکان می‌دهد تا فضایی امن، عادلانه و مطابق با سلیقه و قوانین خاص خود ایجاد کنید.

ما در این آموزش قصد داریم نحوه راه‌اندازی یک سرور رول‌پلی FiveM را به صورت جامع و دقیق به شما توضیح دهیم، از فراهم کردن پیش‌نیازها گرفته تا مراحل نصب، پیکربندی، مدیریت پیشرفته و نکات عیب‌یابی.

پیش‌نیازهای ضروری برای ساخت یک سرور پایدار FiveM

قبل از شروع مراحل فنی، اطمینان از فراهم بودن پیش‌نیازها برای پایداری، عملکرد بهینه، و تجربه کاربری روان در سرور شما حیاتی است. عدم توجه به این موارد می‌تواند منجر به لگ، کرش سرور، و نارضایتی بازیکنان شود.

۱. سرور مجازی (VPS) با کیفیت و قدرتمند:

سرور مجازی (Virtual Private Server) در واقع یک کامپیوتر اختصاصی است که 24/7 روشن بوده و اتصال اینترنتی پایدار و پرسرعت دارد. این سرور، قلب تپنده سرور FiveM شماست و قدرت آن مستقیماً بر تعداد بازیکنانی که سرور می‌تواند پشتیبانی کند، میزان لگ در بازی، و سرعت بارگذاری منابع تأثیر می‌گذارد.

• سیستم عامل توصیه شده: ویندوز سرور (ترجیحاً Windows Server 2016 یا بالاتر) به دلیل سازگاری بهتر با ابزارهای FiveM (که غالباً بر پایه ویندوز توسعه یافته‌اند) و سهولت مدیریت از طریق ریموت دسکتاپ. اگر با لینوکس آشنایی کامل دارید، می‌توانید از توزیع‌های خاص لینوکس نیز استفاده کنید، اما پیچیدگی بیشتری دارد.
• حداقل منابع پیشنهادی (برای شروع و تعداد بازیکنان کم – 5 تا 15 نفر):
  • پردازنده (CPU): حداقل 4 هسته (Core) با فرکانس بالا (ترجیحاً 3.0 GHz به بالا). کیفیت هسته‌ها (فیزیکی یا مجازی) نیز مهم است. هسته‌های اختصاصی (Dedicated Cores) عملکرد بهتری ارائه می‌دهند.
  • رم (RAM): حداقل 8 گیگابایت (GB) رم DDR4. برای سرورهای رول‌پلی با پلاگین‌های زیاد و تعداد بازیکنان بیشتر (20+ نفر)، 16 گیگابایت رم یا بیشتر به شدت توصیه می‌شود. رم کافی از کرش شدن سرور به دلیل کمبود حافظه جلوگیری می‌کند.
  • فضای ذخیره‌سازی (SSD): حداقل 80 گیگابایت (GB) فضای ذخیره‌سازی از نوع SSD (Solid State Drive). استفاده از SSD برای سرعت بالا در بارگذاری فایل‌های سرور، اسکریپت‌ها، و دیتابیس (که بر سرعت ورود بازیکنان و پاسخگویی سرور تأثیر مستقیم دارد) حیاتی است. از HDD (هارد دیسک معمولی) خودداری کنید.
  • پهنای باند شبکه (Network Bandwidth): حداقل 100 Mbps (مگابیت بر ثانیه) پورت شبکه، اما ترجیحاً 1 Gbps (گیگابیت بر ثانیه) برای سرورهای شلوغ. پایداری و سرعت آپلود/دانلود دیتاسنتر بسیار مهم است.
• نکته مهم برای کاربران ایرانی: به دلیل تحریم‌های شرکت راک‌استار علیه IPهای ایران، حتماً از فروشندگان سرور مجازی معتبر در ایران که راه‌حل‌های دور زدن این محدودیت‌ها را (مانند استفاده از IPهای بین‌المللی اختصاصی یا سرویس‌های پروکسی سرور-ساید) ارائه می‌دهند، سرور خود را تهیه کنید. پرس‌وجو از پشتیبانی فروشنده در این زمینه بسیار مهم است.

۲. آخرین نسخه FXServer (بیلد FiveM):

• این فایل شامل هسته اصلی سرور FiveM است که مسئول اجرای تمام اسکریپت‌ها و ارتباط با کلاینت‌های FiveM است.
• توصیه: همیشه از آخرین ورژن منتشر شده (Recommended Build) استفاده کنید. این بیلدها معمولاً پایدارترین نسخه‌ها هستند و شامل جدیدترین قابلیت‌ها و رفع باگ‌ها می‌شوند. بیلدهای “Nightly” ممکن است ویژگی‌های جدیدی داشته باشند اما پایداری کمتری دارند و برای محیط‌های تولیدی توصیه نمی‌شوند.
• می‌توانید FXServer را از وب‌سایت رسمی FiveM یا لینک‌های مورد تأیید کامیونیتی دانلود کنید.

۳. XAMPP (یا WampServer / MySQL Server):

• XAMPP یک بسته نرم‌افزاری رایگان و متن‌باز است که شامل Apache (وب سرور)، MySQL (سیستم مدیریت پایگاه داده), PHP و Perl می‌شود.
• کاربرد: از XAMPP (و به طور خاص MySQL) برای ساخت و مدیریت دیتابیس سرور FiveM استفاده می‌کنیم. فریم‌ورک‌های رول‌پلی مانند ESX Legacy و QBCore به یک پایگاه داده برای ذخیره اطلاعات بازیکنان (مانند موجودی حساب، آیتم‌ها، شغل‌ها، خانه‌ها، وسایل نقلیه و …) نیاز دارند.
• نصب و راه‌اندازی: پس از نصب XAMPP، کنترل پنل آن را اجرا کرده و مطمئن شوید که گزینه‌های Apache (برای txAdmin) و MySQL (برای دیتابیس سرور شما) را روشن (Start) کرده‌اید.
• نکات عیب‌یابی XAMPP: در صورت بروز مشکل در روشن شدن Apache یا MySQL، ممکن است پورت‌های پیش‌فرض آن‌ها (مانند پورت 80 برای Apache یا 3306 برای MySQL) توسط نرم‌افزارهای دیگری اشغال شده باشند. می‌توانید پورت‌ها را در تنظیمات XAMPP تغییر دهید یا برنامه‌های تداخل‌کننده را موقتاً غیرفعال کنید.

مراحل گام به گام ساخت و پیکربندی سرور FiveM

۱. آماده‌سازی ساختار فایل سرور:

• ایجاد مسیر اصلی برای فایل‌های سرور: یک مسیر مشخص و منظم برای نگهداری تمام فایل‌های سرور FiveM خود ایجاد کنید. پیشنهاد می‌شود مسیری مانند `C:\FXServer` را در درایو C (یا هر درایو دیگر با فضای کافی) ایجاد کنید.
• ایجاد فولدر `server`: داخل فولدر `FXServer` یک فولدر جدید به نام `server` (یا هر نام دلخواه دیگر مانند `myrp_server`) بسازید. این فولدر محل قرارگیری هسته اصلی سرور شما خواهد بود: `C:\FXServer\server`.

۲. استخراج و راه‌اندازی اولیه FXServer:

• استخراج بیلد FiveM: فایل FXServer بیلدی که دانلود کرده‌اید (معمولاً به صورت یک فایل `zip` یا `7z` است) را با استفاده از نرم‌افزارهایی مانند WinRAR یا 7-Zip اکسترکت (Extract) کنید.
• انتقال فایل‌ها: محتویات استخراج شده را (که شامل فایل `FXServer.exe` و پوشه‌هایی مانند `cfx-server-data`) است، درون فولدر `server` که در مرحله قبل ساختید، قرار دهید. مطمئن شوید که `FXServer.exe` مستقیماً داخل فولدر `server` باشد.
• اولین اجرای FXServer: وارد فولدر `server` شوید و بر روی فایل اجرایی `FXServer.exe` دابل کلیک کنید.
  • یک پنجره Command Prompt (CMD) باز خواهد شد. صبر کنید تا این پنجره فرآیندهای اولیه راه‌اندازی را انجام دهد. این فرآیند شامل دانلود و نصب اجزای اولیه txAdmin و آماده‌سازی محیط است.
  • پس از تکمیل مراحل، به صورت خودکار صفحه txAdmin در مرورگر پیش‌فرض شما باز می‌شود. اگر صفحه به صورت خودکار باز نشد، می‌توانید از آدرسی که در خط اول پنجره CMD نمایش داده می‌شود (معمولاً `http://localhost:40120` یا آدرس IP سرور شما با پورت 40120) استفاده کنید.

۳. پیکربندی اولیه txAdmin و سرور:

• ورود به txAdmin:
  • در صفحه اول txAdmin، کدی که در پنجره CMD به شما نمایش داده شده است را (معمولاً یک کد چند رقمی) در فیلد مربوطه وارد کرده و سپس بر روی Link Account کلیک کنید. این کار به txAdmin اجازه دسترسی به فایل‌های سرور شما را می‌دهد.

• • در مرحله بعد، یک رمز عبور قوی و دلخواه برای پنل txAdmin خود وارد کنید. قوانین و شرایط استفاده را مطالعه کرده و قبول کنید، سپس بر روی Create Master Account کلیک کنید. این رمز عبور برای ورودهای بعدی به پنل txAdmin شما استفاده خواهد شد، پس آن را به خاطر بسپارید یا در جایی امن ذخیره کنید.

• پیکربندی گام به گام سرور در txAdmin:

• • Welcome (خوش آمدگویی): این مرحله صرفاً برای خوش‌آمدگویی است. بر روی Next کلیک کنید تا وارد مرحله بعدی شوید.

• • Server Name (نام سرور): یک نام دلخواه و جذاب برای سرور FiveM خود وارد کنید. این نام در لیست سرورها (server list) به بازیکنان نمایش داده می‌شود. پس از وارد کردن نام، بر روی Next کلیک کنید.

• • Deployment Type (نوع استقرار): در این مرحله، بر روی گزینه اول (معمولاً “Use a remote repository” یا “Popular Recipes”) کلیک کنید و Next را بزنید. این گزینه به txAdmin اجازه می‌دهد تا از الگوهای آماده برای راه‌اندازی سرور استفاده کند.

• • Choose Template (انتخاب الگو): این یکی از مهم‌ترین مراحل است. الگوها، فریم‌ورک‌های از پیش‌ساخته شده‌ای هستند که پایه و اساس سرور رول‌پلی شما را تشکیل می‌دهند:

• CFX Default Fivem: این گزینه فقط پایه‌های اصلی یک سرور FiveM خام را اجرا می‌کند و امکانات خاصی (مانند سیستم اقتصادی، شغل و …) ندارد. برای شروع یا سرورهای بسیار خاص ممکن است استفاده شود.
• ESX Legacy: محبوب‌ترین و پراستفاده‌ترین گزینه برای سرورهای رول‌پلی. این فریم‌ورک شامل سیستم‌های پایه مشاغل، مسکن، وسایل نقلیه، موجودی کالا (Inventory) و بسیاری امکانات دیگر است. برای اکثر سرورهای رول‌پلی، ESX Legacy نقطه شروع خوبی است.
• QBCore Framework: یک گزینه پیشرفته‌تر و مدرن‌تر برای سرورهای رول‌پلی که به دلیل ساختار منظم‌تر و عملکرد بهتر، در حال حاضر محبوبیت زیادی پیدا کرده است. این فریم‌ورک نیز شامل مشاغل، مسکن، سیستم گنگ‌ها (Gangs) و… می‌شود. انتخاب بین ESX و QBCore به سلیقه و نیازهای دقیق شما بستگی دارد؛ هر دو جامعه توسعه‌دهنده بزرگی دارند.
• CFX Default RedM: این گزینه فقط پایه‌های اصلی یک سرور RedM (نسخه FiveM برای Red Dead Redemption 2) را اجرا می‌کند و امکانات خاصی ندارد.
• VORP Core: این گزینه چارچوب رول‌پلی برای RedM است که شامل مشاغل مختلف، اصطبل، مسکن و… می‌باشد.

برای این آموزش ساخت سرور رول‌پلی FiveM، بر روی گزینه ESX Legacy کلیک کنید و سپس گزینه Next را بزنید.

• • Path (مسیر ذخیره‌سازی): در این قسمت، txAdmin مسیر ذخیره‌سازی فایل‌های سرور شما را نمایش می‌دهد. معمولاً نیازی به تغییر این مسیر نیست (به عنوان مثال: `C:\FXServer\txData\ESXLegacy_XXXXX.base`). فقط بر روی Save کلیک کنید.

• • Go To Recipe Deployer (رفتن به استقرار الگو): در این مرحله، بر روی این گزینه کلیک کنید تا وارد صفحه بعدی شوید.

۴. دریافت و وارد کردن لایسنس کد FiveM (Keymaster):

لایسنس کد یک کلید منحصر به فرد است که سرور شما را در شبکه FiveM شناسایی می‌کند و برای عملکرد صحیح سرور ضروری است.

• مرحله اول: در صفحه جدید txAdmin، بر روی Next کلیک کنید.
• ایجاد لایسنس کد: برای ساخت لایسنس کد، مرورگر خود را باز کرده و به وب‌سایت FiveM Network (Keymaster) مراجعه کنید و در آن ثبت نام کنید (اگر قبلاً حساب کاربری ندارید).
• افزودن سرور جدید: پس از ورود به حساب کاربری خود، بر روی دکمه New Server کلیک کنید.
  • در کادر اول (Label/Name)، یک نام دلخواه برای لایسنس خود انتخاب کنید (مثلاً “MyFirstFiveMServerKey”).
  • در کادر بعدی (IP Address)، IP سرور مجازی خود را بدون پورت وارد کنید. این قسمت بسیار مهم است؛ IP باید دقیقاً IP عمومی سرور مجازی شما باشد.
  • Server Type (نوع سرور): را بر روی VPS (برای سرورهای مجازی) قرار دهید.
  • در کادر آخر (Server Hostname/Tag)، یک کلمه دلخواه (Tag) وارد کنید (مثلاً “Gaming” یا “Roleplay”).
  • در نهایت، بر روی گزینه Generate کلیک کنید.
  • کد لایسنس تولید شده (که یک رشته طولانی از حروف و اعداد است) را کپی کنید.
• وارد کردن لایسنس کد در txAdmin: کد کپی شده را در قسمت مربوطه در txAdmin وارد کرده و سپس بر روی Run Recipe کلیک کنید.
• دانلود و نصب فایل‌های مورد نیاز: txAdmin شروع به دانلود و نصب تمام فایل‌ها و اسکریپت‌های مورد نیاز برای فریم‌ورک ESX Legacy خواهد کرد. این فرآیند بسته به سرعت اینترنت سرور شما و حجم فایل‌ها، ممکن است چند دقیقه طول بکشد. صبور باشید.
• تکمیل نصب: پس از اتمام دانلود و نصب فایل‌های مورد نیاز، بر روی Next کلیک کنید تا وارد مرحله آخر شوید.

۵. تنظیمات نهایی و اجرای سرور:

• ویرایش `server.cfg` (پیکربندی اصلی سرور):

• • در مرحله آخر، شما می‌توانید فایل `server.cfg` را مستقیماً از طریق ویرایشگر داخلی txAdmin ویرایش کنید. این فایل شامل تمام تنظیمات اصلی سرور شماست.
  • نکته حیاتی برای کاربران ایرانی: به دلیل محدودیت‌های IP شرکت راک‌استار (FiveM) علیه IPهای ایران، حتماً بعد از خط 18 (یا هر جایی که `endpoint_add_tcp` و `endpoint_add_udp` قرار دارند)، کد زیر را اضافه کنید:

    sv_listingIPOverride "YOUR_SERVER_IP"

    به جای `YOUR_SERVER_IP`، IP سرور مجازی عمومی خودتان را وارد کنید. این IP باید همان IP باشد که در Keymaster وارد کرده‌اید. این خط کد به FiveM کمک می‌کند تا سرور شما را با IP صحیح در لیست سرورها نمایش دهد و مشکلات اتصال بازیکنان را کاهش دهد.

    endpoint_add_tcp "0.0.0.0:30120"
    endpoint_add_udp "0.0.0.0:30120"
    sv_listingIPOverride "5.42.223.1"  // مثال: IP واقعی سرور شما

  • می‌توانید تنظیمات دیگری مانند `sv_maxClients` (حداکثر تعداد بازیکنان)، `sv_hostname` (نام سرور)، و `sets tags` (تگ‌های سرور برای فیلتر در لیست سرورها) را نیز در این فایل تغییر دهید.
• ذخیره و اجرای سرور: پس از اعمال تغییرات (به خصوص افزودن `sv_listingIPOverride`)، بر روی گزینه Save & Run Server کلیک کنید.

🚀 معرفی کامل پنل txAdmin: ابزاری قدرتمند برای مدیریت سرور 🚀

پنل txAdmin یک رابط کاربری تحت وب است که مدیریت سرور FiveM شما را بسیار ساده و کارآمد می‌کند. پس از نصب کامل سرور رول‌پلی FiveM، شما به این پنل قدرتمند دسترسی خواهید داشت. در ادامه، بخش‌های مختلف txAdmin و کاربردهای آن‌ها را به تفصیل توضیح خواهیم داد:

• 📊 Dashboard (داشبورد):

  یک نمای کلی و جامع از وضعیت فعلی سرور شما را ارائه می‌دهد. این بخش شامل اطلاعاتی نظیر تعداد بازیکنان آنلاین، مصرف منابع سرور (CPU و RAM)، وضعیت کلی سرویس‌ها (آیا سرور در حال اجراست؟)، و حتی نمودارهای عملکرد در طول زمان است. این بخش برای مانیتورینگ سریع و تشخیص مشکلات اولیه بسیار مفید است.

• 👥 Players (بازیکنان):

  این قسمت برای مدیریت دقیق بازیکنان متصل به سرور شماست. می‌توانید به بازیکنان آنلاین رنک (نقش) خاصی بدهید (مثلاً ادمین، مد، پلیر عادی)، آن‌ها را از سرور اخراج (Kick) کنید، به صورت موقت یا دائم بن (Ban) کنید، یا به آن‌ها هشدار (Warn) بدهید. همچنین می‌توانید اطلاعات بازیکنان بن شده را مشاهده و مدیریت کنید.

• 📜 History (تاریخچه):

  در این بخش می‌توانید تمام اکشن‌ها و رویدادهای مدیریتی که توسط ادمین‌ها انجام شده است را مشاهده کنید. این شامل لیست بازیکنان بن شده، اخراج شده، یا کسانی که هشدار دریافت کرده‌اند، به همراه جزئیات زمان و ادمین انجام‌دهنده است. این قابلیت برای پیگیری فعالیت‌های مدیریتی و حفظ شفافیت مفید است.

• ✅ Whitelist (لیست سفید):

  با فعال کردن این قابلیت، می‌توانید تعیین کنید که فقط افراد خاصی که شما در این لیست اضافه می‌کنید، قادر به ورود به سرور FiveM شما باشند. این ویژگی برای سرورهای خصوصی، سرورهای رول‌پلی با کامیونیتی بسته، یا سرورهای تست بسیار کاربردی است و امنیت سرور را افزایش می‌دهد.

• 💻 Live Console (کنسول زنده):

  یکی از مهم‌ترین و پرکاربردترین بخش‌های پنل txAdmin. در این قسمت می‌توانید لاگ‌های سرور، خطاهای پیش‌آمده در زمان واقعی، و پیام‌های سیستم را به صورت زنده مشاهده کنید. همچنین، می‌توانید دستورات مختلفی را مستقیماً در کنسول وارد کنید (مانند `restart [resource_name]`, `stop [resource_name]`, `say [message]`) تا در سرور FiveM اعمال شوند. این بخش برای عیب‌یابی سریع و مدیریت مستقیم سرور ضروری است.

• 📦 Resources (منابع/پلاگین‌ها):

  تمام پلاگین‌ها و اسکریپت‌های نصب شده بر روی سرور شما (که در FiveM به آن‌ها Resource گفته می‌شود) در این قسمت قابل مشاهده و مدیریت هستند. می‌توانید وضعیت آن‌ها (در حال اجرا، متوقف شده) را ببینید، آن‌ها را فعال (Start)، غیرفعال (Stop) یا مجدداً راه‌اندازی (Restart) کنید. این بخش برای مدیریت آسان اسکریپت‌ها بدون نیاز به ویرایش دستی فایل `server.cfg` است.

• 📝 Server Log (لاگ سرور):

  شما در این بخش می‌توانید تمام لاگ‌های سرور FiveM خود را که در فایل متنی ذخیره شده‌اند، مشاهده کنید. این لاگ‌ها شامل چت بازیکنان، ورود و خروج بازیکنان، خطاهای کلی سرور، و پیام‌های اسکریپت‌ها می‌شوند. این بخش برای بررسی دقیق‌تر رویدادها و عیب‌یابی مشکلات گذشته مفید است.

• ⚙️ CFG Editor (ویرایشگر `server.cfg`):

  از طریق این بخش می‌توانید فایل حیاتی `server.cfg` سرور FiveM خود را به صورت گرافیکی ویرایش کنید. شما می‌توانید کی لایسنس سرور، نام سرور، حداکثر تعداد بازیکنان (`sv_maxClients`)، تگ‌های سرور، و تنظیمات دیگر را تغییر دهید. همچنین می‌توانید مشخص کنید که کدام دسته از پلاگین‌ها (مثلاً `ensure [es_extended]`) اجرا شوند و یا آن‌ها را اولویت‌بندی کنید. این ویرایشگر کار را بسیار ساده‌تر از ویرایش دستی فایل می‌کند.

• 🔎 Diagnostics (عیب‌یابی/تشخیص):

  این قسمت تمام اطلاعات فنی و عملکردی سرور شما را نمایش می‌دهد. این شامل وضعیت پورت‌ها، سلامت دیتابیس، و خطاهای سیستمی است که برای عیب‌یابی مشکلات عمیق‌تر سرور بسیار مفید و ضروری است.

• 👑 Admin Manager (مدیریت ادمین):

  از طریق این بخش می‌توانید برای سرور FiveM خود ادمین‌های جدید اضافه کنید. می‌توانید برای هر ادمین سطح دسترسی مشخصی (مثلاً دسترسی کامل، دسترسی فقط به مدیریت بازیکنان) تعریف کنید و نام کاربری و رمز عبور آن‌ها را مدیریت کنید.

• 🔧 Settings (تنظیمات):

  در این بخش می‌توانید تنظیمات عمومی پنل txAdmin و سرور FiveM خود را تغییر دهید. این شامل تغییر نام و زبان پنل txAdmin، فعال/غیرفعال کردن لیست سفید، و تنظیم زمان‌بندی برای ریستارت خودکار سرور در ساعات مشخص (که برای تازه‌سازی سرور و جلوگیری از لگ ضروری است) می‌شود.

  • FXServer: تنظیم مسیر دیتای سرور و فایل CFG.
  • Restarter: تنظیم زمان اجرای پلاگین‌ها بعد از راه‌اندازی سرور FiveM و تنظیم زمان‌بندی خودکار برای ریستارت / راه‌اندازی مجدد سرور. این قابلیت به حفظ سلامت و کارایی سرور در طولانی مدت کمک می‌کند.
  • Player Manager: تنظیم گروه‌های لیست سفید و سفارشی‌سازی آن.
  • Discord: تنظیم بات دیسکورد برای سرور فایوام. این امکان به شما اجازه می‌دهد تا لاگ‌های مهم، رویدادهای سرور، و پیام‌ها را مستقیماً به یک کانال دیسکورد ارسال کنید.
  • Game: تنظیمات مربوط به پنل ادمین در داخل بازی.
• 💾 Master Action (عملیات اصلی):

  شما در این بخش می‌توانید عملیات‌های مهمی مانند فرمت کردن کامل سرور FiveM (بازگشت به حالت کارخانه) یا تهیه بک‌آپ (پشتیبان‌گیری) از دیتابیس و فایل‌های سرور را انجام دهید. تهیه بک‌آپ منظم برای جلوگیری از از دست رفتن اطلاعات بازیکنان در صورت بروز مشکل حیاتی است.

⚙️ آموزش جامع نصب و مدیریت پلاگین‌ها (Resources) برای سرور FiveM ⚙️

برای اینکه شما بتوانید یک سرور رول‌پلی کامل، پویا و استاندارد داشته باشید، باید پلاگین‌ها (که در اصطلاح FiveM به آن‌ها Resources گفته می‌شود) و اسکریپت‌های اضافی را بر اساس نیاز و سلیقه خود نصب و پیکربندی کنید. تعداد این پلاگین‌ها بسیار زیاد است و هر کدام عملکردهای خاصی (مانند سیستم پلیس، اورژانس، خانه‌ها، مغازه‌ها، سیستم گاراژ، و …) را به سرور شما اضافه می‌کنند. این پلاگین‌ها معمولاً به دسته‌بندی‌های مختلفی تقسیم می‌شوند.

۱. ساختار دایرکتوری Resources:

تمام پلاگین‌های شما باید در فولدر `resources` سرور FiveM قرار بگیرند. مسیر دقیق این فولدر به این شکل است:

C:\FXServer\txData\ESXLegacy_XXXXX.base\resources

(توجه: عدد `XXXXX` ممکن است در سرور شما متفاوت باشد و بر اساس شناسه منحصر به فرد سرور شما تغییر می‌کند).
در داخل فولدر `resources`، ممکن است چندین فولدر دسته‌بندی شده دیگر (مانند `[core]`, `[esx_addons]`, `[qbcore]`, `[gameplay]`, `[vehicles]`, `[maps]`) مشاهده کنید. این دسته‌بندی‌ها به منظم کردن پلاگین‌ها کمک می‌کنند.

۲. مراحل نصب پلاگین:

• انتخاب و دانلود پلاگین: ابتدا پلاگین مورد نظر خود را از منابع معتبر (مانند فروم‌های رسمی FiveM، وب‌سایت‌های مخصوص مودها، یا گیت‌هاب) دانلود کنید. مطمئن شوید که پلاگین با فریم‌ورک سرور شما (ESX Legacy، QBCore و…) سازگار است.
• استخراج فایل‌ها: فایل پلاگین دانلود شده (که معمولاً به صورت یک فایل `zip` یا `rar` است) را با استفاده از نرم‌افزارهای فشرده‌سازی اکسترکت (Extract) کنید.
• انتقال به فولدر `resources`:
  • فولدر اصلی پلاگین استخراج شده (که معمولاً شامل فایل‌های `fxmanifest.lua` یا `__resource.lua` است) را در مسیر `C:\FXServer\txData\ESXLegacy_XXXXX.base\resources` قرار دهید.
  • توصیه می‌شود که فولدر پلاگین را در دسته‌بندی مناسب خودش (مثلاً پلاگین‌های ESX در `[esx_addons]`) قرار دهید تا ساختار منظم بماند.
• فعال‌سازی در `server.cfg` (یا txAdmin):
  • پس از انتقال پلاگین، باید آن را در فایل `server.cfg` سرور خود (یا از طریق CFG Editor در txAdmin) “فعال” کنید. برای این کار، خط زیر را به `server.cfg` اضافه کنید:

    ensure [اسم_فولدر_پلاگین]

    مثلاً اگر نام فولدر پلاگین شما `esx_jobcenter` باشد، اضافه می‌کنید: `ensure esx_jobcenter`.

  • نکته مهم در مورد ترتیب اجرا: برخی پلاگین‌ها به پلاگین‌های دیگر وابسته هستند (Dependency). به عنوان مثال، اکثر پلاگین‌های ESX به `es_extended` وابسته هستند. همیشه مطمئن شوید که پلاگین‌های اصلی و مورد نیاز (مانند `es_extended`) قبل از پلاگین‌هایی که به آن‌ها وابسته هستند، در `server.cfg` با دستور `ensure` فراخوانی شده باشند. ترتیب نوشتن `ensure`ها در فایل `server.cfg` بسیار مهم است.
• تنظیمات دیتابیس (اگر پلاگین نیاز دارد): برخی پلاگین‌ها نیاز به جداول یا داده‌های خاص در دیتابیس MySQL دارند. معمولاً یک فایل `.sql` همراه پلاگین ارائه می‌شود. باید این فایل را با استفاده از phpMyAdmin (که از طریق XAMPP در دسترس است) در دیتابیس سرور خود Import (وارد) کنید.

۳. نکات تکمیلی و عیب‌یابی پلاگین‌ها:

• ریستارت سرور: بعد از دانلود، نصب و فعال‌سازی هر پلاگین جدید یا اعمال هرگونه تغییر در `server.cfg`، حتماً سرور خود را از طریق پنل txAdmin (با دکمه Restart) یا با اجرای مجدد `FXServer.exe`، ریستارت کامل کنید تا تغییرات اعمال شوند.
• بررسی Live Console: بلافاصله پس از ریستارت سرور، وارد بخش Live Console در پنل txAdmin شوید و با دقت لاگ‌ها را بررسی کنید. به دنبال پیام‌های خطای قرمز رنگ یا اخطارهای زرد رنگ (Warnings) باشید. وجود خطا می‌تواند نشان‌دهنده نصب نادرست، ناسازگاری پلاگین، یا وابستگی‌های از دست رفته باشد. معمولاً پیام خطا نشان می‌دهد مشکل از کدام پلاگین است.
• رفع مشکلات دیتابیس: اگر پلاگین خطای دیتابیس می‌دهد، مطمئن شوید که فایل `.sql` آن را به درستی Import کرده‌اید و اطلاعات اتصال دیتابیس (نام دیتابیس، نام کاربری، رمز عبور) در فایل کانفیگ پلاگین صحیح است.
• بررسی وابستگی‌ها: بسیاری از پلاگین‌ها به اسکریپت‌های دیگر (مانند `ESX`, `NativeUI`, `MySQL-async`) نیاز دارند. مطمئن شوید که تمام وابستگی‌های ذکر شده توسط توسعه‌دهنده پلاگین، نصب و به درستی فعال شده‌اند.

🛠️ نکات پیشرفته مدیریت و عیب‌یابی سرور FiveM 🛠️

۱. راه‌اندازی سرور پس از خاموش شدن:

برای اجرای مجدد سرور FiveM پس از خاموش شدن (به هر دلیلی، مثلاً ریستارت سرور مجازی یا خاموش کردن دستی):

• وارد مسیر اصلی نصب سرور خود شوید: `C:\FXServer`
• بر روی فایل `FXServer.exe` دابل کلیک کنید. این کار سرور FiveM و پنل txAdmin را راه‌اندازی می‌کند.
• بعد از آن، می‌توانید از طریق لینکی که در پنجره CMD نمایان می‌شود (معمولاً `http://localhost:40120` از داخل سرور مجازی) وارد پنل TxAdmin بشوید و سرور را به طور کامل مدیریت کنید.

۲. بهینه‌سازی عملکرد سرور:

• کاهش مصرف منابع: پلاگین‌های غیرضروری را غیرفعال کنید. از پلاگین‌های بهینه و سبک استفاده کنید.
• بهینه‌سازی نقشه‌ها و مدل‌ها: نقشه‌ها و مدل‌های سه بعدی سنگین می‌توانند باعث افت فریم بازیکنان شوند. از مدل‌های بهینه‌سازی شده استفاده کنید.
• Render Distance: تنظیمات `render distance` در فایل‌های `fxmanifest.lua` پلاگین‌های مپ (نقشه) را چک کنید. مقادیر بالا می‌تواند باعث لگ شود.
• SQL Query Optimization: برای سرورهای شلوغ، بهینه‌سازی کوئری‌های دیتابیس (SQL queries) برای دسترسی سریع‌تر به داده‌ها بسیار مهم است.

۳. امنیت سرور:

• رمز عبور قوی: همیشه از رمزهای عبور قوی و منحصربه‌فرد برای پنل txAdmin و ورود به سرور مجازی خود استفاده کنید.
• پورت‌ها و فایروال:
  • پورت اصلی FiveM که باید در فایروال سرور مجازی و روتر شما باز باشد، پورت `30120` (TCP و UDP) است.
  • پورت پنل txAdmin معمولاً `40120` است. برای امنیت بیشتر، دسترسی به این پورت را فقط به IPهای مشخص (IP منزل یا سیستم خود) محدود کنید.
  • فایروال ویندوز سرور را به درستی پیکربندی کنید تا فقط پورت‌های مورد نیاز باز باشند و از دسترسی‌های غیرمجاز جلوگیری شود.
• حفاظت در برابر DDoS: برای سرورهای عمومی، استفاده از سرویس‌های محافظت در برابر حملات DDoS (مانند Cloudflare Spectrum یا سرویس‌های ارائه شده توسط دیتاسنتر) به شدت توصیه می‌شود.
• بروزرسانی مداوم: همیشه FXServer و txAdmin را به آخرین نسخه‌ها به‌روز نگه دارید تا از جدیدترین ویژگی‌ها، رفع باگ‌ها و پچ‌های امنیتی بهره‌مند شوید.

۴. مدیریت دیتابیس (MySQL):

• phpMyAdmin: XAMPP یک رابط کاربری تحت وب به نام phpMyAdmin را برای مدیریت آسان دیتابیس MySQL فراهم می‌کند. می‌توانید از طریق مرورگر سرور مجازی خود به آن دسترسی پیدا کنید (معمولاً با تایپ `http://localhost/phpmyadmin` در آدرس‌بار).
• پشتیبان‌گیری (Backup): به صورت منظم از دیتابیس و فایل‌های سرور خود بک‌آپ تهیه کنید. پنل txAdmin دارای قابلیت پشتیبان‌گیری از دیتابیس است. این کار برای جلوگیری از از دست رفتن اطلاعات بازیکنان و پیشرفت آن‌ها در صورت بروز مشکل (مانند کرش سرور یا حمله) حیاتی است. بک‌آپ‌ها را در محلی امن و خارج از سرور مجازی (مثلاً فضای ابری یا یک درایو جداگانه) ذخیره کنید.
• بهینه‌سازی دیتابیس: برای سرورهای شلوغ، بهینه‌سازی دوره‌ای جداول دیتابیس می‌تواند به بهبود عملکرد کمک کند.

۵. عیب‌یابی مشکلات رایج:

• سرور شروع نمی‌شود:
  • مطمئن شوید XAMPP (Apache و MySQL) در حال اجراست.
  • لایسنس کد در `server.cfg` صحیح است.
  • پورت‌ها در فایروال باز هستند.
  • لاگ‌های Live Console را برای خطاهای اولیه بررسی کنید.
• بازیکنان نمی‌توانند وصل شوند:
  • IP Override در `server.cfg` صحیح است.
  • پورت 30120 (TCP/UDP) در فایروال سرور مجازی و روتر شما باز است.
  • بازیکنان IP و پورت صحیح را وارد می‌کنند.
  • ممکن است کلاینت بازیکنان نیاز به VPN یا پروکسی داشته باشند (به دلیل تحریم).
• پلاگین‌ها کار نمی‌کنند یا خطا می‌دهند:
  • `ensure` کردن پلاگین در `server.cfg` صحیح است.
  • ترتیب `ensure`ها رعایت شده (وابستگی‌ها).
  • فایل `.sql` پلاگین در دیتابیس Import شده است.
  • لاگ‌های Live Console را برای خطاهای مربوط به پلاگین خاص بررسی کنید.