يغطي هذا الدليل كيفية تثبيت إطار عمل التعديلات Oxide/uMod أو Carbon على خادم Rust الخاص بك، وإضافة الإضافات المجتمعية، وإدارتها عبر وحدة التحكم. لتكوين الخادم العام ومتغيرات التشغيل، راجع دليل تكوين خادم Rust.

تثبيت Oxide/uMod أو Carbon

Oxide (الذي يُصان حالياً باسم uMod) وCarbon هما إطارا عمل تعديلات لـ Rust يسمحان لك بتثبيت إضافات مبنية من المجتمع. تضيف هذه الأطر ميزات مثل أنظمة الاقتصاد، والحزم المخصصة، ومكافآت التصويت، ومناطق حماية PvE، وأكثر من ذلك بكثير.

لا تحتاج لرفع أي ملفات يدوياً. يتم تثبيت إطار عمل التعديلات تلقائياً عن طريق تعيين متغير تشغيل واحد:

1. أوقف خادمك من علامة تبويب Console في GPanel.
2. سجّل الدخول إلى GPanel واذهب إلى علامة تبويب Startup.
3. ابحث عن متغير FRAMEWORK واضبطه على:
   • oxide — لـ Oxide/uMod (الإطار الأكثر استخداماً، مع أكبر مكتبة إضافات)
   • carbon — لإطار عمل Carbon (بديل مع نظام إضافات خاص به)
   • vanilla — للتشغيل بدون أي إطار عمل تعديلات
4. شغّل الخادم. يتم تنزيل ملفات الإطار وتطبيقها تلقائياً. عند التشغيل الأول مع Oxide، يتم إنشاء بنية مجلد oxide/.
5. تحقق من سجل وحدة التحكم بحثاً عن سطر مثل Loaded plugin Oxide.Core لتأكيد أن Oxide نشط.

تثبيت الإضافات

يتم توزيع الإضافات كملفات .cs (مصدر C#). يقوم Oxide بتجميعها على الخادم أثناء التشغيل — لا حاجة للتجميع المسبق.

1. حمّل ملف الإضافة .cs من umod.org أو مصدر موثوق آخر.
2. ارفع ملف .cs إلى مجلد oxide/plugins/ على خادمك باستخدام SFTP أو مدير ملفات GPanel. للمساعدة في SFTP، راجع كيفية رفع الملفات عبر SFTP.
3. إذا كان الخادم يعمل، سيتم اكتشاف الإضافة وتجميعها تلقائياً خلال ثوانٍ قليلة. سترى مخرجات في وحدة التحكم تؤكد تحميلها، مثل Loaded plugin MyPlugin v1.2.3 by Author.
4. إذا لم يكن الخادم يعمل، سيتم تحميل الإضافة عند التشغيل التالي.

بنية مجلد Oxide

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

تكوين الإضافات

تُنشئ معظم الإضافات ملف تكوين JSON في oxide/config/ عند تحميلها لأول مرة. لتخصيص إضافة:

1. دع الإضافة تُحمَّل مرة واحدة على الأقل حتى تُنشئ ملف التكوين الافتراضي الخاص بها.
2. أوقف خادمك (أو لاحظ أن بعض الإضافات تدعم إعادة تحميل التكوين مباشرة).
3. افتح ملف تكوين الإضافة في oxide/config/PluginName.json باستخدام مدير ملفات GPanel أو SFTP.
4. عدّل الإعدادات واحفظ الملف.
5. أعد تحميل الإضافة بالأمر oxide.reload PluginName أو أعد تشغيل الخادم.

إدارة الإضافات عبر وحدة التحكم

يمكن تشغيل هذه الأوامر من وحدة تحكم GPanel أو عبر عميل RCON. لإعداد RCON، راجع الوصول إلى RCON وأوامر الإدارة في Rust.

تحديث الإضافات

لتحديث إضافة إلى إصدار أحدث:

1. حمّل ملف .cs المحدّث من صفحة الإضافة على umod.org.
2. ارفع الملف الجديد إلى oxide/plugins/، مع الكتابة فوق الملف الموجود.
3. إذا كان الخادم يعمل، يكتشف Oxide تغيير الملف ويعيد تجميع الإضافة وتحميلها تلقائياً. بدلاً من ذلك، شغّل الأمر oxide.reload PluginName.
4. تحقق من وحدة التحكم بحثاً عن أي أخطاء. قد تتطلب بعض تحديثات الإضافات تغييرات في ملف التكوين في oxide/config/.

إزالة الإضافات

لإزالة إضافة بالكامل:

1. شغّل الأمر oxide.unload PluginName لإلغاء تحميل الإضافة أثناء تشغيل الخادم.
2. احذف ملف .cs من oxide/plugins/.
3. اختيارياً احذف ملف تكوين الإضافة من oxide/config/ وملفات البيانات من oxide/data/ إذا لم تعد بحاجة إليها.

الإضافات الشائعة

استكشاف مشاكل الإضافات وإصلاحها

إذا لم يتم تحميل إضافاتك، تحقق مما يلي:

• تأكد من أن Oxide مثبت ونشط. في علامة تبويب Startup في GPanel، يجب أن يكون متغير FRAMEWORK مضبوطاً على oxide. يجب أن يُظهر سجل وحدة التحكم Loaded plugin Oxide.Core أثناء بدء التشغيل.
• يجب وضع ملفات الإضافات مباشرة في oxide/plugins/ بامتداد .cs بالضبط. الملفات في المجلدات الفرعية أو بامتدادات خاطئة يتم تجاهلها.
• تحقق من وحدة التحكم وoxide/logs/ بحثاً عن أخطاء التجميع. الإضافة التي بها خطأ في بناء الجملة ستفشل في التحميل ورسالة الخطأ ستصف المشكلة.
• بعض الإضافات لها تبعيات على إضافات أخرى (مثل العديد من إضافات المتاجر تتطلب Economics). ثبّت جميع التبعيات المطلوبة أولاً.

للمشاكل الشائعة الأخرى في الخادم، راجع استكشاف مشاكل خادم Rust وإصلاحها.

هل تحتاج مساعدة؟

إذا واجهت مشكلة غير مغطاة في هذا الدليل، فريق الدعم لدينا متاح للمساعدة. أرسل تذكرة دعم وقم بتضمين معرّف خادمك ووصف المشكلة وأي مخرجات وحدة تحكم ذات صلة.