Tämä opas kattaa resurssien kehityksen, tietokannan asennuksen, järjestelmänvalvojan työkalut, pelaajien hallinnan, ajoneuvojen ja aseiden hallinnan sekä vianmäärityksen alt:V-palvelimellesi Legion Hostingissa. Palvelimen alkuasennusta, server.toml-konfiguraatiota ja yhteysohjeita varten katso alt:V-palvelimen asennusopas.

---

Järjestelmänvalvojan asennus

alt:V:llä ei ole sisäänrakennettua järjestelmänvalvojajärjestelmää. Järjestelmänvalvojan toiminnallisuus toteutetaan resurssien (skriptien) kautta, jotka luot tai asennat. Useimmat pelimoodit toteuttavat oman järjestelmänvalvojajärjestelmänsä, jossa on käyttöoikeustasoja, rooleja ja järjestelmänvalvojan komentoja.

Yleisiä järjestelmänvalvojan lähestymistapoja

• Tietokantapohjaiset roolit: Useimmat roolipeli- ja pelimoodikehykset tallentavat järjestelmänvalvojan roolit tietokantaan. Järjestelmänvalvojille määritetään rooleja (esim. moderaattori, järjestelmänvalvoja, pääjärjestelmänvalvoja), jotka myöntävät erilaisia käyttöoikeustasoja.
• Konfiguraatiopohjaiset järjestelmänvalvojat: Yksinkertaisemmat asennukset voivat käyttää konfiguraatiotiedostoa, jossa luetellaan järjestelmänvalvojien Steam-tunnukset tai alt:V-tunnukset ja heidän käyttöoikeustasonsa.
• Konsolikomennot: GPanelin palvelinkonsolilla on aina täysi pääsy. Voit kirjoittaa palvelinpuolen skriptejä, jotka hyväksyvät konsolin syötteitä järjestelmänvalvojan toimintoja varten.

Järjestelmänvalvojan resurssin asentaminen

1. Valitse tai kehitä järjestelmänvalvojan resurssi, joka sopii pelimoodiisi.
2. Lataa resurssi resources/-hakemistoon Files-välilehden tai SFTP:n kautta.
3. Lisää resurssin nimi resources-taulukkoon tiedostossa server.toml.
4. Konfiguroi järjestelmänvalvojan resurssi (aseta järjestelmänvalvojien Steam-/alt:V-tunnukset, käyttöoikeustasot jne.).
5. Käynnistä palvelin uudelleen.

---

Resurssijärjestelmä

Resurssit ovat alt:V-palvelimien ydinrakennuspalikoita. Jokainen resurssi on itsenäinen moduuli, joka voi sisältää palvelinpuolen koodia, asiakaspuolen koodia tai molempia. Resurssit kirjoitetaan JavaScriptillä, TypeScriptillä tai C#-kielellä.

Resurssin rakenne

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-konfiguraatio

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

Kentät: type (js tai csharp), main (palvelinpuolen aloituskohta), client-main (asiakaspuolen aloituskohta, suoritetaan pelaajan GTA V:ssä), client-files (asiakkaalle lähetettävät tiedostot, tukee glob-muotoa), deps (muut resurssit, jotka ladataan ensin).

---

Resurssien asentaminen

Asentaaksesi valmiin resurssin palvelimellesi:

1. Lataa resurssitiedostot (yleensä kansio, joka sisältää resource.toml-tiedoston ja skriptitiedostoja).
2. Pysäytä palvelimesi GPanelissa.
3. Lataa resurssikansio resources/-hakemistoon Files-välilehden tai SFTP:n kautta.
4. Lisää resurssikansion nimi resources-taulukkoon tiedostossa server.toml:

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

5. Jos resurssilla on riippuvuuksia, varmista, että ne on myös asennettu ja lueteltu.
6. Konfiguroi resurssi sen dokumentaation mukaan (konfiguraatiotiedostot, tietokannan asennus jne.).
7. Käynnistä palvelin. Tarkista konsoli resurssien lataussanomien ja virheiden varalta.

Resurssin poistaminen

1. Pysäytä palvelimesi.
2. Poista resurssin nimi resources-taulukosta tiedostossa server.toml.
3. Voit halutessasi poistaa resurssikansion resources/-hakemistosta.
4. Käynnistä palvelin.

---

Tietokannan asennus

Useimmat alt:V-pelimoodit vaativat tietokannan tallentaakseen pelaajien tietoja, ajoneuvoja, inventaarioita ja muita pysyviä tietoja. Kaksi yleisintä alt:V-tietokantajärjestelmää ovat MongoDB ja MySQL/MariaDB.

MongoDB

MongoDB on NoSQL-dokumenttitietokanta, jota käytetään yleisesti JavaScript-/TypeScript-resurssien kanssa. Käytä hallittua palvelua, kuten MongoDB Atlas (ilmainen taso saatavilla) tai itse isännöityä instanssia. Hanki yhteysmerkkijonosi (esim. mongodb+srv://user:[email protected]/mydb) ja konfiguroi se resurssisi konfiguraatiotiedostossa. Node.js-resurssit käyttävät mongodb npm-pakettia.

MySQL / MariaDB

MySQL:ää käytetään yleisesti C#-resurssien ja joidenkin JavaScript-kehysten kanssa. Hanki tietokanta hallitusta palvelusta tai itse isännöidystä instanssista, konfiguroi resurssisi yhteystiedoilla (isäntä, portti, käyttäjänimi, salasana, tietokannan nimi) ja suorita tarvittavat SQL-migraatioscriptit.

---

Pelaajien hallinta

Pelaajien hallinta alt:V:ssä tehdään resurssiesi kautta. Yleisiä toimintoja ovat:

Pelaajien tunnistaminen

alt:V tarjoaa useita tunnisteita kullekin yhdistetylle pelaajalle:

Potkiminen ja kieltäminen

Toteuta potkimis- ja kieltämistoiminnot resurssissasi:

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

---

Ajoneuvojen ja aseiden hallinta

Ajoneuvoja ja aseita hallitaan palvelinpuolen skriptien kautta. alt:V antaa sinulle täyden hallinnan ajoneuvojen ja aseiden spawnaamisesta, muokkaamisesta ja poistamisesta.

Ajoneuvojen spawnaaminen

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

Aseiden antaminen

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

// Remove all weapons
player.removeAllWeapons();

Ajoneuvojen pysyvyys

Oletuksena ajoneuvot ovat olemassa vain palvelimen muistissa ja häviävät uudelleenkäynnistyksessä. Säilyttääksesi ajoneuvot uudelleenkäynnistysten välillä, tallenna niiden tiedot (malli, sijainti, muutokset, omistaja) tietokantaan ja luo ne uudelleen palvelimen käynnistyksessä.

---

Vianmääritys

Resurssit eivät lataudu

• Tarkista, että resurssin nimi tiedostossa server.toml vastaa täsmälleen kansion nimeä hakemistossa resources/.
• Varmista, että resurssilla on kelvollinen resource.toml-tiedosto, jossa on oikeat type- ja main-kentät.
• Tarkista konsoli virheilmoitusten varalta resurssien lataamisen aikana. Syntaksivirheet skripteissä estävät resurssin käynnistymisen.
• Varmista, että kaikki deps-kentässä luetellut riippuvuudet on asennettu ja ladattu.
• Varmista, että oikea moduuli on ladattu tiedostossa server.toml (js-module JavaScriptille, csharp-module C#:lle).

Pelaajat eivät voi yhdistää

• Varmista, että palvelin on käynnissä ja näkyy online-tilassa GPanelissa.
• Tarkista, että pelaajat käyttävät alt:V-käynnistyssovellusta, eivät tavallista GTA V -käynnistyssovellusta.
• Varmista, että alt:V-palvelinhaara vastaa pelaajien käyttämää (release, rc tai dev). Yhteensopimattomat haarat estävät yhteydet.
• Jos salasanasuojattu, varmista, että pelaajat syöttävät oikean salasanan.
• Pyydä pelaajia kokeilemaan suoraa yhteyttä IP:llä ja portilla. Katso Palvelimen IP:n ja portin löytäminen.

Palvelimen kaatumiset

• Tarkista konsoli virheilmoitusten varalta ennen kaatumista.
• Vialliset resurssit ovat yleisin kaatumisten syy. Poista käytöstä äskettäin lisätyt resurssit ongelman eristämiseksi.
• Varmista, että palvelintiedostosi ovat ajan tasalla. Käynnistä uudelleenasennus Startup-välilehdeltä tarvittaessa.
• Resurssien muistivuodot voivat aiheuttaa palvelimen RAM-muistin loppumisen ajan myötä. Seuraa GPanelin resurssikuvaajia jatkuvasti kasvavan muistinkäytön varalta.

Tietokanta- ja ääniongelmat

• Varmista tietokannan tunnukset ja yhteysmerkkijonot. MongoDB Atlasille lisää palvelimesi IP verkkokäyttöasetusten valkoiselle listalle.
• Tarkista konsoli tietokannan yhteyden virheilmoitusten varalta.
• Äänichat vaatii [voice]-osion tiedostossa server.toml sekä resurssit, jotka toteuttavat äänikanavan logiikan. Pelkkä konfiguraatio asettaa vain infrastruktuurin.

Suorituskykyongelmat

• Profiloi resurssisi kalliiden operaatioiden varalta (raskaat silmukat, synkroniset tietokantakutsut, liiallinen entiteettien luominen).
• Käytä alt.setInterval- ja alt.setTimeout-funktioita säästeliäästi. Raskaat per-tick-operaatiot ovat yleisin suorituskyvyn tappaja.
• Seuraa GPanelin resurssikuvaajia CPU- ja RAM-käytön varalta.
• Harkitse palvelinpaketin päivittämistä suuria pelaajamääriä varten. Avaa tukipyyntö vaihtoehtojen pohtimiseksi.

---

Aiheeseen liittyvät artikkelit

• alt:V-palvelimen asennusopas — Alkuasennus, server.toml-konfiguraatio, äänichat ja yhteysohjeet
• Palvelimen IP:n ja portin löytäminen
• Tiedostojen lataaminen SFTP:n kautta
• Palvelimen käynnistysopas — Yleinen opas minkä tahansa pelipalvelimen käynnistämiseen Legion Hostingissa

---

Tarvitsetko lisäapua?

Jos koet ongelmia, joita ei käsitellä tässä oppaassa, tukitiimimme on käytettävissä auttamaan. Avaa tukipyyntö osoitteessa legionhosting.net/submitticket.php palvelimesi tiedoilla, ongelman kuvauksella ja mahdollisilla virheilmoituksilla GPanelin konsolista.