מדריך זה מכסה הגדרת מנהל, משאבים בצד השרת, מפות מותאמות אישית, ניהול רכבים ופתרון בעיות עבור שרת BeamMP שלך ב-Legion Hosting. להגדרת שרת ראשונית, מפתחות אימות והגדרה בסיסית, ראה מדריך הגדרת שרת BeamMP.

---

הגדרת מנהל

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

פקודות קונסולה

קונסולת השרת ב-GPanel מספקת גישה ישירה לפקודות שרת מובנות. הקלד פקודות ישירות בשדה הקלט של הקונסולה:

---

מבנה תיקיית המשאבים

BeamMP משתמש בתיקיית Resources לארגון תוכן בצד השרת. תיקייה זו מכילה שתי תת-תיקיות עם מטרות שונות:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

משאבי לקוח

קבצים שמוצבים ב-Resources/Client/ מורדים אוטומטית על ידי השחקנים כשהם מתחברים. זה משמש עבור:

• מפות מותאמות אישית — קבצי .zip של מודי מפות שהשחקנים צריכים כדי לטעון את מפת השרת.
• רכבים מותאמים אישית — קבצי .zip של מודי רכבים שמוסיפים מכוניות חדשות או משנים קיימות.
• מודים אחרים ללקוח — כל מוד של BeamNG.drive שצריך להיות נוכח בצד הלקוח.

משאבי שרת (תוספי Lua)

תיקיית Resources/Server/ מכילה תוספי Lua בצד השרת. אלה רצים על השרת בלבד ולא נשלחים לשחקנים. כל תוסף נמצא בתת-תיקייה משלו עם קובץ main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

תוספים בצד השרת יכולים:

• להגיב לאירועי שחקנים (הצטרפות, עזיבה, הודעות צ'אט, הופעת רכבים).
• ליישם פקודות מותאמות אישית שמופעלות דרך הצ'אט (למשל, /tp, /give).
• לנהל הרשאות ומגבלות רכבים.
• להוסיף מערכות כלכלה, טלפורטציה, או תכונות משחקיות מותאמות אחרות.
• לתעד פעילות שחקנים ולאכוף כללים.

---

הוספת מפות מותאמות אישית

כדי להריץ מפה מותאמת אישית (לא ברירת מחדל) בשרת BeamMP שלך:

1. הורד את מוד המפה כקובץ .zip ממקור מודים של BeamNG.drive (למשל, מאגר המודים של BeamNG.drive).
2. עצור את השרת ב-GPanel.
3. העלה את קובץ ה-.zip אל Resources/Client/ דרך לשונית Files או SFTP. אל תחלץ את הקובץ.
4. עדכן את משתנה ההפעלה MAP (או Map ב-ServerConfig.toml) לנתיב המפה הנכון של המפה המותאמת. נתיב זה בדרך כלל בפורמט /levels/map_name/info.json — בדוק את תיעוד המוד לנתיב המדויק.
5. הפעל את השרת.

---

ניהול רכבים

ניהול רכבים בשרתי BeamMP נשלט דרך הגדרת MaxCars ובאופן אופציונלי דרך תוספי Lua בצד השרת.

הגדרת MaxCars

הגדרת MaxCars ב-ServerConfig.toml (או משתנה ההפעלה MAX_CARS) שולטת בכמה רכבים כל שחקן יכול להפעיל בו-זמנית:

• 1 — כל שחקן יכול להחזיק רכב אחד בכל פעם (מומלץ לשרתים גדולים).
• 2–3 — מאפשר לשחקנים להחזיק כמה רכבים, שימושי לשרתים קטנים או מפגשי רכבים.
• ערכים גבוהים יותר מגדילים את עומס השרת באופן יחסי.

מודי רכבים מותאמים אישית

כדי להוסיף רכבים מותאמים לשרת שלך:

1. הורד את מוד הרכב כקובץ .zip.
2. הנח אותו ב-Resources/Client/.
3. הפעל מחדש את השרת. שחקנים יורידו אוטומטית את מוד הרכב בעת התחברות.

הגבלת רכבים דרך תוספים

לשליטה מפורטת יותר (למשל, חסימת רכבים ספציפיים, הגבלת סוגי רכבים), תצטרך תוסף Lua בצד השרת. תוספים אלה יכולים ליירט אירועי הופעת רכבים ולאשר או לדחות אותם על סמך כללים מותאמים. בדוק בפורומי BeamMP תוספי ניהול רכבים.

---

התקנה וניהול תוספים

תוספי Lua בצד השרת מרחיבים את הפונקציונליות של השרת שלך. כך תתקין ותנהל אותם:

התקנת תוסף

1. הורד את קבצי התוסף (בדרך כלל תיקייה המכילה main.lua ואולי קבצים נוספים).
2. עצור את השרת.
3. העלה את תיקיית התוסף אל Resources/Server/ דרך לשונית Files או SFTP.
4. ודא שמבנה התיקיות נכון: Resources/Server/PluginName/main.lua.
5. הפעל את השרת. הקונסולה תציג הודעות בעת טעינת התוספים.

הסרת תוסף

1. עצור את השרת.
2. מחק את תיקיית התוסף מ-Resources/Server/.
3. הפעל את השרת.

---

פתרון בעיות

שגיאות מפתח אימות

• ודא שהמפתח הודבק נכון במשתנה ההפעלה AUTH_KEY — ללא רווחים או שורות נוספות.
• ודא שהמפתח לא בוטל או פג תוקפו ב-BeamMP Keymaster.
• כל מפתח יכול לשמש רק בשרת אחד בכל פעם. אם אתה משתמש באותו מפתח במקום אחר, זה ייכשל.
• הקונסולה תציג שגיאות אימות בעת ההפעלה אם המפתח אינו תקין.

שחקנים לא יכולים להתחבר

• אשר שהשרת הופעל במלואו ומופיע כמקוון ב-GPanel.
• בדוק שהשחקן משתמש ב-משגר BeamMP, ולא במשגר הרגיל של BeamNG.drive.
• אם השרת מוגדר ל-Private = true, שחקנים חייבים להשתמש בחיבור ישיר עם ה-IP והפורט הנכונים. ראה כיצד למצוא את כתובת ה-IP והפורט של השרת שלך.
• ודא שגרסת משגר BeamMP של השחקן תואמת לגרסת השרת. משגרים מיושנים עלולים להיכשל בהתחברות.
• אם השרת מלא (הגיע ל-MaxPlayers), שחקנים נוספים לא יכולים להצטרף עד שמישהו עוזב.

בעיות סנכרון מודים

• אם שחקנים נתקעים בהורדה או מקבלים שגיאות על מודים חסרים, ודא שקבצי ה-.zip של המודים ב-Resources/Client/ אינם פגומים.
• הורד מחדש והעלה מחדש את קובץ המוד אם ה-.zip ניזוק.
• קבצי מוד גדולים מאוד עלולים לגרום לפסקי זמן לשחקנים עם חיבורים איטיים. שקול להסיר מודים גדולים מיותרים.
• ודא שקבצי .zip של מודים אינם מקוננים (כלומר, .zip בתוך תיקייה בתוך .zip נוסף).

בעיות ביצועים עם שחקנים/רכבים רבים

• הפחת את MaxCars ל-1 לכל שחקן.
• הורד את MaxPlayers אם השרת חווה השהיות באופן עקבי.
• עבור למפה פשוטה יותר (Grid Map או Industrial) לביצועים טובים יותר עם מספר שחקנים גבוה.
• הסר מודי לקוח מיותרים מ-Resources/Client/ כדי להפחית זמני הורדה ושימוש בזיכרון.
• בדוק את גרפי השימוש במשאבים ב-GPanel — אם המעבד או הזיכרון נמצאים באופן עקבי במגבלה, שקול לשדרג את תוכנית השרת שלך. פתח פניית תמיכה כדי לדון באפשרויות.

השרת לא מופיע ברשימת השרתים

• ודא ש-Private מוגדר ל-false בהגדרות שלך.
• ודא שמפתח האימות תקין ולא בשימוש בשרת אחר.
• המתן 1–2 דקות לאחר ההפעלה עד שהשרת יירשם בשרת הראשי של BeamMP.
• בדוק בקונסולה אם יש שגיאות הקשורות לחיבור לשרת הראשי.

---

מאמרים קשורים

• מדריך הגדרת שרת BeamMP — הגדרה ראשונית, מפתח אימות, תצורה והוראות התחברות
• כיצד למצוא את כתובת ה-IP והפורט של השרת שלך
• כיצד להעלות קבצים דרך SFTP
• מדריך הפעלת שרת — מדריך כללי להפעלת כל שרת משחקים ב-Legion Hosting

---

צריך עזרה נוספת?

אם אתה נתקל בבעיות שלא מכוסות במדריך זה, צוות התמיכה שלנו זמין לסייע. פתח פנייה בכתובת legionhosting.net/submitticket.php עם פרטי השרת שלך, תיאור הבעיה וכל הודעות שגיאה רלוונטיות מקונסולת GPanel.