این راهنما نحوه نصب فریمورک مادینگ Oxide/uMod یا Carbon روی سرور Rust، افزودن پلاگینهای جامعه و مدیریت آنها از طریق کنسول را پوشش میدهد. برای پیکربندی عمومی سرور و متغیرهای راهاندازی، راهنمای پیکربندی سرور Rust را مشاهده کنید.
نصب Oxide/uMod یا Carbon
Oxide (که اکنون با نام uMod نگهداری میشود) و Carbon فریمورکهای مادینگ برای Rust هستند که امکان نصب پلاگینهای ساخته شده توسط جامعه را فراهم میکنند. این فریمورکها قابلیتهایی مانند سیستمهای اقتصادی، کیتهای سفارشی، پاداش رأیگیری، مناطق حفاظت شده PvE و موارد بسیار بیشتری اضافه میکنند.
نیازی به آپلود دستی هیچ فایلی نیست. فریمورک مادینگ به صورت خودکار با تنظیم یک متغیر راهاندازی نصب میشود:
- سرور خود را از تب Console در GPanel متوقف کنید.
- به GPanel وارد شوید و به تب Startup بروید.
- متغیر
FRAMEWORKرا پیدا کرده و روی یکی از موارد زیر تنظیم کنید:oxide— برای Oxide/uMod (پرکاربردترین فریمورک با بزرگترین کتابخانه پلاگین)carbon— برای فریمورک Carbon (یک جایگزین با اکوسیستم پلاگین مخصوص خود)vanilla— برای اجرا بدون هیچ فریمورک مادینگی
- سرور را راهاندازی کنید. فایلهای فریمورک به صورت خودکار دانلود و اعمال میشوند. در اولین راهاندازی با Oxide، ساختار دایرکتوری
oxide/ایجاد میشود. - لاگ کنسول را برای خطی مانند
Loaded plugin Oxide.Coreبررسی کنید تا فعال بودن Oxide را تأیید کنید.
FRAMEWORK را تنظیم کرده و سرور را راهاندازی میکنید، فریمورک به صورت خودکار دانلود و نصب میشود. نیازی به آپلود فایلهای Oxide یا Carbon از طریق SFTP نیست.
نصب پلاگینها
پلاگینها به صورت فایلهای .cs (سورس C#) توزیع میشوند. Oxide آنها را در زمان اجرا روی سرور کامپایل میکند — نیازی به پیشکامپایل نیست.
- فایل
.csپلاگین را از umod.org یا منبع معتبر دیگری دانلود کنید. - فایل
.csرا با استفاده از SFTP یا مدیریت فایل GPanel به دایرکتوریoxide/plugins/روی سرور آپلود کنید. برای کمک در مورد SFTP، نحوه آپلود فایل از طریق SFTP را مشاهده کنید. - اگر سرور در حال اجرا باشد، پلاگین ظرف چند ثانیه شناسایی و به صورت خودکار کامپایل میشود. خروجیای در کنسول مبنی بر بارگذاری آن خواهید دید، مثلاً
Loaded plugin MyPlugin v1.2.3 by Author. - اگر سرور در حال اجرا نباشد، پلاگین در راهاندازی بعدی بارگذاری خواهد شد.
ساختار دایرکتوری Oxide
oxide/
plugins/
MyPlugin.cs <- place plugin files here
AnotherPlugin.cs
config/ <- auto-generated plugin config files
data/ <- plugin data files
logs/ <- plugin log filesoxide/plugins/ قرار گیرند. فایلهایی که در زیردایرکتوریها قرار بگیرند یا پسوند نادرست داشته باشند نادیده گرفته میشوند. هر پلاگین باید پسوند .cs داشته باشد.
پیکربندی پلاگینها
بیشتر پلاگینها اولین باری که بارگذاری میشوند یک فایل پیکربندی JSON در oxide/config/ ایجاد میکنند. برای سفارشیسازی یک پلاگین:
- اجازه دهید پلاگین حداقل یک بار بارگذاری شود تا فایل پیکربندی پیشفرض خود را ایجاد کند.
- سرور خود را متوقف کنید (یا توجه داشته باشید که برخی پلاگینها از بارگذاری مجدد زنده پیکربندی پشتیبانی میکنند).
- فایل پیکربندی پلاگین را در
oxide/config/PluginName.jsonبا استفاده از مدیریت فایل GPanel یا SFTP باز کنید. - تنظیمات را ویرایش کرده و فایل را ذخیره کنید.
- پلاگین را با
oxide.reload PluginNameبارگذاری مجدد کنید یا سرور را ریاستارت کنید.
مدیریت پلاگینها از طریق کنسول
این دستورات را میتوان از کنسول GPanel یا از طریق یک کلاینت RCON اجرا کرد. برای تنظیم RCON، دسترسی RCON و دستورات ادمین Rust را مشاهده کنید.
| دستور | توضیحات |
|---|---|
oxide.plugins |
لیست تمام پلاگینهای بارگذاری شده فعلی و نسخههای آنها. |
oxide.load PluginName |
بارگذاری پلاگینی که در oxide/plugins/ موجود است اما هنوز بارگذاری نشده. |
oxide.unload PluginName |
تخلیه یک پلاگین بدون حذف فایل. |
oxide.reload PluginName |
بارگذاری مجدد یک پلاگین پس از بهروزرسانی فایل .cs آن. از این برای اعمال بهروزرسانیهای پلاگین بدون ریاستارت کامل سرور استفاده کنید. |
oxide.reload * |
بارگذاری مجدد تمام پلاگینهای بارگذاری شده به صورت یکجا. |
بهروزرسانی پلاگینها
برای بهروزرسانی یک پلاگین به نسخه جدیدتر:
- فایل
.csبهروزرسانی شده را از صفحه پلاگین در umod.org دانلود کنید. - فایل جدید را به
oxide/plugins/آپلود کنید و فایل موجود را بازنویسی کنید. - اگر سرور در حال اجرا باشد، Oxide تغییر فایل را شناسایی کرده و پلاگین را به صورت خودکار مجدداً کامپایل و بارگذاری میکند. همچنین میتوانید
oxide.reload PluginNameرا اجرا کنید. - کنسول را برای خطاها بررسی کنید. برخی بهروزرسانیهای پلاگین ممکن است نیاز به تغییرات در فایل پیکربندی در
oxide/config/داشته باشند.
حذف پلاگینها
برای حذف کامل یک پلاگین:
- دستور
oxide.unload PluginNameرا برای تخلیه پلاگین در حین اجرای سرور اجرا کنید. - فایل
.csرا ازoxide/plugins/حذف کنید. - در صورت عدم نیاز، فایل پیکربندی پلاگین را از
oxide/config/و فایلهای داده را ازoxide/data/نیز حذف کنید.
پلاگینهای محبوب
| پلاگین | دستهبندی | توضیحات |
|---|---|---|
| Kits | گیمپلی | به بازیکنان اجازه میدهد کیتهای آیتم از پیش تنظیم شده را دریافت کنند. مفید برای کیتهای شروع یا پاداشهای VIP. |
| Economics | اقتصاد | سیستم ارز سرور اضافه میکند. به عنوان وابستگی توسط بسیاری از پلاگینهای فروشگاه و پاداش استفاده میشود. |
| ServerRewards | اقتصاد | سیستم پاداش مبتنی بر امتیاز، اغلب با Economics برای فروشگاه درون بازی ترکیب میشود. |
| VoteDay | ابزار | به بازیکنان اجازه میدهد برای رد شدن به روز رأی دهند. شکایات مربوط به شبهای طولانی را کاهش میدهد. |
| Clans | اجتماعی | سیستم کلن/تیم با تگهای کلن و دسترسی مشترک به جعبه ابزار اضافه میکند. |
| TruePVE | PvE | آسیب بازیکن به بازیکن را جلوگیری میکند. ضروری برای پیکربندیهای سرور PvE. |
| Teleportation | ابزار | دستورات انتقال آنی بازیکن به بازیکن و خانه با زمان انتظار قابل تنظیم اضافه میکند. |
| DiscordCore / DiscordMessages | یکپارچهسازی | رویدادهای سرور (اتصالها، چت، مرگها) را به یک کانال webhook در Discord ارسال میکند. |
عیبیابی مشکلات پلاگین
اگر پلاگینهای شما بارگذاری نمیشوند، موارد زیر را بررسی کنید:
- تأیید کنید Oxide نصب و فعال است. در تب Startup GPanel، متغیر
FRAMEWORKباید رویoxideتنظیم شده باشد. لاگ کنسول باید در هنگام راهاندازیLoaded plugin Oxide.Coreرا نشان دهد. - فایلهای پلاگین باید مستقیماً در
oxide/plugins/با پسوند دقیق.csقرار بگیرند. فایلهای در زیردایرکتوریها یا با پسوند نادرست نادیده گرفته میشوند. - کنسول و
oxide/logs/را برای خطاهای کامپایل بررسی کنید. پلاگینی با خطای نحوی بارگذاری نخواهد شد و پیام خطا مشکل را توصیف میکند. - برخی پلاگینها به پلاگینهای دیگر وابستگی دارند (مثلاً بسیاری از پلاگینهای فروشگاه به Economics نیاز دارند). ابتدا تمام وابستگیهای مورد نیاز را نصب کنید.
برای سایر مشکلات رایج سرور، عیبیابی سرور Rust را مشاهده کنید.
نیاز به کمک دارید؟
اگر با مشکلی مواجه شدید که در این راهنما پوشش داده نشده، تیم پشتیبانی ما آماده کمک است. یک تیکت پشتیبانی ارسال کنید و شناسه سرور، شرح مشکل و خروجی مربوطه کنسول را ضمیمه کنید.
