Bu təlimat Legion Hosting-dəki alt:V serveriniz üçün resurs hazırlanması, verilənlər bazası quraşdırması, admin alətləri, oyunçu idarəetməsi, nəqliyyat və silah idarəetməsi və problemlərin həllini əhatə edir. İlkin server quraşdırması, server.toml konfiqurasiyası və qoşulma təlimatları üçün alt:V Server Quraşdırma Təlimatına baxın.

Admin Quraşdırması

alt:V-nin daxili admin sistemi yoxdur. Admin funksionallığı yaratdığınız və ya quraşdırdığınız resurslar (skriptlər) vasitəsilə həyata keçirilir. Əksər oyun rejimləri öz admin sistemlərini icazə səviyyələri, rollar və admin əmrləri ilə tətbiq edir.

Ümumi Admin Yanaşmaları

• Verilənlər bazası əsaslı rollar: Əksər roleplay və oyun rejimi çərçivələri admin rollarını verilənlər bazasında saxlayır. Adminlərə müxtəlif icazə səviyyələri verən rollar (məs., moderator, admin, superadmin) təyin edilir.
• Konfiqurasiya əsaslı adminlər: Daha sadə quraşdırmalarda icazə səviyyələri ilə admin Steam ID-lərini və ya alt:V ID-lərini siyahılayan konfiqurasiya faylı istifadə edilə bilər.
• Konsol əmrləri: GPanel server konsolu həmişə tam girişə malikdir. Admin əməliyyatları üçün konsol girişini qəbul edən server tərəfi skriptlər yaza bilərsiniz.

Admin Resursunun Quraşdırılması

1. Oyun rejiminizə uyğun admin resursunu seçin və ya hazırlayın.
2. Resursu Files tabı və ya SFTP vasitəsilə resources/ qovluğuna yükləyin.
3. Resurs adını server.toml-dakı resources massivinə əlavə edin.
4. Admin resursunu konfiqurasiya edin (admin Steam/alt:V ID-lərinizi, icazə səviyyələrini və s. təyin edin).
5. Serveri yenidən başladın.

Resurs Sistemi

Resurslar alt:V serverlərinin əsas tikinti bloklarıdır. Hər resurs server tərəfi kodu, müştəri tərəfi kodu və ya hər ikisini ehtiva edə bilən müstəqil bir moduldur. Resurslar JavaScript, TypeScript və ya C# dilində yazılır.

Resurs Strukturu

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 Konfiqurasiyası

type = "js"
main = "server/index.js"
client-main = "client/index.js"
client-files = ["client/*"]
deps = ["chat"]

Sahələr: type (js və ya csharp), main (server tərəfi giriş nöqtəsi), client-main (müştəri tərəfi giriş nöqtəsi, oyunçunun GTA V-sində işləyir), client-files (müştəriyə göndəriləcək fayllar, glob dəstəkləyir), deps (əvvəlcə yüklənəcək digər resurslar).

Resursların Quraşdırılması

Serverinizə hazır resurs quraşdırmaq üçün:

1. Resurs fayllarını yükləyin (adətən resource.toml və skript fayllarını ehtiva edən qovluq).
2. GPanel-dəki serverinizi dayandırın.
3. Resurs qovluğunu Files tabı və ya SFTP vasitəsilə resources/ qovluğuna yükləyin.
4. Resurs qovluğunun adını server.toml-dakı resources massivinə əlavə edin:

resources = ["existing-resource", "new-resource"]

5. Resursun asılılıqları varsa, onların da quraşdırıldığından və siyahıya alındığından əmin olun.
6. Resursu sənədlərinə uyğun konfiqurasiya edin (konfiqurasiya faylları, verilənlər bazası quraşdırması və s.).
7. Serveri başladın. Resursun yüklənmə mesajları və xətalar üçün konsolu yoxlayın.

Resursun Silinməsi

1. Serverinizi dayandırın.
2. server.toml-dakı resources massivindən resurs adını silin.
3. İstəyə bağlı olaraq resources/ qovluğundan resurs qovluğunu silin.
4. Serveri başladın.

Verilənlər Bazası Quraşdırması

Əksər alt:V oyun rejimləri oyunçu məlumatlarını, nəqliyyat vasitələrini, inventarları və digər davamlı məlumatları saxlamaq üçün verilənlər bazası tələb edir. alt:V üçün ən çox istifadə olunan iki verilənlər bazası sistemi MongoDB və MySQL/MariaDB-dir.

MongoDB

MongoDB JavaScript/TypeScript resursları ilə tez-tez istifadə olunan NoSQL sənəd verilənlər bazasıdır. MongoDB Atlas (pulsuz səviyyə mövcuddur) kimi idarə olunan xidmət və ya öz-özünə yerləşdirilmiş nümunə istifadə edin. Qoşulma sətrinizi (məs., mongodb+srv://user:[email protected]/mydb) əldə edin və resursunuzun konfiqurasiya faylında konfiqurasiya edin. Node.js resursları mongodb npm paketindən istifadə edir.

MySQL / MariaDB

MySQL C# resursları və bəzi JavaScript çərçivələri ilə tez-tez istifadə olunur. İdarə olunan xidmət və ya öz-özünə yerləşdirilmiş nümunədən verilənlər bazası əldə edin, resurslarınızı qoşulma məlumatları (host, port, istifadəçi adı, şifrə, verilənlər bazası adı) ilə konfiqurasiya edin və tələb olunan SQL miqrasiya skriptlərini işlədin.

Oyunçu İdarəetməsi

alt:V-də oyunçu idarəetməsi resurslarınız vasitəsilə həyata keçirilir. Ümumi əməliyyatlar bunlardır:

Oyunçuların Müəyyənləşdirilməsi

alt:V hər qoşulmuş oyunçu üçün bir neçə identifikator təmin edir:

Qovma və Banlama

Resurslarınızda qovma və banlama funksionallığını tətbiq edin:

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.");
    }
});

Nəqliyyat və Silah İdarəetməsi

Nəqliyyat vasitələri və silahlar server tərəfi skriptləri vasitəsilə idarə olunur. alt:V nəqliyyat vasitələrinin yaradılması, dəyişdirilməsi və silinməsi üzərində tam nəzarət verir.

Nəqliyyat Vasitələrinin Yaradılması

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";

Silah Vermə

// Give a weapon to a player
player.giveWeapon(alt.hash("weapon_pistol"), 100, true);

// Remove all weapons
player.removeAllWeapons();

Nəqliyyat Davamlılığı

Standart olaraq nəqliyyat vasitələri yalnız server yaddaşında mövcuddur və yenidən başlatmada itir. Nəqliyyat vasitələrini yenidən başlatmalar arasında saxlamaq üçün onların məlumatlarını (model, mövqe, modifikasiyalar, sahib) verilənlər bazasında saxlayın və server başladıqda yenidən yaradın.

Problemlərin Həlli

Resurslar Yüklənmir

• server.toml-dakı resurs adının resources/ qovluğundakı qovluq adı ilə tam uyğun gəldiyini yoxlayın.
• Resursun düzgün type və main sahələri olan etibarlı resource.toml faylına malik olduğunu təsdiqləyin.
• Resurs yüklənmə zamanı xəta mesajları üçün konsolu yoxlayın. Skriptlərdəki sintaksis xətaları resursun başlamasına mane olacaq.
• deps-də siyahılanan bütün asılılıqların quraşdırıldığından və yükləndiyindən əmin olun.
• server.toml-da düzgün modulun yükləndiyini təsdiqləyin (JavaScript üçün js-module, C# üçün csharp-module).

Oyunçular Qoşula Bilmir

• Serverin işlədiyini və GPanel-dəki onlayn göstərildiyini yoxlayın.
• Oyunçuların adi GTA V başladıcısı deyil, alt:V launcher istifadə etdiklərini yoxlayın.
• alt:V server filialının oyunçuların istifadə etdikləri ilə uyğun gəldiyindən əmin olun (release, rc və ya dev). Uyğunsuz filiallar qoşulmanın qarşısını alır.
• Şifrə ilə qorunursa, oyunçuların düzgün şifrəni daxil etdiklərini yoxlayın.
• Oyunçulardan IP və port ilə birbaşa qoşulmağı sınamalarını istəyin. Server IP və Portunuzu Necə Tapmaq Olar baxın.

Server Çökmələri

• Çökmədən əvvəl konsolda xəta mesajlarını yoxlayın.
• Xətalı resurslar çökmələrin ən ümumi səbəbidir. Problemi müəyyənləşdirmək üçün son əlavə edilmiş resursları deaktiv edin.
• Server fayllarınızın yeniləndiyindən əmin olun. Lazım gələrsə Startup tabından yenidən quraşdırmanı işə salın.
• Resurslardakı yaddaş sızmaları zamanla serverin RAM-dan kənara çıxmasına səbəb ola bilər. Daim artan yaddaş istifadəsi üçün GPanel resurs qrafiklərini izləyin.

Verilənlər Bazası və Səs Problemləri

• Verilənlər bazası etimadnamələrini və qoşulma sətirlərini yoxlayın. MongoDB Atlas üçün şəbəkə giriş parametrlərində serverinizin IP-sini ağ siyahıya əlavə edin.
• Konsolda verilənlər bazası qoşulma xəta mesajlarını yoxlayın.
• Səsli söhbət server.toml-da [voice] bölməsini, üstəgəl səs kanalı məntiqini tətbiq edən resursları tələb edir. Konfiqurasiya təkbaşına yalnız infrastrukturu qurur.

Performans Problemləri

• Resurslarınızı bahalı əməliyyatlar üçün profil edin (ağır döngülər, sinxron verilənlər bazası çağırışları, həddindən artıq element yaradılması).
• alt.setInterval və alt.setTimeout-u ehtiyatla istifadə edin. Hər tikdə ağır əməliyyatlar ən çox yayılmış performans problemidir.
• CPU və RAM istifadəsi üçün GPanel resurs qrafiklərini izləyin.
• Yüksək oyunçu sayları üçün server planınızı yüksəltməyi düşünün. Seçimləri müzakirə etmək üçün dəstək sorğusu açın.

Əlaqəli Məqalələr

• alt:V Server Quraşdırma Təlimatı — İlkin quraşdırma, server.toml konfiqurasiyası, səsli söhbət və qoşulma təlimatları
• Server IP və Portunuzu Necə Tapmaq Olar
• SFTP vasitəsilə Faylları Necə Yükləmək Olar
• Server Başlatma Təlimatı — Legion Hosting-də istənilən oyun serverini başlatmaq üçün ümumi təlimat

Əlavə Köməyə Ehtiyacınız Var?

Bu təlimatda əhatə olunmayan problemlər yaşayırsınızsa, dəstək komandamız kömək etməyə hazırdır. Server məlumatlarınız, problemin təsviri və GPanel konsolundan əlaqəli xəta mesajları ilə legionhosting.net/submitticket.php ünvanında sorğu açın.