این راهنما راهاندازی ادمین، منابع سمت سرور، نقشههای سفارشی، مدیریت خودروها و عیبیابی سرور BeamMP شما در Legion Hosting را پوشش میدهد. برای راهاندازی اولیه سرور، کلیدهای احراز هویت و پیکربندی پایه، به راهنمای راهاندازی سرور BeamMP مراجعه کنید.
راهاندازی ادمین
BeamMP سیستم ورود یا رمز عبور ادمین سنتی ندارد. در عوض، دستورات ادمین از طریق کنسول سرور یا پلاگینهای Lua سمت سرور که شناسههای بازیکنان را بررسی میکنند، اجرا میشوند.
دستورات کنسول
کنسول سرور در GPanel دسترسی مستقیم به دستورات داخلی سرور را فراهم میکند. دستورات را مستقیماً در فیلد ورودی کنسول تایپ کنید:
| دستور | توضیحات |
|---|---|
kick <player_id> <reason> |
اخراج یک بازیکن از سرور با پیام دلیل اختیاری. |
ban <player_name> |
مسدود کردن یک بازیکن از سرور. بازیکنان مسدود شده نمیتوانند دوباره متصل شوند. |
unban <player_name> |
لغو مسدودیت یک بازیکن و اجازه اتصال مجدد. |
list |
نمایش لیست تمام بازیکنان متصل همراه با شناسههایشان. |
say <message> |
ارسال پیام چت سراسری از کنسول. |
status |
نمایش اطلاعات وضعیت سرور شامل تعداد بازیکنان و زمان آپتایم. |
help |
نمایش لیست تمام دستورات کنسول موجود. |
list برای مشاهده بازیکنان متصل و شناسههایشان استفاده کنید. این شناسهها برای دستوراتی مانند kick مورد نیاز هستند.
ساختار پوشه منابع
BeamMP از یک پوشه Resources برای سازماندهی محتوای سمت سرور استفاده میکند. این پوشه شامل دو زیرپوشه با اهداف متمایز است:
Resources/
Client/ <-- Client-side mods (maps, vehicles) synced to players
Server/ <-- Server-side Lua plugins (not sent to players)منابع کلاینت
فایلهایی که در Resources/Client/ قرار داده میشوند، به طور خودکار هنگام اتصال بازیکنان دانلود میشوند. این مورد برای موارد زیر استفاده میشود:
- نقشههای سفارشی — فایلهای .zip ماد نقشه که بازیکنان برای بارگذاری نقشه سرور به آن نیاز دارند.
- خودروهای سفارشی — فایلهای .zip ماد خودرو که ماشینهای جدید اضافه میکنند یا موارد موجود را تغییر میدهند.
- سایر مادهای کلاینت — هر ماد BeamNG.drive که باید در کلاینت موجود باشد.
Resources/Client/ توسط هر بازیکنی که متصل میشود دانلود میشود. فایلهای بزرگ یا تعداد زیاد مادها زمان اتصال را به طور قابل توجهی افزایش میدهند. منابع کلاینت خود را سبک نگه دارید تا بهترین تجربه بازیکن را داشته باشید.
منابع سرور (پلاگینهای Lua)
دایرکتوری Resources/Server/ شامل پلاگینهای Lua سمت سرور است. اینها فقط روی سرور اجرا میشوند و به بازیکنان ارسال نمیشوند. هر پلاگین در زیرپوشه خودش با یک فایل main.lua قرار دارد:
Resources/
Server/
MyPlugin/
main.lua <-- Plugin entry point
AnotherPlugin/
main.luaپلاگینهای سمت سرور میتوانند:
- به رویدادهای بازیکنان پاسخ دهند (ورود، خروج، پیامهای چت، ایجاد خودرو).
- دستورات سفارشی فعالشده از طریق چت را پیادهسازی کنند (مثلاً
/tp،/give). - مجوزها و محدودیتهای خودرو را مدیریت کنند.
- سیستمهای اقتصادی، انتقال مکانی یا سایر ویژگیهای گیمپلی سفارشی اضافه کنند.
- فعالیت بازیکنان را ثبت و قوانین را اجرا کنند.
افزودن نقشههای سفارشی
برای اجرای یک نقشه سفارشی (غیر پیشفرض) روی سرور BeamMP خود:
- ماد نقشه را به صورت فایل
.zipاز یک منبع ماد BeamNG.drive (مثلاً مخزن ماد BeamNG.drive) دانلود کنید. - سرور خود را در GPanel متوقف کنید.
- فایل
.zipرا از طریق تب Files یا SFTP درResources/Client/آپلود کنید. فایل zip را استخراج نکنید. - متغیر استارتاپ
MAP(یاMapدرServerConfig.toml) را به مسیر صحیح نقشه سفارشی بهروزرسانی کنید. این مسیر معمولاً به فرمت/levels/map_name/info.jsonاست — مستندات ماد را برای مسیر دقیق بررسی کنید. - سرور را راهاندازی کنید.
Map با مسیر واقعی داخل فایل .zip ماد مطابقت نداشته باشد، سرور نقشه را بارگذاری نخواهد کرد. مستندات ماد را بررسی کنید یا ساختار .zip را بازرسی کنید تا مسیر صحیح /levels/ را پیدا کنید.
Resources/Client/ را که بازیکن قبلاً ندارد دانلود میکند. بازیکنان نیازی به نصب دستی مادهای نقشه ندارند.
مدیریت خودروها
مدیریت خودرو در سرورهای BeamMP از طریق تنظیم MaxCars و به صورت اختیاری از طریق پلاگینهای Lua سمت سرور کنترل میشود.
تنظیم MaxCars
تنظیم MaxCars در ServerConfig.toml (یا متغیر استارتاپ MAX_CARS) تعداد خودروهایی را که هر بازیکن میتواند به طور همزمان ایجاد کند کنترل میکند:
1— هر بازیکن میتواند یک خودرو در هر زمان داشته باشد (برای سرورهای بزرگتر توصیه میشود).2–3— به بازیکنان اجازه میدهد چند خودرو داشته باشند، برای سرورهای کوچکتر یا نمایشگاههای خودرو مفید است.- مقادیر بالاتر بار سرور را به طور متناسب افزایش میدهند.
مادهای خودروی سفارشی
برای افزودن خودروهای سفارشی به سرور خود:
- ماد خودرو را به صورت فایل
.zipدانلود کنید. - آن را در
Resources/Client/قرار دهید. - سرور را ریاستارت کنید. بازیکنان به طور خودکار ماد خودرو را هنگام اتصال دانلود خواهند کرد.
محدودسازی خودروها از طریق پلاگینها
برای کنترل دقیقتر (مثلاً مسدود کردن خودروهای خاص، محدود کردن انواع خودرو)، به یک پلاگین Lua سمت سرور نیاز دارید. این پلاگینها میتوانند رویدادهای ایجاد خودرو را رهگیری کنند و بر اساس قوانین سفارشی آنها را مجاز یا رد کنند. انجمنهای BeamMP را برای پلاگینهای مدیریت خودرو بررسی کنید.
نصب و مدیریت پلاگینها
پلاگینهای Lua سمت سرور عملکرد سرور شما را گسترش میدهند. نحوه نصب و مدیریت آنها به شرح زیر است:
نصب یک پلاگین
- فایلهای پلاگین را دانلود کنید (معمولاً یک پوشه حاوی
main.luaو احتمالاً فایلهای دیگر). - سرور خود را متوقف کنید.
- پوشه پلاگین را از طریق تب Files یا SFTP در
Resources/Server/آپلود کنید. - مطمئن شوید ساختار پوشه صحیح است:
Resources/Server/PluginName/main.lua. - سرور را راهاندازی کنید. کنسول پیامهایی را هنگام بارگذاری پلاگینها نمایش خواهد داد.
حذف یک پلاگین
- سرور خود را متوقف کنید.
- پوشه پلاگین را از
Resources/Server/حذف کنید. - سرور را راهاندازی کنید.
عیبیابی
خطاهای کلید احراز هویت
- بررسی کنید که کلید به درستی در متغیر استارتاپ
AUTH_KEYجایگذاری شده باشد — بدون فاصله یا خط شکست اضافی. - مطمئن شوید که کلید در BeamMP Keymaster باطل یا منقضی نشده باشد.
- هر کلید فقط در یک سرور به طور همزمان قابل استفاده است. اگر همان کلید را در جای دیگری استفاده میکنید، با خطا مواجه خواهد شد.
- کنسول خطاهای احراز هویت را هنگام راهاندازی نمایش میدهد اگر کلید نامعتبر باشد.
بازیکنان نمیتوانند متصل شوند
- تأیید کنید که سرور به طور کامل راهاندازی شده و در GPanel به صورت آنلاین نمایش داده میشود.
- بررسی کنید که بازیکن از لانچر BeamMP استفاده میکند، نه لانچر استاندارد BeamNG.drive.
- اگر سرور روی
Private = trueتنظیم شده است، بازیکنان باید با اتصال مستقیم و IP و پورت صحیح متصل شوند. به نحوه پیدا کردن IP و پورت سرور مراجعه کنید. - مطمئن شوید نسخه لانچر BeamMP بازیکن با نسخه سرور سازگار است. لانچرهای قدیمی ممکن است نتوانند متصل شوند.
- اگر سرور پر است (
MaxPlayersبه حد رسیده)، بازیکنان اضافی نمیتوانند تا زمانی که کسی خارج شود متصل شوند.
مشکلات همگامسازی مادها
- اگر بازیکنان در دانلود گیر کنند یا خطاهایی درباره مادهای گمشده دریافت کنند، بررسی کنید که فایلهای .zip ماد در
Resources/Client/خراب نباشند. - اگر فایل .zip آسیب دیده است، فایل ماد را دوباره دانلود و آپلود کنید.
- فایلهای ماد بسیار بزرگ ممکن است برای بازیکنان با اتصال کند باعث timeout شوند. حذف مادهای بزرگ غیرضروری را در نظر بگیرید.
- مطمئن شوید فایلهای .zip ماد تودرتو نباشند (یعنی یک .zip داخل یک پوشه داخل یک .zip دیگر).
مشکلات عملکرد با تعداد زیاد بازیکنان/خودروها
MaxCarsرا به1برای هر بازیکن کاهش دهید.- اگر سرور به طور مداوم لگ دارد،
MaxPlayersرا کاهش دهید. - برای عملکرد بهتر با تعداد زیاد بازیکن، به نقشه سادهتر (Grid Map یا Industrial) تغییر دهید.
- مادهای کلاینت غیرضروری را از
Resources/Client/حذف کنید تا زمان دانلود و مصرف حافظه کاهش یابد. - نمودارهای مصرف منابع GPanel را بررسی کنید — اگر CPU یا RAM به طور مداوم در حد مجاز است، ارتقای پلان سرور خود را در نظر بگیرید. یک تیکت پشتیبانی باز کنید تا گزینهها را بررسی کنید.
سرور در مرورگر نمایش داده نمیشود
- مطمئن شوید
Privateدر پیکربندی شما رویfalseتنظیم شده است. - بررسی کنید که کلید احراز هویت معتبر است و توسط سرور دیگری استفاده نمیشود.
- 1 تا 2 دقیقه پس از راهاندازی صبر کنید تا سرور در بکاند BeamMP ثبت شود.
- کنسول را برای هرگونه خطای مربوط به اتصال سرور اصلی بررسی کنید.
مقالات مرتبط
- راهنمای راهاندازی سرور BeamMP — راهاندازی اولیه، کلید احراز هویت، پیکربندی و دستورالعملهای اتصال
- نحوه پیدا کردن IP و پورت سرور
- نحوه آپلود فایل از طریق SFTP
- راهنمای راهاندازی سرور — راهنمای عمومی برای راهاندازی هر سرور بازی در Legion Hosting
نیاز به کمک بیشتری دارید؟
اگر مشکلاتی دارید که در این راهنما پوشش داده نشده، تیم پشتیبانی ما آماده کمک است. یک تیکت در legionhosting.net/submitticket.php با جزئیات سرور، توضیح مشکل و هرگونه پیام خطای مرتبط از کنسول GPanel باز کنید.
