מדריך זה מכסה כיצד להתקין משאבים (סקריפטים) בשרת ה-FiveM שלך, להגדיר מסד נתונים MySQL עבור מסגרות כמו ESX או QBCore, ולהבין את סדר טעינת המשאבים. אם טרם השלמת את הגדרת השרת הראשונית, התחל עם מדריך הגדרת שרת FiveM תחילה.

התקנת משאבים וסקריפטים

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

כיצד להתקין משאב

1. הורד את המשאב מהמקור שלו (GitHub, פורומי Cfx.re, Tebex וכו').
2. חלץ את תיקיית המשאב מקובץ ה-ZIP/ארכיון במידת הצורך.
3. העלה את תיקיית המשאב לתיקיית resources/ של השרת שלך באמצעות לשונית Files ב-GPanel או דרך SFTP.
4. פתח את server.cfg והוסף שורת ensure למשאב:

# Add your custom resources
ensure my-new-resource

5. הפעל מחדש את השרת מ-GPanel או TXAdmin כדי שהמשאב ייטען.

קבצי מניפסט של משאבים

כל משאב תקין חייב להכיל קובץ מניפסט. משאבים מודרניים משתמשים ב-fxmanifest.lua, בעוד שישנים יותר משתמשים ב-__resource.lua. אם תיקיית משאב שהורדת לא מכילה אף אחד מקבצים אלה, המשאב לא ייטען. חלק מההורדות מכניסות את תיקיית המשאב בפועל בתוך תיקייה חיצונית — וודא שהתיקייה שאתה מניח ב-resources/ היא זו שמכילה את המניפסט.

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

משאבים נטענים בסדר שבו הם מופיעים ב-server.cfg. אם משאב תלוי באחר (לדוגמה, סקריפט משרה שתלוי במסגרת כמו ESX או QBCore), וודא שהתלות מופיעה לפני המשאב שזקוק לה:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

ארגון משאבים עם תיקיות קטגוריה

ניתן לארגן משאבים בתיקיות משנה בתוך תיקיית resources/. השתמש בסימון סוגריים ב-server.cfg כדי לטעון תיקיית קטגוריה שלמה:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

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

טעינת משאבים חמה דרך TXAdmin

לא תמיד יש צורך בהפעלה מחדש מלאה של השרת כדי לטעון משאב חדש. TXAdmin יכול להפעיל, לעצור ולהפעיל מחדש משאבים בודדים מדף ה-Resources שלו. לאחר העלאת משאב חדש והוספת שורת ensure שלו, ניתן להריץ את הפקודה הבאה בקונסול החי של TXAdmin:

refresh
ensure my-new-resource

הפקודה refresh מורה לשרת לסרוק מחדש את תיקיית resources/ לחיפוש ערכים חדשים.

הגדרת מסד נתונים (MySQL / MariaDB)

מסגרות ומשאבים רבים של FiveM (כמו ESX, QBCore או vRP) דורשים מסד נתונים MySQL או MariaDB. Legion Hosting מספקת פרטי גישה למסד נתונים עם השרת שלך.

מציאת פרטי הגישה למסד הנתונים

1. ב-GPanel, עבור ללשונית Databases.
2. אם לא קיים עדיין מסד נתונים, לחץ על New Database כדי ליצור אחד.
3. רשום את הפרטים הבאים:
   • כתובת מסד הנתונים (כתובת ופורט)
   • שם מסד הנתונים
   • שם משתמש
   • סיסמה (לחץ על סמל העין כדי לחשוף אותה)

הגדרת חיבור מסד הנתונים

פרטי חיבור מסד הנתונים מוגדרים ב-server.cfg באמצעות מחרוזת חיבור. הפורמט המדויק תלוי באיזה משאב MySQL אתה משתמש, אך הפורמט הנפוץ ביותר הוא:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

החלף את מחזיקי המקום בפרטי הגישה שלך מלשונית Databases. לדוגמה:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

בחירת משאב MySQL

בכל משאב MySQL שתבחר, הוא חייב להיטען ב-server.cfg לפני כל משאב שתלוי בו:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

יסודות המסגרת

מסגרת מספקת את מערכות המשחק הליבתיות שמשאבים אחרים בונים עליהן — דברים כמו זהות שחקן, כסף, מלאי, משרות ורכבים. שתי המסגרות הפופולריות ביותר ב-FiveM הן:

רוב המסגרות מותקנות דרך מערכת המתכונים של TXAdmin במהלך ההגדרה הראשונית. אם בחרת במתכון כמו "QBCore" או "ESX" במהלך הגדרת TXAdmin, המסגרת והתלויות המרכזיות שלה כבר מותקנות. אם עליך להתקין מסגרת ידנית, עקוב אחר התיעוד הרשמי שלה:

• תיעוד ESX
• תיעוד QBCore

קבלת עזרה

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

1. בדוק את התיעוד של המשאב או דף ה-GitHub שלו להוראות התקנה ובעיות ידועות.
2. עיין בקונסול GPanel או ביומני TXAdmin לחיפוש הודעות שגיאה.
3. פתח פנייה לתמיכה בכתובת https://legionhosting.net/submitticket.php עם הודעות השגיאה שלך ושם המשאב שאתה מנסה להתקין.

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

• מדריך הגדרת שרת FiveM
• פתרון בעיות FiveM
• כיצד להעלות קבצים באמצעות SFTP
• כיצד למצוא את כתובת ה-IP והפורט של השרת שלך