מדריך זה מכסה פיתוח משאבים, הגדרת מסד נתונים, כלי ניהול, ניהול שחקנים, ניהול כלי רכב ונשק, ופתרון בעיות עבור שרת alt:V שלך ב-Legion Hosting. להגדרת שרת ראשונית, הגדרת server.toml והוראות התחברות, ראה מדריך הגדרת שרת alt:V.
הגדרת מנהל
ל-alt:V אין מערכת מנהל מובנית. פונקציונליות מנהל מיושמת באמצעות משאבים (סקריפטים) שאתה יוצר או מתקין. רוב מצבי המשחק מיישמים מערכת מנהל משלהם עם רמות הרשאה, תפקידים ופקודות מנהל.
גישות נפוצות לניהול
- תפקידים מבוססי מסד נתונים: רוב מסגרות ה-roleplay ומצבי המשחק מאחסנות תפקידי מנהל במסד נתונים. למנהלים מוקצים תפקידים (למשל, מנחה, מנהל, מנהל-על) המעניקים רמות הרשאה שונות.
- מנהלים מבוססי תצורה: הגדרות פשוטות יותר עשויות להשתמש בקובץ תצורה המפרט מזהי Steam או מזהי alt:V של מנהלים עם רמות ההרשאה שלהם.
- פקודות קונסול: לקונסול השרת ב-GPanel תמיד יש גישה מלאה. ניתן לכתוב סקריפטים בצד השרת שמקבלים קלט מהקונסול לפעולות ניהול.
הגדרת משאב מנהל
- בחר או פתח משאב מנהל שמתאים למצב המשחק שלך.
- העלה את המשאב לתיקיית
resources/דרך לשונית Files או SFTP. - הוסף את שם המשאב למערך
resourcesב-server.toml. - הגדר את משאב המנהל (קבע את מזהי Steam/alt:V של המנהלים, רמות הרשאה וכו').
- הפעל מחדש את השרת.
מערכת המשאבים
משאבים הם אבני הבניין המרכזיות של שרתי alt:V. כל משאב הוא מודול עצמאי שיכול להכיל קוד בצד השרת, קוד בצד הלקוח, או שניהם. משאבים נכתבים ב-JavaScript, TypeScript או C#.
מבנה משאב
resources/
my-resource/
resource.toml <-- Resource configuration (required)
server/
index.js <-- Server-side entry point
utils.js <-- Additional server-side files
client/
index.js <-- Client-side entry point (runs in player's GTA V)
shared/
config.js <-- Shared code accessible by both server and clientהגדרת resource.toml
type = "js"
main = "server/index.js"
client-main = "client/index.js"
client-files = ["client/*"]
deps = ["chat"]שדות: type (js או csharp), main (נקודת כניסה בצד השרת), client-main (נקודת כניסה בצד הלקוח, רצה ב-GTA V של השחקן), client-files (קבצים לשליחה ללקוח, תומך ב-globs), deps (משאבים אחרים שצריך לטעון קודם).
התקנת משאבים
להתקנת משאב מוכן מראש בשרת שלך:
- הורד את קבצי המשאב (בדרך כלל תיקייה המכילה
resource.tomlוקבצי סקריפט). - עצור את השרת שלך ב-GPanel.
- העלה את תיקיית המשאב ל-
resources/דרך לשונית Files או SFTP. - הוסף את שם תיקיית המשאב למערך
resourcesב-server.toml:
resources = ["existing-resource", "new-resource"]- אם למשאב יש תלויות, ודא שגם הן מותקנות ומופיעות ברשימה.
- הגדר את המשאב בהתאם לתיעוד שלו (קבצי תצורה, הגדרת מסד נתונים וכו').
- הפעל את השרת. בדוק בקונסול הודעות טעינת משאבים ושגיאות אפשריות.
הסרת משאב
- עצור את השרת.
- הסר את שם המשאב ממערך
resourcesב-server.toml. - ניתן גם למחוק את תיקיית המשאב מ-
resources/. - הפעל את השרת.
deps במשאבים אחרים לפני ההסרה.
הגדרת מסד נתונים
רוב מצבי המשחק ב-alt:V דורשים מסד נתונים לאחסון נתוני שחקנים, כלי רכב, מלאי ומידע קבוע אחר. שתי מערכות מסדי הנתונים הנפוצות ביותר עבור alt:V הן MongoDB ו-MySQL/MariaDB.
MongoDB
MongoDB הוא מסד נתונים מסוג NoSQL המשמש בדרך כלל עם משאבי JavaScript/TypeScript. השתמש בשירות מנוהל כמו MongoDB Atlas (רמה חינמית זמינה) או מופע מאורח עצמית. קבל את מחרוזת החיבור שלך (למשל, mongodb+srv://user:[email protected]/mydb) והגדר אותה בקובץ התצורה של המשאב. משאבי Node.js משתמשים בחבילת mongodb של npm.
MySQL / MariaDB
MySQL משמש בדרך כלל עם משאבי C# וכמה מסגרות JavaScript. השג מסד נתונים משירות מנוהל או מופע מאורח עצמית, הגדר את המשאבים שלך עם פרטי החיבור (host, port, שם משתמש, סיסמה, שם מסד נתונים), והרץ סקריפטי מיגרציה SQL נדרשים.
ניהול שחקנים
ניהול שחקנים ב-alt:V מתבצע דרך המשאבים שלך. פעולות נפוצות כוללות:
זיהוי שחקנים
alt:V מספק מספר מזהים לכל שחקן מחובר:
| מזהה | תיאור |
|---|---|
player.id |
מזהה מספרי זמני שמוקצה לסשן הנוכחי. משתנה בהתחברות מחדש. |
player.socialID |
מזהה Rockstar Social Club של השחקן. קבוע בין סשנים. |
player.hwidHash |
האש של מזהה חומרה. שימושי לאכיפת באנים. |
player.ip |
כתובת ה-IP של השחקן. |
הרחקה וחסימה
יישם פונקציונליות הרחקה וחסימה במשאבים שלך:
import alt from "alt-server";
// Kick a player
player.kick("Reason for kick");
// Ban check on connect (store bans in database)
alt.on("playerConnect", (player) => {
if (isPlayerBanned(player.socialID)) {
player.kick("You are banned from this server.");
}
});socialID ו-hwidHash לאכיפה אמינה.
ניהול כלי רכב ונשק
כלי רכב ונשק מנוהלים דרך סקריפטים בצד השרת. alt:V נותן לך שליטה מלאה על יצירה, שינוי והסרה של כלי רכב ונשק.
יצירת כלי רכב
import alt from "alt-server";
// Spawn a vehicle at a position
const vehicle = new alt.Vehicle(
"sultan", // Vehicle model name
0, 0, 72, // Position (x, y, z)
0, 0, 0 // Rotation (rx, ry, rz)
);
vehicle.numberPlateText = "LEGION";מתן נשק
// Give a weapon to a player
player.giveWeapon(alt.hash("weapon_pistol"), 100, true);
// Remove all weapons
player.removeAllWeapons();שמירת כלי רכב
כברירת מחדל, כלי רכב קיימים רק בזיכרון השרת ואובדים בהפעלה מחדש. כדי לשמור כלי רכב בין הפעלות מחדש, אחסן את הנתונים שלהם (דגם, מיקום, שינויים, בעלים) במסד נתונים וצור אותם מחדש בעת הפעלת השרת.
פתרון בעיות
משאבים לא נטענים
- בדוק ששם המשאב ב-
server.tomlתואם בדיוק לשם התיקייה ב-resources/. - ודא שלמשאב יש קובץ
resource.tomlתקין עם שדותtypeו-mainנכונים. - בדוק בקונסול הודעות שגיאה בעת טעינת המשאב. שגיאות תחביר בסקריפטים ימנעו מהמשאב להתחיל.
- ודא שכל התלויות המפורטות ב-
depsמותקנות ונטענות. - ודא שהמודול הנכון טעון ב-
server.toml(js-moduleל-JavaScript,csharp-moduleל-C#).
שחקנים לא יכולים להתחבר
- ודא שהשרת פועל ומופיע כמקוון ב-GPanel.
- בדוק שהשחקנים משתמשים ב-alt:V launcher, ולא ב-launcher הרגיל של GTA V.
- ודא שענף שרת alt:V תואם למה שלשחקנים יש (release, rc או dev). ענפים שאינם תואמים מונעים חיבורים.
- אם מוגן בסיסמה, ודא שהשחקנים מזינים את הסיסמה הנכונה.
- נסה לגרום לשחקנים להתחבר ישירות עם ה-IP והפורט. ראה כיצד למצוא את ה-IP והפורט של השרת שלך.
קריסות שרת
- בדוק בקונסול הודעות שגיאה לפני הקריסה.
- משאבים פגומים הם הסיבה הנפוצה ביותר לקריסות. השבת משאבים שנוספו לאחרונה כדי לבודד את הבעיה.
- ודא שקבצי השרת שלך מעודכנים. הפעל התקנה מחדש מלשונית Startup אם צריך.
- דליפות זיכרון במשאבים עלולות לגרום לשרת לחרוג מה-RAM לאורך זמן. עקוב אחר גרפי המשאבים ב-GPanel לזיהוי שימוש זיכרון עולה בהתמדה.
בעיות מסד נתונים וקול
- ודא פרטי התחברות ומחרוזות חיבור למסד הנתונים. עבור MongoDB Atlas, הוסף את ה-IP של השרת שלך לרשימה המותרת בהגדרות גישת הרשת.
- בדוק בקונסול הודעות שגיאה בחיבור למסד נתונים.
- צ'אט קולי דורש את הסעיף
[voice]ב-server.tomlבנוסף למשאבים שמיישמים לוגיקת ערוצי קול. התצורה לבדה רק מגדירה את התשתית.
בעיות ביצועים
- בצע פרופיילינג למשאבים שלך לאיתור פעולות יקרות (לולאות כבדות, קריאות מסד נתונים סינכרוניות, יצירת ישויות מוגזמת).
- השתמש ב-
alt.setIntervalו-alt.setTimeoutבמשורה. פעולות כבדות בכל tick הן הגורם הנפוץ ביותר לבעיות ביצועים. - עקוב אחר גרפי המשאבים ב-GPanel לשימוש ב-CPU ו-RAM.
- שקול לשדרג את תוכנית השרת שלך עבור מספר גבוה של שחקנים. פתח פניית תמיכה לדיון באפשרויות.
מאמרים קשורים
- מדריך הגדרת שרת alt:V — הגדרה ראשונית, תצורת server.toml, צ'אט קולי והוראות התחברות
- כיצד למצוא את ה-IP והפורט של השרת שלך
- כיצד להעלות קבצים באמצעות SFTP
- מדריך הפעלת שרת — מדריך כללי להפעלת כל שרת משחק ב-Legion Hosting
צריך עוד עזרה?
אם אתה נתקל בבעיות שלא מכוסות במדריך זה, צוות התמיכה שלנו זמין לסייע. פתח פנייה בכתובת legionhosting.net/submitticket.php עם פרטי השרת שלך, תיאור הבעיה וכל הודעות שגיאה רלוונטיות מקונסול GPanel.
