דרישות מקדימות

דרישות תאימות

מדריך זה מפרט את דרישות התאימות והאינטגרציות הנתמכות עבור הסקריפטים של The A Team.

דרישות OneSync

דרישה	מפרט
גרסת משחק	2372 או גבוה יותר
גרסת שרת	5181 או גבוה יותר
OneSync	✅ נתמך (כולל Infinity)

תמיכה בFrameworks

מסגרת	סטטוס	הערות
ESX	✅ נתמך	Legacy ו-ESX Infinity
QBCore	✅ נתמך	מומלץ להשתמש בגרסה האחרונה
Standalone	✅ נתמך	עבור סקריפטים שאינם תלויים במסגרת

תמיכה במסדי נתונים

שכבת מסד נתונים	סטטוס	הערות
ox_lib	✅ נתמך	מומלץ
oxmysql	✅ נתמך	אפשרות חלופית

מערכות Inventory - חפצים

מלאי	סטטוס	הערות
ox_inventory	✅ נתמך	מומלץ
qs-inventory	✅ נתמך	אינטגרציה מלאה
qb-inventory	✅ נתמך	תמיכה מקורית ב-QB
ESX Regular	✅ נתמך	מלאי ESX Legacy

מערכות התראה - Police

שיגור	סטטוס	הערות
QS-Dispatch	✅ נתמך	אינטגרציה מלאה
RCore-Dispatch	✅ נתמך	אינטגרציה מלאה
CD-Dispatch	✅ נתמך	אינטגרציה מלאה
PS-Dispatch	✅ נתמך	אינטגרציה מלאה
Default Dispatch	✅ נתמך	אפשרות גיבוי

מערכות מטרה - העין

מערכת מטרה	סטטוס	הערות
QTarget	✅ נתמך	אינטגרציה מלאה
QB-Target	✅ נתמך	אינטגרציה מלאה
ox_target	✅ נתמך	מומלץ

אינטגרציות נוספות

מערכות קול
- PMA-Voice
- SaltyChat
- Mumble-VoIP
מערכות טלפון
- QS-Smartphone
- GKS Phone
- QB-Phone
אנטי-צ’יט
- Anti-CK
- VAC
- Screen API

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

בקרת גרסאות

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

שיקולי ביצועים

כאשר משתמשים במערכות משולבות מרובות, שקול את הדברים הבאים:

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

דרישה ל-OneSync

חשוב: בעת הגדרת שרת FiveM שלך, ודא שאתה משתמש ב-OneSync. גרסאות Legacy אינן נתמכות עבור תכונות ועדכונים מודרניים.
למה OneSync? הוא מאפשר מגבלות שחקנים גבוהות יותר, סנכרון דינמי ויכולות סקריפט מתקדמות.
כיצד להפעיל OneSync?
- עדכן את קובץ server.cfg שלך עם השורה הבאה:
```
onesync on
```
- הפעל מחדש את השרת שלך כדי להחיל את השינויים.

ללקוחות: מהו OneSync ולמה זה חשוב?

OneSync הוא מערכת הסנכרון המתקדמת של FiveM המבוססת על קוד הבסיס של GTA: Online, המאפשרת מספר רב יותר של שחקנים (עד 2048!) על שרת אחד. מעבר להגדלת מספר השחקנים, OneSync מציג סנכרון בצד השרת עבור ישויות, משפר יציבות וביצועים תוך מתן סטנדרטים טובים יותר לפיתוח.

יתרונות מרכזיים:
- מגבלות שחקנים גבוהות יותר: חינם עד 48 שחקנים; שדרוג עם FiveM Element Club (מתחיל ברמת Argentum 💿).
- סנכרון מתקדם: מבטיח טיפול טוב יותר בנתונים ומשחק חלק יותר.
- OneSync: Infinity: מאפשר לשרתים לארח עד 2048 שחקנים עם תכונות מתקדמות כמו:
  - מזהי אובייקטים מורחבים לשיפור יכולת ההרחבה.
  - “אזורים ממוקדים” לאופטימיזציה של סקריפטים על ידי הסרת ישויות מיותרות מחוץ לאזורי השחקנים.
  - שיפור ביצועים באמצעות הסרת שחקנים.

מצבי OneSync: מה הם ואיך לבחור

onesync [on/off/legacy] קובע את מצב הסנכרון שהשרת שלך משתמש בו. הנה פירוט של כל אפשרות:

כבוי:
- תיאור: מבטל את המודעות למצב לחלוטין. לקוחות משתמשים במודל הרשת הסטנדרטי של GTA/RAGE peer-to-peer (P2P), כאשר השרת פועל רק כמשדר.
- מקרה שימוש: מתאים לשרתים קטנים או בסיסיים ללא דרישות סנכרון מתקדמות.
מופעל:
- תיאור: מאפשר מודעות למצב מלאה עם ניתוב ישויות הנשלט על ידי השרת. זה מבטיח סנכרון טוב יותר ומשפר את יציבות השרת הכוללת.
- מקרה שימוש: מומלץ לשרתים מודרניים השואפים לביצועים מיטביים וסנכרון חזק.
Legacy:
- תיאור: מספק תאימות לסקריפטים הדורשים שכל השחקנים יתקיימו על כל לקוח. עם זאת, הוא סובל מבעיות ביצועים משמעותיות ותקלות גרפיות.
- מקרה שימוש: השתמש רק אם סקריפטים ישנים דורשים זאת בהחלט. מצב זה אינו מומלץ.

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

טבלת השוואת תכונות

תכונה	OneSync	OneSync: Infinity
מגבלת שחקנים	עד 48 (חינם), ניתן להרחבה עם רמות Patreon	עד 2048 שחקנים
סנכרון ישויות	סנכרון בצד השרת עבור ישויות	סנכרון בצד השרת עם אזורים ממוקדים
אופטימיזציית ביצועים	סטנדרטי	הסרת שחקנים/ישויות מתקדמת
מתאים ל	שרתים קטנים עד בינוניים	קהילות גדולות עם מאות או אלפי שחקנים

מעוניין לשדרג ל-OneSync: Infinity? הצטרף ל-FiveM Element Club כדי לפתוח מגבלות שחקנים גבוהות יותר ולקחת את השרת שלך לשלב הבא. הודע לנו אם תרצה הדרכה על הגדרה או תכונות!

הגדרת sv_enforceGamebuild

הערה: חשוב לציין את גרסת המשחק המתאימה לשרת FiveM שלך כדי להתאים לתכונות או תוכן DLC העדכניים ביותר.
כיצד להגדיר sv_enforceGamebuild?
- הוסף את השורה הבאה לקובץ server.cfg שלך:
```
sv_enforceGameBuild [build_number]
```
  החלף את [build_number] במספר הבנייה הרצוי מהרשימה, למשל, 2545 עבור “The Contract.”
- דוגמה:
```
sv_enforceGameBuild 3258
```
  זה מבטיח תאימות עם “Bottom Dollar Bounties.”
טיפ: תמיד התאם את גרסת המשחק ל-DLC או התכונות שהשרת שלך משתמש בהם כדי להימנע משגיאות.

מספר	כינויים	שם שיווקי
1	-	משחק בסיס ללא DLCs
1604	xm18, christmas2018, mpchristmas2018	Arena War
-	-	The Diamond Casino & Resort
-	-	Diamond Casino Heist
2060	sum, mpsum	Los Santos Summer Special
2189	h4, heist4, mpheist4	Cayo Perico Heist
2372	tuner, mptuner	Los Santos Tuners
2545	security, mpsecurity	The Contract
2612	mpg9ec	-
2699	mpsum2	The Criminal Enterprises
2802	mpchristmas3	Los Santos Drug Wars
2944	mp2023_01	San Andreas Mercenaries
3095	mp2023_02	The Chop Shop
3258	mp2024_01	Bottom Dollar Bounties

מבוא מדריכים