این راهنما مشکلات رایجی را که ممکن است هنگام اجرای سرور اختصاصی Garry's Mod با Legion Hosting با آنها مواجه شوید، همراه با دلایل و راهحلها پوشش میدهد.
راهاندازی سرور: اگر هنوز سرور خود را پیکربندی نکردهاید، ابتدا راهنمای راهاندازی سرور Garry's Mod را ببینید. برای مشکلات مربوط به ماد ادمین، راهاندازی مدیریت Garry's Mod (ULX) را ببینید.
فهرست مطالب
- تکسچرهای گمشده / شطرنجی صورتی و مشکی
- افزونههای Workshop دانلود نمیشوند
- سرور در مرورگر سرورها نمایش داده نمیشود
- مشاغل DarkRP نمایش داده نمیشوند
- دستورات ULX کار نمیکنند
- پینگ بالا / لگ
- سرور هنگام استارت کرش میکند
- کلاینتها در "در حال دانلود" گیر میکنند یا اتصال کند است
1. تکسچرهای گمشده / شطرنجی صورتی و مشکی
دلیل: Garry's Mod شامل منابع بازیهای دیگر Valve (Counter-Strike: Source، Half-Life 2 و غیره) نمیشود. بسیاری از نقشهها و افزونههای جامعه از تکسچرهای CS:S استفاده میکنند.
راهحلهای سمت سرور
- نصب Counter-Strike: Source: در GPanel، بررسی کنید که آیا پلن شما شامل نصب محتوای بازیهای اضافی میشود. در صورت موجود بودن، نصب CS:S را در تنظیمات سرور فعال کنید.
- افزونه محتوای CSS: یک پک محتوای CS:S از Workshop Garry's Mod را به مجموعه Workshop سرور خود اضافه کنید. عبارت "Counter-Strike: Source Content" را جستجو کرده و آن را اضافه کنید.
- آپلود دستی: اگر هیچکدام از گزینههای بالا در دسترس نیست، میتوانید فایلهای محتوای CS:S را به صورت دستی از طریق SFTP به
garrysmod/addons/css-content/آپلود کنید. برای دستورالعملها، راهنمای آپلود SFTP را ببینید.
راهحل سمت کلاینت
بازیکنانی که Counter-Strike: Source را دارند، میتوانند آن را در GMod از مسیر Options → Game Content نصب کنند. این کار تکسچرهای گمشده را در سمت آنها بدون نیاز به تغییر سرور حل میکند.
2. افزونههای Workshop دانلود نمیشوند
اگر سرور شما هنگام استارت افزونههای Workshop را بارگذاری نمیکند، موارد زیر را بررسی کنید:
| بررسی | راهحل |
|---|---|
| کلید API Steam گمشده یا نامعتبر | در GPanel در بخش Startup، متغیر STEAM_API_KEY را به یک کلید معتبر از steamcommunity.com/dev/apikey تنظیم کنید. |
| مجموعه عمومی نیست | مجموعه Workshop شما باید روی Public تنظیم شده باشد. مجموعههای فهرستنشده یا خصوصی روی سرور اختصاصی دانلود نمیشوند. |
| شناسه مجموعه در جای اشتباه | پارامتر +host_workshop_collection باید در خط فرمان Startup GPanel باشد، نه در server.cfg. |
| خطای 403 / احراز هویت در کنسول | کلید API Steam شما نامعتبر است یا باطل شده. یک کلید جدید تولید کنید و آن را در GPanel بهروزرسانی کنید. |
نکته: خروجی کنسول سرور را در GPanel پس از ریاستارت بررسی کنید. خطاهای دانلود Workshop در ابتدای لاگ استارتاپ با شناسههای Workshop خاصی که دانلود نشدهاند نمایش داده میشوند.
3. سرور در مرورگر سرورها نمایش داده نمیشود
اگر سرور شما در حال اجراست اما در مرورگر سرور Steam نمایش داده نمیشود:
- بررسی
sv_lan: مطمئن شویدsv_lan 0درserver.cfgتنظیم شده است. مقدار1سرور را فقط شبکه محلی میکند. - بررسی GSLT: مطمئن شوید یک Game Server Login Token معتبر از طریق
sv_setsteamaccountتنظیم شده است. یک توکن منقضی یا باطل شده از نمایش عمومی جلوگیری میکند. یک توکن جدید در steamcommunity.com/dev/managegameservers تولید کنید. - چند دقیقه صبر کنید: ممکن است چند دقیقه طول بکشد تا یک سرور جدید پس از اولین استارت در لیست سرور اصلی Steam نمایش داده شود.
- اتصال مستقیم را آزمایش کنید: ابتدا از طریق IP مستقیم اتصال را امتحان کنید (به دستورالعملهای اتصال مراجعه کنید) تا مطمئن شوید سرور واقعاً در حال اجراست.
مسدودیت GSLT: Steam میتواند یک GSLT را در صورت شناسایی سوءاستفاده یا تغییرات خاص سمت سرور مسدود کند. اگر توکن شما مسدود شد، باید یک توکن جدید تولید کنید و ممکن است نیاز به تماس با پشتیبانی Steam داشته باشید.
4. مشاغل DarkRP نمایش داده نمیشوند
اگر مشاغل سفارشی پس از راهاندازی DarkRP در منوی F4 نمایش داده نمیشوند:
- بررسی مکان پوشهها: DarkRP خودش باید در
garrysmod/gamemodes/darkrp/باشد، نه درaddons/. DarkRPModification باید درgarrysmod/addons/darkrpmodification/باشد. این رایجترین اشتباه است. - بررسی خطاهای Lua: کنسول سرور را در GPanel باز کنید و هنگام استارت به دنبال خطاهای Lua بگردید. یک خطای نحوی در
jobs.luaاز بارگذاری همه مشاغل سفارشی جلوگیری میکند. - تأیید حالت بازی: تأیید کنید که
sv_gamemode "darkrp"درserver.cfgتنظیم شده و سرور به طور کامل ریاستارت شده است (نه فقط تغییر نقشه). - بررسی انکودینگ فایل: اگر فایلهای Lua را در Windows ویرایش کردهاید، مطمئن شوید که به صورت UTF-8 بدون BOM ذخیره شدهاند. برخی ویرایشگرهای متن یک BOM (علامت ترتیب بایت) اضافه میکنند که میتواند تجزیه Lua را مختل کند.
مراحل سریع عیبیابی
// Run these in the server console to check gamemode status:
lua_run print(engine.ActiveGamemode())
// Should output: darkrp
lua_run PrintTable(RPExtraTeams)
// Should list all custom jobs if DarkRP loaded correctly5. دستورات ULX کار نمیکنند
اگر دستورات ULX پس از نصب خطا برمیگردانند یا کاری انجام نمیدهند:
- هر دو افزونه نصب شدهاند؟ ULX به هر دوی ULib و ULX نیاز دارد. ULX بدون ULib کار نمیکند. وجود هر دو را در
garrysmod/addons/یا در مجموعه Workshop خود تأیید کنید. - بررسی کنسول برای خطاها: خروجی کنسول سرور را در GPanel هنگام استارت برای خطاهای مربوط به ULib یا ULX بررسی کنید.
- تأیید اختصاص کاربر: دستور
ulx adduserرا با نام نمایشی دقیق Steam خود اجرا کنید، یا برای اطمینان بیشتر ازulx adduserid "STEAM_0:1:12345678" superadminبا Steam ID خود استفاده کنید. - تداخل افزونهها: برخی افزونهها میتوانند با ULX تداخل داشته باشند. اگر دستورات پس از اضافه کردن یک افزونه جدید از کار افتادند، آن را حذف کرده و ریاستارت کنید تا مشکل را جدا کنید.
برای دستورالعملهای مفصل راهاندازی ULX، راهنمای راهاندازی مدیریت Garry's Mod (ULX) را ببینید.
6. پینگ بالا / لگ
اگر سرور شما پینگ بالا یا لگهای ناگهانی را تجربه میکند:
- تعداد زیاد افزونهها: مجموعههای بزرگ Workshop مصرف حافظه و زمان بارگذاری را افزایش میدهند. مجموعه خود را بررسی کنید و افزونههایی که فعالانه استفاده نمیشوند را حذف کنید.
- اضافهبار موجودیتها (DarkRP): سرورهای DarkRP با موجودیتهای قابل اسپاون زیاد (چاپگر پول، آزمایشگاه مواد و غیره) میتوانند فشار زیادی روی CPU بگذارند. محدودیتهای منطقی برای موجودیتها در
darkrpmodification/lua/darkrp_config/settings.luaتنظیم کنید. - لگهای ذخیره خودکار: اگر لگهای ناگهانی در فواصل منظم (هر چند دقیقه) رخ میدهند، ممکن است سرور در حال ذخیره خودکار باشد. این رفتار عادی است اما فاصله زمانی آن قابل تنظیم است.
- تعداد بازیکنان در مقابل پلن: مطمئن شوید تعداد بازیکنان از ظرفیت منابع پلن شما فراتر نمیرود. اگر به محدودیت منابع نزدیک هستید،
maxplayersرا درserver.cfgکاهش دهید. - پیچیدگی نقشه: برخی نقشههای جامعه بهینهسازی ضعیفی دارند. اگر لگ پس از تغییر نقشه شروع شد، برای جدا کردن مشکل به یک نقشه سادهتر برگردید.
7. سرور هنگام استارت کرش میکند
اگر سرور شما کرش میکند یا استارت نمیشود:
- بررسی لاگ کنسول: در GPanel، خروجی کنسول قبل از کرش را بررسی کنید. آخرین چند خط معمولاً دلیل را نشان میدهند.
- افزونه معیوب: یک افزونه اخیراً اضافه شده ممکن است باعث کرش شود. آخرین افزونهای که اضافه کردید را حذف کنید و ریاستارت را امتحان کنید. اگر سرور استارت شد، آن افزونه مشکلساز است.
- فایلهای حالت بازی خراب: اگر از DarkRP یا حالت بازی شخص ثالث دیگری استفاده میکنید، آن را از Workshop یا GitHub دوباره نصب کنید.
- کمبود حافظه: تعداد زیاد افزونهها میتواند از حافظه اختصاصیافته پلن شما فراتر رود. مصرف منابع را در GPanel بررسی کنید و کاهش لیست افزونهها را در نظر بگیرید.
جدا کردن افزونه معیوب: اگر نمیتوانید تشخیص دهید کدام افزونه باعث کرش سرور میشود، همه افزونهها را از مجموعه Workshop خود حذف کنید و آنها را یکی یکی با ریاستارت بین هر کدام اضافه کنید تا مقصر را پیدا کنید.
8. کلاینتها در "در حال دانلود" گیر میکنند یا اتصال کند است
اگر بازیکنان هنگام اتصال برای مدت طولانی در حال دانلود محتوا هستند:
- FastDL را راهاندازی کنید: بدون FastDL، کلاینتها فایلها را مستقیماً از طریق سرور بازی دانلود میکنند که بسیار کند است. بخش FastDL از راهنمای راهاندازی سرور را ببینید.
- از Workshop برای افزونهها استفاده کنید: افزونههایی که از طریق Workshop ارائه میشوند از CDN Steam دانلود میشوند که سریعتر از دانلود مستقیم سرور است. تا حد امکان مجموعههای Workshop را به آپلود دستی افزونه ترجیح دهید.
- تعداد افزونهها را کاهش دهید: هر افزونه به زمان دانلود کلاینت اضافه میکند. افزونههایی که برای گیمپلی سرور شما ضروری نیستند را حذف کنید.
- استفاده از
resource.AddFileرا بررسی کنید: اگر بازیکنان را مجبور به دانلود فایلهای زیادی از طریقresource.luaمیکنید، لیست را بررسی کنید و ورودیهایی را که واقعاً در سمت کلاینت مورد نیاز نیستند حذف کنید.
مقالات مرتبط
- راهنمای راهاندازی سرور Garry's Mod — Server.cfg، Workshop، حالتهای بازی، DarkRP، FastDL
- راهاندازی مدیریت Garry's Mod (ULX) — نصب ULX/ULib، دستورات ادمین، گروههای مجوز
- نحوه آپلود فایل از طریق SFTP
- نحوه یافتن IP و پورت سرور
هنوز مشکل دارید؟ اگر هیچکدام از راهحلهای بالا مشکل شما را حل نکرد، یک تیکت پشتیبانی ارسال کنید و IP سرور، توضیح مشکل و خروجی کنسول یا پیامهای خطای مربوطه را درج کنید.
