Овој водич ги покрива развојот на ресурси, поставувањето на бази на податоци, админ алатките, управувањето со играчите, управувањето со возила и оружја и решавањето проблеми за вашиот alt:V сервер на Legion Hosting. За почетно поставување на серверот, конфигурација на server.toml и упатства за поврзување, погледнете Водич за поставување на alt:V сервер.

---

Поставување на админ

alt:V нема вграден админ систем. Админ функционалноста се имплементира преку ресурси (скрипти) што ги создавате или инсталирате. Повеќето gamemode-ови имплементираат свој сопствен админ систем со нивоа на дозволи, улоги и админ команди.

Вообичаени админ пристапи

• Улоги поддржани од база на податоци: Повеќето roleplay и gamemode фрејмворци ги складираат админ улогите во база на податоци. На админите им се доделуваат улоги (на пр., moderator, admin, superadmin) што доделуваат различни нивоа на дозволи.
• Админи базирани на конфигурација: Поедноставните поставки можат да користат конфигурациска датотека што наведува админ Steam ID-а или alt:V ID-а со нивните нивоа на дозволи.
• Конзолни команди: Серверската конзола на GPanel секогаш има целосен пристап. Можете да пишувате серверски скрипти што прифаќаат конзолен влез за админ операции.

Поставување на админ ресурс

1. Изберете или развијте админ ресурс што одговара на вашиот gamemode.
2. Поставете го ресурсот во resources/ директориумот преку картичката Files или SFTP.
3. Додадете го името на ресурсот во resources низата во server.toml.
4. Конфигурирајте го админ ресурсот (поставете ги вашите админ Steam/alt:V ID-а, нивоа на дозволи итн.).
5. Рестартирајте го серверот.

---

Систем на ресурси

Ресурсите се основните градбени блокови на 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 (други ресурси за прво вчитување).

---

Инсталирање на ресурси

За да инсталирате претходно изграден ресурс на вашиот сервер:

1. Преземете ги датотеките на ресурсот (обично папка што содржи resource.toml и скрипт датотеки).
2. Запрете го вашиот сервер во GPanel.
3. Поставете ја папката на ресурсот во resources/ преку картичката Files или SFTP.
4. Додадете го името на папката на ресурсот во resources низата во server.toml:

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

5. Ако ресурсот има зависности, осигурете се дека и тие се инсталирани и наведени.
6. Конфигурирајте го ресурсот според неговата документација (конфигурациски датотеки, поставување на база на податоци итн.).
7. Стартувајте го серверот. Проверете ја конзолата за пораки за вчитување ресурси и какви било грешки.

Отстранување на ресурс

1. Запрете го вашиот сервер.
2. Отстранете го името на ресурсот од resources низата во server.toml.
3. По избор избришете ја папката на ресурсот од resources/.
4. Стартувајте го серверот.

---

Поставување на база на податоци

Повеќето alt:V gamemode-ови бараат база на податоци за складирање на податоци за играчите, возила, инвентари и други постојани информации. Двата најчести системи за бази на податоци за 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, username, password, database name) и извршете какви било потребни SQL миграциски скрипти.

---

Управување со играчите

Управувањето со играчите во alt:V се справува преку вашите ресурси. Вообичаените операции вклучуваат:

Идентификување на играчите

alt:V обезбедува неколку идентификатори за секој поврзан играч:

Исфрлање и забранување

Имплементирајте функционалност за исфрлање и забранување во вашите ресурси:

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

---

Управување со возила и оружја

Возилата и оружјата се управуваат преку серверски скрипти. 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, не редовниот GTA V launcher.
• Осигурете се дека alt:V серверската гранка се совпаѓа со тоа што го имаат играчите (release, rc или dev). Несовпаднати гранки спречуваат поврзувања.
• Ако е заштитен со лозинка, верификувајте дека играчите ја внесуваат точната лозинка.
• Нека играчите се обидат со директно поврзување со IP и портата. Погледнете Како да го пронајдете IP и портата на вашиот сервер.

Паѓања на серверот

• Проверете ја конзолата за пораки за грешки пред паѓањето.
• Неисправните ресурси се најчестата причина за паѓања. Оневозможете ги неодамна додадените ресурси за да го изолирате проблемот.
• Осигурете се дека вашите серверски датотеки се ажурирани. Активирајте реинсталација од картичката Startup ако е потребно.
• Истекувањата на меморија во ресурсите можат да предизвикаат серверот да остане без RAM со текот на времето. Следете ги графиконите за ресурси во GPanel за постојано зголемување на употребата на меморија.

Проблеми со база на податоци и глас

• Верификувајте ги акредитивите за базата на податоци и конекциските низи. За MongoDB Atlas, ставете го IP на вашиот сервер на белата листа во поставките за пристап до мрежа.
• Проверете ја конзолата за пораки за грешки при поврзување со базата на податоци.
• Гласовниот чет бара [voice] секцијата во server.toml плус ресурси што имплементираат логика на гласовни канали. Конфигурацијата сама по себе само поставува инфраструктура.

Проблеми со перформанси

• Профилирајте ги вашите ресурси за скапи операции (тешки јамки, синхрони повици на база на податоци, прекумерно создавање на ентитети).
• Користете alt.setInterval и alt.setTimeout штедливо. Тешките операции по тик се најчестиот убиец на перформансите.
• Следете ги графиконите за ресурси во GPanel за употреба на CPU и RAM.
• Размислете за надградба на вашиот серверски план за голем број играчи. Отворете тикет за поддршка за да разговарате за опциите.

---

Поврзани статии

• Водич за поставување на alt:V сервер — Почетно поставување, конфигурација на server.toml, гласовен чет и упатства за поврзување
• Како да го пронајдете IP и портата на вашиот сервер
• Како да поставувате датотеки преку SFTP
• Водич за стартување на серверот — Општ водич за стартување на кој било игра сервер на Legion Hosting

---

Потребна ви е дополнителна помош?

Ако доживувате проблеми што не се покриени во овој водич, нашиот тим за поддршка е достапен да помогне. Отворете тикет на legionhosting.net/submitticket.php со деталите за вашиот сервер, опис на проблемот и какви било релевантни пораки за грешки од конзолата на GPanel.