Tämä opas kattaa kaiken, mitä tarvitset saadaksesi alt:V-palvelimesi käyntiin Legion Hostingissa, ensikäynnistyksestä ja server.toml-konfiguraatiosta pelimoodien resursseihin, CDN-asetuksiin, äänichatiin ja siihen, miten pelaajat yhdistävät alt:V-käynnistyssovelluksen kautta. Resurssien kehitystä, tietokannan asennusta ja järjestelmänvalvojan hallintaa varten katso alt:V järjestelmänvalvojan ja resurssien asennus.

Mikä on alt:V?

alt:V on ilmainen, avoimen lähdekoodin moninpelimuokkaus Grand Theft Auto V:lle. Se mahdollistaa pelaajien yhdistämisen mukautettuihin palvelimiin, joissa on ainutlaatuisia pelimoodeja, kuten roolipeli (RP), deathmatch, kilpailu, freeroam ja muut. Palvelin suorittaa mukautettuja resursseja, jotka on kirjoitettu JavaScriptillä, TypeScriptillä tai C#:lla, antaen palvelimen omistajille täyden hallinnan pelin logiikasta. Pelaajat yhdistävät alt:V-käynnistyssovelluksen kautta, joka muokkaa GTA V:tä moninpeliyhteyttä varten.

Ensimmäinen käynnistys

Kun saat ensimmäisen kerran alt:V-palvelimesi, seuraa näitä vaiheita saadaksesi sen verkkoon:

1. Kirjaudu sisään GPaneliin ja valitse alt:V-palvelimesi.
2. Siirry Startup-välilehdelle ja konfiguroi palvelimen nimi, maksimi pelaajamäärä ja muut käynnistysmuuttujat.
3. Mene Console-välilehdelle ja klikkaa Start.
4. Palvelin lataa alt:V-palvelintiedostot ensimmäisellä käynnistyksellä. Tämä voi kestää muutaman minuutin.
5. Kun konsoli näyttää, että palvelin kuuntelee ja on valmis yhteyksiin, palvelimesi on verkossa.
6. Oletuksena palvelin käynnistyy ilman pelimoodiresursseja. Sinun on lisättävä resursseja luodaksesi pelin. Katso lisätietoja kohdasta alt:V järjestelmänvalvojan ja resurssien asennus.

GPanelin käynnistysmuuttujat

alt:V tarjoaa useita konfiguraatiovaihtoehtoja käynnistysmuuttujina GPanelissa. Siirry Startup-välilehdelle muokataksesi näitä. Muutokset vaativat palvelimen uudelleenkäynnistyksen.

Palvelimen konfiguraatio (server.toml)

alt:V-palvelimien ensisijainen konfiguraatiotiedosto on server.toml, joka sijaitsee palvelimen juurihakemistossa. Voit muokata tätä tiedostoa GPanelin Files-välilehden kautta tai SFTP:n kautta.

Esimerkki 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"]

Tärkeimmät asetukset: name (selaimessa näytettävä nimi), host (säilytä 0.0.0.0), port (täytyy vastata GPaneliä), players (maksimimäärä), password (tyhjä julkiselle), announce (true näkyäkseen selaimessa), token (ilmoitustunniste alt:V-sivustolta, vaaditaan selaimessa listautumiseen), gamemode (selaimen tunnus, kuten "Roleplay"), modules (skriptimoduulit: js-module tai csharp-module), resources (ladattavien resurssikansioiden taulukko) ja tags (selaimen suodatintunnisteet).

Ilmoitustunniste

Jotta palvelimesi näkyisi alt:V-palvelinselaimessa, tarvitset ilmoitustunnisteen alt:V-pääpalvelimelta:

1. Käy alt:V-sivustolla ja kirjaudu sisään tai luo tili.
2. Siirry palvelinhallintaosioon ja luo uusi palvelintunniste.
3. Kopioi tunniste ja liitä se token-kenttään tiedostossa server.toml.
4. Varmista, että announce = true on konfiguraatiossasi.
5. Käynnistä palvelin uudelleen. Sen pitäisi nyt näkyä julkisessa selaimessa.

Pelimoodin resurssit

alt:V-palvelimia ohjataan resurssien avulla — skriptien, jotka määrittävät kaiken pelin logiikan. Ilman resursseja palvelimella ei ole mukautettua toiminnallisuutta. Resurssit sijoitetaan resources/-hakemistoon.

Resurssin rakenne

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)

Resurssien lataaminen

Lisää resurssien nimet resources-taulukkoon tiedostossa server.toml ladataksesi ne käynnistyksessä:

resources = ["chat", "freeroam", "spawn"]

Jokaisella resurssilla on oltava resource.toml-tiedosto hakemistossaan, joka määrittää sen tyypin, riippuvuudet ja skriptien aloituskohdat. Lisätietoja resurssien luomisesta ja hallinnasta on kohdassa alt:V järjestelmänvalvojan ja resurssien asennus.

CDN-asetukset

alt:V käyttää CDN-mekanismia asiakaspuolen tiedostojen (mallit, tekstuurit, skriptit) toimittamiseen yhdistäville pelaajille. Sisäänrakennettu CDN palvelee tiedostoja suoraan palvelimelta ilman ylimääräistä konfiguraatiota — tämä on oletus ja toimii hyvin useimmilla palvelimilla. Suuren mittakaavan palvelimille, joilla on paljon mukautettuja resursseja, voit halutessasi konfiguroida ulkoisen CDN:n lataamalla asiakastiedostot verkkopalvelimelle ja asettamalla CDN-URL:n resurssin konfiguraatioon, mikä vähentää pelipalvelimen kaistanleveyden käyttöä.

Äänichat

alt:V sisältää sisäänrakennetun äänichat-järjestelmän, joka mahdollistaa paikkatietoisen (3D) ääniviestinnän pelaajien välillä. Äänichat otetaan käyttöön ja konfiguroidaan tiedostossa server.toml.

Ääniasetukset

[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0

bitrate hallitsee äänen laatua (64000 on vakio). external*-kentät konfiguroivat ulkoisen äänipalvelimen — jätä ne tyhjäksi/nollaksi käyttääksesi sisäänrakennettua äänipalvelinta, jota suositellaan useimmille asennuksille. Ulkoinen äänipalvelinvaihtoehto on tarpeen vain edistyneissä konfiguraatioissa, joissa äänenkäsittely siirretään erilliselle koneelle.

Kuinka pelaajat yhdistävät

Pelaajat yhdistävät alt:V-palvelimiin alt:V-käynnistyssovelluksen kautta, ei suoraan GTA V:n kautta.

Palvelinselaimen kautta

1. Lataa ja asenna alt:V-käynnistyssovellus osoitteesta altvmp.com.
2. Käynnistä alt:V-käynnistyssovellus. Se havaitsee ja vahvistaa GTA V -asennuksen.
3. Käynnistyssovelluksesta, selaa palvelinselainta.
4. Etsi palvelintasi nimen perusteella tai käytä suodattimia (pelimoodi, tunnisteet, pelaajamäärä).
5. Klikkaa palvelintasi ja valitse Connect.
6. Jos palvelimella on salasana, pelaajaa pyydetään syöttämään se.
7. GTA V käynnistyy alt:V-moninpelimuokkauksen kanssa ja yhdistää palvelimellesi.

Suoran yhteyden kautta

1. alt:V-käynnistyssovelluksessa valitse Direct Connect.
2. Syötä palvelimesi IP-osoite ja portti muodossa IP:PORT (esim. 192.168.1.1:7788).
3. Klikkaa Connect.

Löytääksesi palvelimesi IP-osoitteen ja portin, katso Palvelimen IP:n ja portin löytäminen.

Maksimimäärä pelaajia ja suorituskyky

alt:V-palvelimet voivat tukea suuria pelaajamääriä, mutta suorituskyky riippuu vahvasti resursseistasi ja palvelinpaketistasi:

• 32–128 pelaajaa: Yleinen alue useimmille palvelimille. Yksinkertaiset pelimoodit toimivat sujuvasti suuremmillakin määrillä.
• 128–512+ pelaajaa: Mahdollinen optimoiduilla palvelimilla, joilla on tehokkaat resurssit. Vaatii enemmän CPU:ta ja RAM:ia.
• Resurssien tehokkuus: Huonosti optimoidut skriptit ovat ensisijainen suorituskykyongelmien syy. Palvelinpuolen skriptit, jotka suorittavat raskaita operaatioita jokaisella tickillä tai ylläpitävät suuria tietorakenteita muistissa, voivat aiheuttaa pullonkauloja palvelimella.
• Tietokantakyselyt: Tietokantoja (MySQL, MongoDB) käyttävien pelimoodien tulisi käyttää asynkronisia kyselyitä välttääkseen pääsäikeen estymistä.

Aiheeseen liittyvät artikkelit

• alt:V järjestelmänvalvojan ja resurssien asennus — Resurssien kehitys, tietokannan asennus, järjestelmänvalvojan työkalut ja vianmääritys
• 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 ja ongelman kuvauksella.