این راهنما نحوه نصب و پیکربندی ماد ادمین ULX روی سرور Garry's Mod میزبانی شده توسط Legion Hosting را پوشش میدهد، از جمله نصب، اعطای دسترسی ادمین، دستورات رایج و مدیریت گروههای دسترسی.
فهرست مطالب
- نصب ULX و ULib
- اعطای دسترسی Superadmin به خودتان
- دستورات رایج ULX
- گروههای دسترسی
- دستورات چت
- فایلهای پیکربندی
۱. نصب ULX و ULib
ULX پرکاربردترین ماد ادمین برای Garry's Mod است. این ماد نیاز به نصب دو افزونه با هم دارد:
| افزونه | Workshop ID | توضیحات |
|---|---|---|
| ULib | 557962280 | کتابخانه مورد نیاز برای ULX. باید ابتدا نصب شود. |
| ULX | 557962238 | خود ماد ادمین. وابسته به ULib است. |
گزینه A — مجموعه Workshop (توصیه شده)
هر دو Workshop ID را به مجموعه Workshop سرور خود اضافه کنید. اگر قبلاً یک مجموعه از طریق +host_workshop_collection در GPanel پیکربندی کردهاید، کافی است ULib و ULX را به آن مجموعه موجود در Steam اضافه کنید. سرور آنها را بهطور خودکار در ریستارت بعدی دانلود خواهد کرد.
گزینه B — آپلود دستی از طریق SFTP
- هر دو افزونه را از Workshop یا از GitHub تیم Ulysses دانلود کنید.
- آنها را از طریق SFTP به سرور خود آپلود کنید بهطوری که ساختار پوشه به شکل زیر باشد:
garrysmod/addons/ulib/
garrysmod/addons/ulx/
هر پوشه باید مستقیماً شامل دایرکتوری lua/ افزونه در داخل خود باشد.
۲. اعطای دسترسی Superadmin به خودتان
پس از نصب ULX و ریستارت سرور، باید رتبه superadmin را به خودتان اعطا کنید. کنسول سرور را در GPanel باز کنید و اجرا کنید:
ulx adduser "YourSteamName" superadmin
اگر نام Steam شما شامل کاراکترهای خاص یا فاصله است، برای دقت بیشتر از Steam ID ۶۴ بیتی خود استفاده کنید:
ulx adduserid "STEAM_0:1:12345678" superadmin
STEAM_0:X:XXXXXXXX یا فرمت ۶۴ بیتی 7656119XXXXXXXXXX استفاده کنید.
پس از اعطا، مجدداً به سرور متصل شوید. میتوانید رتبه خود را با تایپ !menu در چت برای باز کردن رابط کاربری ادمین ULX تأیید کنید.
۳. دستورات رایج ULX
دستورات ULX را میتوان از کنسول سرور در GPanel، کنسول درون بازی یا به عنوان دستورات چت (با پیشوند !) اجرا کرد. در زیر پرکاربردترین دستورات آمده است.
مدیریت بازیکنان
| دستور | میانبر چت | توضیحات |
|---|---|---|
ulx kick "Player" reason | !kick Player reason | اخراج یک بازیکن از سرور |
ulx ban "Player" minutes reason | !ban Player 60 reason | مسدود کردن یک بازیکن (۰ = دائمی) |
ulx unban STEAMID | !unban STEAMID | رفع مسدودیت یک بازیکن با Steam ID |
ulx slay "Player" | !slay Player | کشتن فوری یک بازیکن |
ulx slap "Player" damage | !slap Player 10 | ضربه زدن به یک بازیکن با آسیب مشخص |
کنترلهای ارتباطی
| دستور | میانبر چت | توضیحات |
|---|---|---|
ulx gag "Player" | !gag Player | جلوگیری از استفاده بازیکن از چت صوتی |
ulx ungag "Player" | !ungag Player | بازگرداندن چت صوتی برای یک بازیکن |
ulx mute "Player" | !mute Player | جلوگیری از استفاده بازیکن از چت متنی |
ulx unmute "Player" | !unmute Player | بازگرداندن چت متنی برای یک بازیکن |
دستورات کاربردی
| دستور | میانبر چت | توضیحات |
|---|---|---|
ulx noclip "Player" | !noclip Player | فعال/غیرفعال کردن noclip (پرواز از میان دیوارها) |
ulx god "Player" | !god Player | فعال/غیرفعال کردن حالت خدا (شکستناپذیری) |
ulx teleport "Player" | !tp Player | انتقال یک بازیکن به محل نشانگر شما |
ulx bring "Player" | !bring Player | انتقال یک بازیکن به محل شما |
ulx goto "Player" | !goto Player | انتقال خودتان به محل یک بازیکن |
ulx return "Player" | !return Player | بازگرداندن یک بازیکن به موقعیت قبلی |
ulx cloak "Player" | !cloak Player | نامرئی کردن یک بازیکن |
۴. گروههای دسترسی
ULX از یک سیستم دسترسی مبتنی بر گروه استفاده میکند. بهطور پیشفرض، ULX شامل این گروهها است، از بیشترین به کمترین سطح دسترسی:
| گروه | ارثبری از | کاربرد معمول |
|---|---|---|
superadmin | admin | مالک سرور. دسترسی کامل به تمام دستورات. |
admin | operator | کارکنان قابل اعتماد. توانایی مسدود کردن، اخراج و مدیریت بازیکنان. |
operator | user | مدیران جونیور. دستورات مدیریتی محدود. |
user | هیچکدام | گروه پیشفرض برای همه بازیکنان. |
مدیریت کاربران و گروهها
// Add a user to a group
ulx adduser "Player" admin
// Remove a user from their group (reverts to "user")
ulx removeuser "Player"
// Create a custom group that inherits from "operator"
ulx groupallow "moderator" "ulx kick"
ulx addgroup "moderator" "operator"
// Grant a specific command to a group
ulx groupallow "admin" "ulx ban"
// Deny a specific command from a group
ulx groupdeny "operator" "ulx ban"
استفاده از رابط کاربری گرافیکی
به عنوان superadmin، !menu را در چت تایپ کنید تا پنل ادمین ULX باز شود. تب Groups یک رابط بصری برای ایجاد گروهها، تخصیص دسترسیها و مدیریت کاربران بدون دستورات کنسول فراهم میکند.
garrysmod/data/ulib/groups.txt و دادههای کاربران در garrysmod/data/ulib/users.txt ذخیره میشوند. این فایلها بهطور خودکار توسط ULX مدیریت میشوند، اما میتوانید از طریق SFTP از آنها پشتیبانگیری کنید.
۵. دستورات چت
ULX از میانبرهای دستوری مبتنی بر چت برای مدیریت سریع درون بازی پشتیبانی میکند. بهطور پیشفرض همه دستورات از پیشوند ! استفاده میکنند. برخی الگوهای مفید:
| دستور چت | عملکرد |
|---|---|
!menu | باز کردن رابط کاربری ادمین ULX |
!motd | نمایش پیام روز |
!kick Player reason | اخراج بازیکن نامبرده |
!ban Player 60 reason | مسدود کردن به مدت ۶۰ دقیقه |
!hp Player 100 | تنظیم سلامت یک بازیکن |
!armor Player 100 | تنظیم زره یک بازیکن |
@ به عنوان هدف برای اعمال دستور روی خودتان استفاده کنید. به عنوان مثال، !god @ حالت خدا را روی خودتان فعال/غیرفعال میکند.
۶. فایلهای پیکربندی
ULX پیکربندی و دادههای خود را در garrysmod/data/ulib/ ذخیره میکند. فایلهای کلیدی که باید از آنها آگاه باشید:
| فایل | کاربرد |
|---|---|
data/ulib/users.txt | تمام تخصیصهای کاربر به گروه و Steam IDها |
data/ulib/groups.txt | تعریف گروهها، ارثبری و دسترسیها |
data/ulib/bans.txt | لیست مسدودیتهای فعال با زمان انقضا |
data/ulx/config.txt | تنظیمات ULX (پیام روز، پیام خوشآمدگویی، لاگگیری و غیره) |
data/ulib/ و data/ulx/ را از طریق SFTP به عنوان پشتیبان دانلود کنید. یک فایل گروههای پیکربندی نادرست میتواند دسترسی همه ادمینها را مسدود کند.
مقالات مرتبط
- راهنمای راهاندازی سرور Garry's Mod — Server.cfg، Workshop، حالتهای بازی، DarkRP، FastDL
- رفع مشکلات Garry's Mod — تکسچرهای گمشده، خطاهای Workshop و موارد دیگر
- نحوه آپلود فایلها از طریق SFTP