این راهنما نحوه نصب ریسورسها (اسکریپتها) روی سرور FiveM، راهاندازی دیتابیس MySQL برای فریمورکهایی مانند ESX یا QBCore و درک ترتیب بارگذاری ریسورسها را پوشش میدهد. اگر هنوز راهاندازی اولیه سرور را انجام ندادهاید، ابتدا راهنمای راهاندازی سرور FiveM را مطالعه کنید.
server.cfg فعال داشته باشید. برای مراحل راهاندازی اولیه، راهنمای راهاندازی سرور FiveM را ببینید.
نصب ریسورسها و اسکریپتها
سرورهای FiveM با ریسورسها (که اسکریپت نیز نامیده میشوند) گسترش مییابند. ریسورسها قابلیتهایی مانند نمایندگی خودرو، مشاغل، عناصر HUD، فریمورکها و موارد دیگر اضافه میکنند.
نحوه نصب یک ریسورس
- ریسورس را از منبع آن (GitHub، انجمنهای Cfx.re، Tebex و غیره) دانلود کنید.
- در صورت نیاز، پوشه ریسورس را از فایل ZIP/آرشیو استخراج کنید.
- پوشه ریسورس را به پوشه
resources/سرور خود با استفاده از تب Files در GPanel یا از طریق SFTP آپلود کنید. - فایل
server.cfgرا باز کنید و یک خطensureبرای ریسورس اضافه کنید:
# Add your custom resources
ensure my-new-resource- سرور را از GPanel یا TXAdmin ریستارت کنید تا ریسورس بارگذاری شود.
ensure باید دقیقاً با نام پوشه ریسورس مطابقت داشته باشد (حساس به بزرگی و کوچکی حروف). اگر پوشه my-cars است، خط باید ensure my-cars باشد.
فایلهای مانیفست ریسورس
هر ریسورس معتبر باید حاوی یک فایل مانیفست باشد. ریسورسهای مدرن از fxmanifest.lua استفاده میکنند، در حالی که ریسورسهای قدیمیتر از __resource.lua استفاده میکنند. اگر پوشه ریسورس دانلود شده هیچکدام از این فایلها را نداشته باشد، ریسورس بارگذاری نخواهد شد. برخی دانلودها پوشه واقعی ریسورس را داخل یک پوشه بیرونی قرار میدهند — مطمئن شوید پوشهای که در resources/ قرار میدهید همان پوشهای است که مانیفست را در خود دارد.
ترتیب بارگذاری ریسورسها
ریسورسها به ترتیبی که در server.cfg ظاهر میشوند بارگذاری میشوند. اگر یک ریسورس به ریسورس دیگری وابسته است (مثلاً یک اسکریپت شغل که به فریمورکی مانند ESX یا QBCore وابسته است)، مطمئن شوید که وابستگی قبل از ریسورسی که به آن نیاز دارد ذکر شده باشد:
# Database resource first
ensure oxmysql
# Framework second
ensure es_extended
# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshopسازماندهی ریسورسها با پوشههای دستهبندی
میتوانید ریسورسها را در زیرپوشههایی داخل پوشه resources/ سازماندهی کنید. از نشانهگذاری براکت در server.cfg برای ensure کردن یک پوشه دستهبندی کامل استفاده کنید:
# Ensure all resources inside resources/[esx]/
ensure [esx]
# Ensure all resources inside resources/[standalone]/
ensure [standalone]این کار تمام ریسورسهای داخل زیرپوشه نامگذاری شده را بارگذاری میکند. این روش مناسبی برای گروهبندی اسکریپتهای مرتبط بدون نیاز به فهرست کردن هر یک به صورت جداگانه است.
بارگذاری آنی ریسورسها از طریق TXAdmin
برای بارگذاری یک ریسورس جدید همیشه نیازی به ریستارت کامل سرور نیست. TXAdmin میتواند ریسورسهای فردی را از صفحه Resources خود شروع، متوقف و ریستارت کند. پس از آپلود یک ریسورس جدید و اضافه کردن خط ensure آن، میتوانید دستور زیر را در کنسول زنده TXAdmin اجرا کنید:
refresh
ensure my-new-resourceدستور refresh به سرور میگوید که پوشه resources/ را برای ورودیهای جدید مجدداً اسکن کند.
راهاندازی دیتابیس (MySQL / MariaDB)
بسیاری از فریمورکها و ریسورسهای FiveM (مانند ESX، QBCore یا vRP) به یک دیتابیس MySQL یا MariaDB نیاز دارند. Legion Hosting اطلاعات دیتابیس را همراه با سرور شما ارائه میدهد.
یافتن اطلاعات دیتابیس
- در GPanel، به تب Databases بروید.
- اگر هنوز دیتابیسی وجود ندارد، روی New Database کلیک کنید تا یکی ایجاد شود.
- اطلاعات زیر را یادداشت کنید:
- آدرس دیتابیس (آدرس و پورت)
- نام دیتابیس
- نام کاربری
- رمز عبور (روی آیکون چشم کلیک کنید تا نمایش داده شود)
پیکربندی اتصال دیتابیس
جزئیات اتصال دیتابیس در server.cfg با استفاده از یک رشته اتصال تنظیم میشود. فرمت دقیق بستگی به ریسورس MySQL مورد استفاده شما دارد، اما رایجترین فرمت به این صورت است:
# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"جایگزینها را با اطلاعات واقعی خود از تب Databases جایگزین کنید. به عنوان مثال:
set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"localhost یا 127.0.0.1.
@، # یا % است، باید آنها را در رشته اتصال URL-encode کنید. به عنوان مثال، @ تبدیل به %40 و # تبدیل به %23 میشود.
انتخاب ریسورس MySQL
| ریسورس | وضعیت | توضیحات |
|---|---|---|
| oxmysql | پیشنهادی | مدرن، بهطور فعال نگهداری میشود، بهترین عملکرد. توسط اکثر فریمورکهای فعلی استفاده میشود. |
| mysql-async | قدیمی | قدیمیتر اما همچنان کار میکند. برخی اسکریپتهای قدیمی به طور خاص به آن وابسته هستند. |
| ghmattimysql | قدیمی | گزینه قدیمی دیگر. اگر فریمورک شما به این نیاز دارد، مستندات آن را بررسی کنید. |
هر ریسورس MySQL که استفاده میکنید، باید در server.cfg قبل از هر ریسورسی که به آن وابسته است ensure شود:
# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"
# MySQL resource — must load before framework
ensure oxmysql
# Framework
ensure es_extendedمبانی فریمورک
فریمورک سیستمهای اصلی گیمپلی را فراهم میکند که سایر ریسورسها بر اساس آن ساخته میشوند — مواردی مانند هویت بازیکن، پول، اینونتوری، مشاغل و وسایل نقلیه. دو فریمورک محبوب FiveM عبارتند از:
| فریمورک | نام ریسورس | توضیحات |
|---|---|---|
| ESX | es_extended |
پرکاربردترین فریمورک. اکوسیستم بزرگی از اسکریپتهای رایگان و پولی. مناسب برای سرورهای رولپلی. |
| QBCore | qb-core |
جایگزین مدرن ESX. کدبیس تمیزتر، توسعه فعال. اکوسیستم اسکریپت در حال رشد. |
اکثر فریمورکها از طریق سیستم recipe در TXAdmin در هنگام راهاندازی اولیه نصب میشوند. اگر در هنگام راهاندازی TXAdmin یک recipe مانند "QBCore" یا "ESX" انتخاب کردهاید، فریمورک و وابستگیهای اصلی آن از قبل نصب شدهاند. اگر نیاز به نصب دستی فریمورک دارید، مستندات رسمی آن را دنبال کنید:
دریافت کمک
اگر برای نصب ریسورس یا پیکربندی دیتابیس به کمک نیاز دارید:
- مستندات ریسورس یا صفحه GitHub آن را برای دستورالعملهای نصب و مشکلات شناخته شده بررسی کنید.
- کنسول GPanel یا لاگهای TXAdmin را برای پیامهای خطا بررسی کنید.
- یک تیکت پشتیبانی در https://legionhosting.net/submitticket.php با پیامهای خطا و نام ریسورسی که میخواهید نصب کنید ارسال نمایید.
