מדריך זה מכסה בעיות נפוצות שאתה עשוי להיתקל בהן בעת הפעלת שרת Garry's Mod ייעודי עם Legion Hosting, יחד עם הסיבות והפתרונות שלהן.

---

תוכן עניינים

1. טקסטורות חסרות / משבצות ורודות ושחורות
2. תוספי Workshop לא יורדים
3. השרת לא מופיע ברשימת השרתים
4. תפקידי DarkRP לא מופיעים
5. פקודות ULX לא עובדות
6. פינג גבוה / השהייה
7. השרת קורס בעת ההפעלה
8. לקוחות תקועים על "מוריד" או הצטרפות איטית

---

1. טקסטורות חסרות / משבצות ורודות ושחורות

תיקונים בצד השרת

• שיוך Counter-Strike: Source: ב-GPanel, בדוק אם התוכנית שלך כוללת שיוך תוכן משחקים נוסף. אם זמין, הפעל שיוך CS:S בהגדרות השרת שלך.
• תוסף תוכן CSS: הוסף חבילת תוכן CS:S קהילתית מ-Garry's Mod Workshop לאוסף ה-Workshop של השרת שלך. חפש "Counter-Strike: Source Content" והוסף אותה.
• העלאה ידנית: אם אף אחת מהאפשרויות לעיל אינה זמינה, תוכל להעלות ידנית קבצי תוכן CS:S באמצעות SFTP אל garrysmod/addons/css-content/. ראה את מדריך העלאה באמצעות SFTP להוראות.

תיקון בצד הלקוח

שחקנים שבבעלותם Counter-Strike: Source יכולים לשייך אותו ב-GMod תחת Options → Game Content. זה פותר טקסטורות חסרות בצד שלהם ללא שינויים בשרת.

---

2. תוספי Workshop לא יורדים

אם השרת שלך לא טוען תוספי Workshop בעת ההפעלה, בדוק את הדברים הבאים:

בדיקה	תיקון
מפתח Steam API חסר או לא תקין	ב-GPanel תחת Startup, הגדר את המשתנה STEAM_API_KEY למפתח תקף מ-steamcommunity.com/dev/apikey.
האוסף אינו ציבורי	אוסף ה-Workshop שלך חייב להיות מוגדר כ-Public. אוספים לא רשומים או פרטיים לא יורדו בשרת ייעודי.
מזהה האוסף במקום הלא נכון	הפרמטר +host_workshop_collection חייב להיות בשורת הפקודה של Startup ב-GPanel, לא ב-server.cfg.
שגיאת 403 / שגיאת אימות בקונסולה	מפתח ה-Steam API שלך לא תקין או בוטל. צור מפתח חדש ועדכן אותו ב-GPanel.

---

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

אם השרת שלך פועל אך לא מופיע בדפדפן השרתים של Steam:

• בדוק את sv_lan: ודא ש-sv_lan 0 מוגדר ב-server.cfg. ערך של 1 הופך את השרת ל-LAN בלבד.
• בדוק את ה-GSLT שלך: ודא שטוקן Game Server Login Token תקף מוגדר באמצעות sv_setsteamaccount. טוקן שפג תוקפו או בוטל ימנע רישום ציבורי. צור חדש בכתובת steamcommunity.com/dev/managegameservers.
• המתן מספר דקות: זה יכול לקחת מספר דקות לשרת חדש להופיע ברשימת השרתים הראשית של Steam לאחר ההפעלה הראשונה.
• בדוק עם חיבור ישיר: נסה להתחבר באמצעות IP ישיר תחילה (ראה את הוראות ההתחברות) כדי לוודא שהשרת באמת פועל.

---

4. תפקידי DarkRP לא מופיעים

אם תפקידים מותאמים אישית לא מופיעים בתפריט F4 לאחר הגדרת DarkRP:

• בדוק מיקומי תיקיות: DarkRP עצמו חייב להיות ב-garrysmod/gamemodes/darkrp/, לא ב-addons/. DarkRPModification חייב להיות ב-garrysmod/addons/darkrpmodification/. זו הטעות הנפוצה ביותר.
• בדוק שגיאות Lua: פתח את קונסולת השרת ב-GPanel וחפש שגיאות Lua בזמן ההפעלה. שגיאת תחביר ב-jobs.lua תמנע את טעינת כל התפקידים המותאמים אישית.
• אמת את מצב המשחק: ודא ש-sv_gamemode "darkrp" מוגדר ב-server.cfg והשרת הופעל מחדש במלואו (לא רק החלפת מפה).
• בדוק קידוד קבצים: אם ערכת קבצי Lua ב-Windows, ודא שהם נשמרים כ-UTF-8 ללא BOM. חלק מעורכי הטקסט מוסיפים BOM (סימן סדר בתים) שיכול לשבור ניתוח Lua.

שלבי איתור באגים מהירים

// Run these in the server console to check gamemode status:
lua_run print(engine.ActiveGamemode())
// Should output: darkrp

lua_run PrintTable(RPExtraTeams)
// Should list all custom jobs if DarkRP loaded correctly

---

5. פקודות ULX לא עובדות

אם פקודות ULX מחזירות שגיאות או לא עושות דבר לאחר ההתקנה:

• שני התוספים מותקנים? ULX דורש גם את ULib וגם את ULX. ULX לא יפעל ללא ULib. ודא ששניהם קיימים ב-garrysmod/addons/ או באוסף ה-Workshop שלך.
• בדוק שגיאות בקונסולה: עיין בפלט קונסולת השרת ב-GPanel בזמן ההפעלה לשגיאות המזכירות ULib או ULX.
• אמת את הקצאת המשתמש שלך: הרץ ulx adduser עם שם התצוגה המדויק שלך ב-Steam, או השתמש ב-ulx adduserid "STEAM_0:1:12345678" superadmin עם מזהה Steam שלך לאמינות רבה יותר.
• התנגשויות תוספים: חלק מהתוספים יכולים להתנגש עם ULX. אם פקודות הפסיקו לעבוד לאחר הוספת תוסף חדש, נסה להסיר אותו ולהפעיל מחדש כדי לבודד את הבעיה.

---

6. פינג גבוה / השהייה

אם השרת שלך חווה פינג גבוה או קפיצות השהייה:

• יותר מדי תוספים: אוספי Workshop גדולים מגדילים את השימוש בזיכרון ואת זמן הטעינה. עיין באוסף שלך והסר תוספים שאינם בשימוש פעיל.
• עומס ישויות (DarkRP): שרתי DarkRP עם ישויות רבות שניתן להפעיל (מדפסות כסף, מעבדות סמים וכו') יכולים להיות עתירי מעבד. הגדר מגבלות ישויות סבירות ב-darkrpmodification/lua/darkrp_config/settings.lua.
• קפיצות השהייה של שמירה אוטומטית: אם קפיצות השהייה מתרחשות במרווחים קבועים (כל מספר דקות), ייתכן שזו שמירה אוטומטית של השרת. זו התנהגות רגילה אך ניתן לכוונן את המרווח.
• מספר שחקנים מול תוכנית: ודא שמספר השחקנים לא עולה על מה שמשאבי התוכנית שלך יכולים לטפל. שקול להוריד את maxplayers ב-server.cfg אם אתה קרוב למגבלות המשאבים.
• מורכבות מפה: חלק ממפות הקהילה אינן מותאמות היטב. אם ההשהייה התחילה לאחר החלפת מפה, נסה לחזור למפה פשוטה יותר כדי לבודד את הבעיה.

---

7. השרת קורס בעת ההפעלה

אם השרת שלך קורס או נכשל בהפעלה:

• בדוק את יומן הקונסולה: ב-GPanel, עיין בפלט הקונסולה לפני הקריסה. השורות האחרונות בדרך כלל מציינות את הסיבה.
• תוסף פגום: תוסף שנוסף לאחרונה עשוי לגרום לקריסה. הסר את התוסף האחרון שהוספת ונסה להפעיל מחדש. אם השרת מתחיל, התוסף הוא הבעיה.
• קבצי מצב משחק פגומים: אם אתה משתמש ב-DarkRP או מצב משחק צד שלישי אחר, נסה להתקין אותו מחדש מה-Workshop או מ-GitHub.
• חריגה מהזיכרון: יותר מדי תוספים יכולים לחרוג מהקצאת הזיכרון של התוכנית שלך. בדוק את השימוש במשאבים ב-GPanel ושקול לצמצם את רשימת התוספים.

---

8. לקוחות תקועים על "מוריד" או הצטרפות איטית

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

• הגדר FastDL: ללא FastDL, לקוחות מורידים קבצים ישירות דרך שרת המשחק שזה מאוד איטי. ראה את סעיף FastDL במדריך הגדרת השרת.
• השתמש ב-Workshop עבור תוספים: תוספים שנמסרים באמצעות Workshop יורדים דרך CDN של Steam, שזה מהיר יותר מהורדה ישירה מהשרת. העדף אוספי Workshop על פני העלאת תוספים ידנית כשאפשר.
• צמצם את מספר התוספים: כל תוסף מוסיף לזמן ההורדה של הלקוח. הסר תוספים שאינם חיוניים למשחק בשרת שלך.
• בדוק שימוש ב-resource.AddFile: אם אתה מאלץ לקוחות להוריד קבצים רבים באמצעות resource.lua, עיין ברשימה והסר רשומות עבור קבצים שאינם נחוצים בצד הלקוח.

---

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

• מדריך הגדרת שרת Garry's Mod — Server.cfg, Workshop, מצבי משחק, DarkRP, FastDL
• הגדרת מנהל Garry's Mod (ULX) — התקנת ULX/ULib, פקודות ניהול, קבוצות הרשאות
• כיצד להעלות קבצים באמצעות SFTP
• כיצד למצוא את כתובת ה-IP והפורט של השרת שלך

---