מדריך זה מכסה את כל מה שאתה צריך כדי להפעיל את שרת alt:V שלך ב-Legion Hosting, מהפעלה ראשונה והגדרת server.toml ועד משאבי מצב משחק, הגדרת CDN, צ'אט קולי וכיצד שחקנים מתחברים דרך ה-alt:V launcher. לפיתוח משאבים, הגדרת מסד נתונים וניהול מנהלים, ראה הגדרת מנהל ומשאבים ב-alt:V.
מהו alt:V?
alt:V הוא מוד מולטיפלייר חינמי וקוד פתוח ל-Grand Theft Auto V. הוא מאפשר לשחקנים להתחבר לשרתים מותאמים אישית המריצים מצבי משחק ייחודיים כמו roleplay (RP), deathmatch, מרוצים, freeroam ועוד. השרת מריץ משאבים מותאמים אישית הכתובים ב-JavaScript, TypeScript או C#, ונותן לבעלי שרתים שליטה מלאה על לוגיקת המשחק. שחקנים מתחברים דרך ה-alt:V launcher, אשר מתאים את GTA V לקישוריות מולטיפלייר.
הפעלה ראשונה
כאשר אתה מקבל לראשונה את שרת alt:V שלך, בצע את השלבים הבאים כדי להעלות אותו לאוויר:
- התחבר ל-GPanel ובחר את שרת alt:V שלך.
- נווט ללשונית Startup והגדר את שם השרת, מספר שחקנים מקסימלי ומשתני הפעלה אחרים.
- עבור ללשונית Console ולחץ על Start.
- השרת יוריד את קבצי שרת alt:V בהפעלה הראשונה. זה עשוי לקחת כמה דקות.
- ברגע שהקונסול מציג שהשרת מאזין ומוכן לחיבורים, השרת שלך מקוון.
- כברירת מחדל, השרת מתחיל ללא משאבי מצב משחק. תצטרך להוסיף משאבים כדי ליצור משחקיות. ראה הגדרת מנהל ומשאבים ב-alt:V לפרטים.
משתני הפעלה ב-GPanel
alt:V חושף מספר אפשרויות תצורה כמשתני הפעלה ב-GPanel. נווט ללשונית Startup כדי לשנות אותם. שינויים דורשים הפעלה מחדש של השרת.
| משתנה | ברירת מחדל | תיאור |
|---|---|---|
PASSWORD |
ChangeMe |
סיסמה להצטרפות לשרת. מינימום 6 תווים. |
SERVER_DESC |
A Pterodactyl Hosted Server |
תיאור השרת המוצג בדפדפן שרתי alt:V. |
BUILD |
release |
ענף שרת alt:V: release (יציב), rc (מועמד לשחרור), או dev (פיתוח). |
תצורת שרת (server.toml)
קובץ התצורה הראשי עבור שרתי alt:V הוא server.toml, הממוקם בתיקיית השורש של השרת. ניתן לערוך קובץ זה דרך לשונית Files ב-GPanel או באמצעות SFTP.
דוגמת server.toml
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]הגדרות עיקריות: name (שם תצוגה בדפדפן), host (שמור 0.0.0.0), port (חייב להתאים ל-GPanel), players (מספר מקסימלי), password (ריק לשרת ציבורי), announce (true כדי להופיע בדפדפן), token (טוקן הכרזה מאתר alt:V, נדרש לרישום בדפדפן), gamemode (תווית דפדפן כמו "Roleplay"), modules (מודולי סקריפט: js-module או csharp-module), resources (מערך תיקיות משאבים לטעינה), ו-tags (תגיות סינון בדפדפן).
טוקן הכרזה
כדי שהשרת שלך יופיע בדפדפן שרתי alt:V, אתה צריך טוקן הכרזה מהשרת הראשי של alt:V:
- בקר ב-אתר alt:V והתחבר או צור חשבון.
- נווט לאזור ניהול השרתים וצור טוקן שרת חדש.
- העתק את הטוקן והדבק אותו בשדה
tokenב-server.tomlשלך. - ודא ש-
announce = trueבתצורה שלך. - הפעל מחדש את השרת. הוא אמור כעת להופיע בדפדפן הציבורי.
server.toml שלך.
משאבי מצב משחק
שרתי alt:V מופעלים על ידי משאבים — סקריפטים שמגדירים את כל לוגיקת המשחקיות. ללא משאבים, לשרת אין פונקציונליות מותאמת אישית. משאבים ממוקמים בתיקיית resources/.
מבנה משאב
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)טעינת משאבים
הוסף שמות משאבים למערך resources ב-server.toml כדי לטעון אותם בהפעלה:
resources = ["chat", "freeroam", "spawn"]לכל משאב חייב להיות קובץ resource.toml בתיקייה שלו שמגדיר את הסוג, התלויות ונקודות הכניסה של הסקריפטים. לפרטים על יצירה וניהול משאבים, ראה הגדרת מנהל ומשאבים ב-alt:V.
הגדרת CDN
alt:V משתמש במנגנון CDN להגשת קבצים בצד הלקוח (מודלים, טקסטורות, סקריפטים) לשחקנים המתחברים. CDN המובנה מגיש קבצים ישירות מהשרת ללא צורך בתצורה נוספת — זוהי ברירת המחדל ועובד היטב עבור רוב השרתים. עבור שרתים בקנה מידה גדול עם נכסים מותאמים אישית רבים, ניתן להגדיר CDN חיצוני על ידי העלאת קבצי לקוח לשרת אינטרנט והגדרת כתובת ה-CDN בתצורת המשאב, מה שמפחית את שימוש רוחב הפס של שרת המשחק.
צ'אט קולי
alt:V כולל מערכת צ'אט קולי מובנית המאפשרת תקשורת קולית מיקומית (תלת-ממדית) בין שחקנים. צ'אט קולי מופעל ומוגדר ב-server.toml.
תצורת קול
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0ה-bitrate שולט באיכות הקול (64000 הוא סטנדרטי). שדות ה-external* מגדירים שרת קול חיצוני — השאר אותם ריקים/אפס כדי להשתמש בשרת הקול המובנה, מה שמומלץ לרוב ההגדרות. אפשרות שרת הקול החיצוני נדרשת רק לתצורות מתקדמות שבהן עיבוד הקול מועבר למכונה נפרדת.
כיצד שחקנים מתחברים
שחקנים מתחברים לשרתי alt:V דרך ה-alt:V launcher, לא ישירות דרך GTA V.
דרך דפדפן השרתים
- הורד והתקן את ה-alt:V launcher מ-altvmp.com.
- הפעל את ה-alt:V launcher. הוא יזהה ויאמת את התקנת GTA V.
- מה-launcher, עיין ב-Server Browser.
- חפש את השרת שלך לפי שם או השתמש במסננים (מצב משחק, תגיות, מספר שחקנים).
- לחץ על השרת שלך ובחר Connect.
- אם לשרת יש סיסמה, השחקן יתבקש להזין אותה.
- GTA V יופעל עם מוד המולטיפלייר alt:V ויתחבר לשרת שלך.
דרך חיבור ישיר
- ב-alt:V launcher, בחר Direct Connect.
- הזן את כתובת ה-IP והפורט של השרת שלך בפורמט
IP:PORT(למשל,192.168.1.1:7788). - לחץ על Connect.
למציאת כתובת ה-IP והפורט של השרת שלך, ראה כיצד למצוא את ה-IP והפורט של השרת שלך.
announce = true ב-server.toml שלך ושיש לך טוקן הכרזה תקין. ייתכן שייקח לשרת דקה להירשם לאחר ההפעלה. בדוק בקונסול שגיאות חיבור לשרת הראשי. שים לב שהפורט שלך מוקצה באופן אקראי אלא אם יש לך IP פרטי -- בדוק ב-GPanel את הערך הנכון.
מקסימום שחקנים וביצועים
שרתי alt:V יכולים לתמוך במספר גבוה של שחקנים, אך הביצועים תלויים מאוד במשאבים ובתוכנית השרת שלך:
- 32–128 שחקנים: טווח נפוץ עבור רוב השרתים. מצבי משחק פשוטים רצים בצורה חלקה במספרים גבוהים יותר.
- 128–512+ שחקנים: אפשרי עבור שרתים מותאמים עם משאבים יעילים. דורש יותר CPU ו-RAM.
- יעילות משאבים: סקריפטים שאינם מותאמים היטב הם הסיבה העיקרית לבעיות ביצועים. סקריפטים בצד השרת שמריצים פעולות כבדות בכל tick או מחזיקים מבני נתונים גדולים בזיכרון עלולים ליצור צוואר בקבוק בשרת.
- שאילתות מסד נתונים: מצבי משחק המשתמשים במסדי נתונים (MySQL, MongoDB) צריכים להשתמש בשאילתות אסינכרוניות כדי להימנע מחסימת ה-thread הראשי.
מאמרים קשורים
- הגדרת מנהל ומשאבים ב-alt:V — פיתוח משאבים, הגדרת מסד נתונים, כלי ניהול ופתרון בעיות
- כיצד למצוא את ה-IP והפורט של השרת שלך
- כיצד להעלות קבצים באמצעות SFTP
- מדריך הפעלת שרת — מדריך כללי להפעלת כל שרת משחק ב-Legion Hosting
צריך עוד עזרה?
אם אתה נתקל בבעיות שלא מכוסות במדריך זה, צוות התמיכה שלנו זמין לסייע. פתח פנייה בכתובת legionhosting.net/submitticket.php עם פרטי השרת שלך ותיאור הבעיה.
