מדריך זה מכסה כיצד להתקין את מסגרת המודים 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.

צריכים עזרה?

אם נתקלת בבעיה שלא מכוסה במדריך זה, צוות התמיכה שלנו זמין לעזור. פתח פנייה לתמיכה וכלול את מזהה השרת שלך, תיאור הבעיה וכל פלט קונסול רלוונטי.