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

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

בעיות מפתח רישיון הן הבעיה הנפוצה ביותר בעת הפעלת שרת RedM חדש. להלן השגיאות האופייניות והפתרונות שלהן:

"Invalid license key" או "Could not authenticate"

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

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

רשימת בדיקה

1. המתינו לפחות 5 דקות. לאחר ההפעלה, השרת צריך זמן להירשם ברשימת שרת ה-Master של Cfx.re. שרתים חדשים עשויים לקחת מספר דקות להופיע.
2. ודאו שמפתח הרישיון תקף. השרת לא ירשם ברשימה ללא מפתח רישיון עובד. בדקו בקונסולת השרת שגיאות הקשורות לרישיון.
3. בדקו הגדרת נקודות קצה. ודאו ש-endpoint_add_tcp ו-endpoint_add_udp ב-server.cfg משתמשים בפורט הנכון:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   הפורט חייב להתאים לזה שהוקצה ב-GPanel.
4. בדקו הגדרות "sv_master1" או רישום. ודאו שלא הגדרתם בטעות את השרת לא להירשם. לא צריך להיות sv_master1 "" בהגדרות שלכם (זה משבית את הרישום ברשימת ה-Master).
5. ודאו שהשרת אכן פועל. בדקו את קונסולת GPanel. אם השרת קרס או נעצר, הוא לא יופיע בדפדפן.
6. נסו חיבור ישיר. גם אם השרת לא בדפדפן, חיבור ישיר אמור לעבוד. בקשו משחקן ללחוץ על F8 ב-RedM ולהקליד:

   connect YOUR_SERVER_IP:PORT

כשלונות בטעינת משאבים

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

"Could not find resource [resource_name]"

• תיקיית המשאב לא קיימת בספריית resources/, או נמצאת במיקום שגוי.
• שם התיקייה לא תואם לשם שנעשה בו שימוש ב-ensure. שמות משאבים רגישים לאותיות גדולות וקטנות.
• תיקון: ודאו שתיקיית המשאב קיימת ושהשם ב-server.cfg תואם בדיוק. השתמשו במנהל הקבצים של GPanel או SFTP לבדיקה.

"Failed to load resource [resource_name]: manifest error"

• לקובץ fxmanifest.lua או __resource.lua של המשאב יש שגיאת תחביר.
• המניפסט מפנה לקבצים שלא קיימים בתיקיית המשאב.
• תיקון: פתחו את קובץ המניפסט ובדקו שגיאות הקלדה, פסיקים חסרים או הפניות לקבצים שלא קיימים. בדקו בקונסולת השרת את מספר השורה הספציפי של השגיאה.

"Error loading script [filename]: [error details]"

• לקובץ Lua, C# או JavaScript בתוך המשאב יש שגיאת תחביר או שגיאת ריצה.
• תיקון: קראו את הודעת השגיאה המלאה בקונסולה. היא תכלול את שם הקובץ ומספר השורה. סיבות נפוצות כוללות:
  • תלויות חסרות (משאב אחר שחייב להיטען קודם)
  • משאב מיושן שאינו תואם לגרסת שרת RedM הנוכחית
  • ערכי הגדרה שגויים בקובץ ההגדרות של המשאב

בעיות בסדר טעינת משאבים

משאבים ב-server.cfg נטענים בסדר שבו הם מופיעים. אם משאב תלוי באחר (למשל, vorp_inventory תלוי ב-vorp_core), התלות חייבת להופיע קודם:

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

בעיות חיבור לקוחות

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

"Connection timed out" / "Failed to connect"

"Connection rejected by server"

• סיסמת שרת: אם sv_password מוגדר, השחקן חייב להזין את הסיסמה הנכונה.
• משאב רשימה לבנה/רשימת אישור: אם יש לכם משאב רשימה לבנה מופעל, השחקן חייב לקבל אישור לפני ההתחברות.
• חסימה: השחקן עשוי להיות חסום. בדקו את רשימת החסימות או מסד הנתונים למזהים שלהם.

הלקוח קורס בעת התחברות

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

שגיאות "Could not download file"

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

בעיות מסד נתונים (MySQL / oxmysql)

רוב מסגרות משחק התפקידים של RedM משתמשות ב-MySQL לאחסון נתונים קבוע. מחבר מסד הנתונים הנפוץ ביותר הוא oxmysql.

שגיאות כשל בחיבור

אם oxmysql (או מחבר MySQL אחר) נכשל בהתחברות, בדקו את הדברים הבאים:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

טבלאות חסרות או שגיאות סכמה

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

1. בדקו את תיעוד המסגרת או מאגר GitHub לקבצי ייבוא SQL (בדרך כלל בשם database.sql, schema.sql או דומה).
2. ייבאו את קובץ ה-SQL למסד הנתונים באמצעות phpMyAdmin או לקוח MySQL.
3. חלק מהמסגרות יוצרות טבלאות אוטומטית בהפעלה הראשונה. ודאו שלמשתמש מסד הנתונים יש הרשאות CREATE TABLE.

בעיות ביצועים

אם שרת ה-RedM שלכם חווה עיכובים, קצב tick נמוך או ביצועים כלליים ירודים:

זיהוי בעיות ביצועים

בדקו את קונסולת השרת לאזהרות ביצועים. שרתי RedM מכוונים לקצב tick של כ-30-64 ticks לשנייה. תוכלו לעקוב אחר זה עם:

• לוח בקרה txAdmin: אם txAdmin זמין, הוא מציג מדדי ביצועי שרת בזמן אמת.
• קונסולת שרת: עקבו אחר אזהרות "slow tick" או "resource hitch".
• פקודת resmon: הקלידו resmon 1 בקונסולת השרת (או קונסולת F8) להפעלת צג המשאבים, המציג זמן CPU לכל משאב.

פתרונות ביצועים נפוצים

שיטות מומלצות

• תזמנו הפעלות מחדש אוטומטיות כל 6-12 שעות באמצעות תכונת התזמון של GPanel או txAdmin לניקוי בעיות זיכרון וישויות מצטברות.
• שמרו על משאבים מעודכנים כדי ליהנות מתיקוני ביצועים ואופטימיזציות.
• הימנעו מפונקציונליות כפולה — אל תריצו שני משאבים שעושים את אותו הדבר (למשל, שתי מערכות מזג אוויר).
• בדקו משאבים חדשים בשרת ניסיון (או עם מספר שחקנים נמוך) לפני פריסה לשרת הראשי.
• עקבו אחר מדדי שרת באופן קבוע דרך GPanel או txAdmin לתפיסת בעיות מוקדם.

טיפים כלליים לפתרון בעיות

1. תמיד קראו את פלט קונסולת השרת. כמעט כל שגיאה כוללת הודעה בקונסולה שמספרת מה השתבש והיכן.
2. הפעילו מחדש את השרת לאחר שינויי הגדרות. רוב השינויים ב-server.cfg דורשים הפעלה מחדש מלאה של השרת כדי להיכנס לתוקף.
3. השביתו משאבים אחד בכל פעם לבידוד בעיות. הפכו שורות ensure ב-server.cfg להערות עם #.
4. שמרו גיבויים של הגדרות עובדות לפני ביצוע שינויים. הורידו את server.cfg ומסד הנתונים שלכם לפני עדכונים גדולים.
5. בדקו פורומים ותיעוד של Cfx.re ב-docs.fivem.net לתיעוד רשמי החל על FiveM ו-RedM כאחד.
6. ודאו תאימות משאבים עם גרסת השרת שלכם. משאבים שנבנו לגרסאות ישנות יותר עשויים לא לעבוד עם builds נוכחיים של RedM.

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

• מדריך הגדרת שרת RedM — מפתחות רישיון, הגדרת server.cfg, ניהול משאבים והתחברות.
• כיצד למצוא את כתובת ה-IP והפורט של השרת
• כיצד להעלות קבצים באמצעות SFTP
• תחילת העבודה עם השרת החדש שלכם

צריכים עזרה?

עדיין חווים בעיות עם שרת ה-RedM שלכם? פתחו פנייה לתמיכה וכללו כל הודעות שגיאה מקונסולת השרת. הצוות שלנו יעזור לכם לאבחן ולפתור את הבעיה.