Panduan ini membahas semua yang Anda butuhkan untuk menjalankan server alt:V di Legion Hosting, mulai dari startup pertama kali dan konfigurasi server.toml hingga resource gamemode, pengaturan CDN, voice chat, dan cara pemain terhubung melalui alt:V launcher. Untuk pengembangan resource, pengaturan database, dan pengelolaan admin, lihat Pengaturan Admin dan Resource alt:V.

Apa itu alt:V?

alt:V adalah modifikasi multiplayer gratis dan open-source untuk Grand Theft Auto V. Modifikasi ini memungkinkan pemain terhubung ke server kustom yang menjalankan gamemode unik seperti roleplay (RP), deathmatch, balapan, freeroam, dan lainnya. Server menjalankan resource kustom yang ditulis dalam JavaScript, TypeScript, atau C#, memberi pemilik server kendali penuh atas logika gameplay. Pemain terhubung melalui alt:V launcher, yang memodifikasi GTA V untuk konektivitas multiplayer.

Mulai Pertama Kali

Ketika Anda pertama kali menerima server alt:V Anda, ikuti langkah-langkah berikut untuk membuatnya online:

1. Masuk ke GPanel dan pilih server alt:V Anda.
2. Navigasikan ke tab Startup dan konfigurasikan nama server, jumlah pemain maksimum, dan variabel startup lainnya.
3. Buka tab Console dan klik Start.
4. Server akan mengunduh file server alt:V pada boot pertama. Ini mungkin membutuhkan beberapa menit.
5. Setelah konsol menampilkan bahwa server sedang mendengarkan dan siap untuk koneksi, server Anda online.
6. Secara default, server mulai tanpa resource gamemode. Anda perlu menambahkan resource untuk membuat gameplay. Lihat Pengaturan Admin dan Resource alt:V untuk detailnya.

Variabel Startup GPanel

alt:V mengekspos beberapa opsi konfigurasi sebagai variabel startup di GPanel. Navigasikan ke tab Startup untuk memodifikasinya. Perubahan memerlukan restart server.

Konfigurasi Server (server.toml)

File konfigurasi utama untuk server alt:V adalah server.toml, yang berlokasi di direktori root server. Anda dapat mengedit file ini melalui tab Files di GPanel atau via SFTP.

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

Pengaturan utama: name (nama tampilan browser), host (biarkan 0.0.0.0), port (harus cocok dengan GPanel), players (jumlah maksimum), password (kosong untuk publik), announce (true agar muncul di browser), token (announce token dari situs alt:V, diperlukan untuk listing browser), gamemode (label browser seperti "Roleplay"), modules (modul skrip: js-module atau csharp-module), resources (array folder resource yang dimuat), dan tags (tag filter browser).

Announce Token

Agar server Anda muncul di browser server alt:V, Anda memerlukan announce token dari master server alt:V:

1. Kunjungi situs alt:V dan masuk atau buat akun.
2. Navigasikan ke bagian pengelolaan server dan hasilkan token server baru.
3. Salin token dan tempelkan ke field token di server.toml Anda.
4. Pastikan announce = true di konfigurasi Anda.
5. Restart server. Server kini akan muncul di browser publik.

Resource Gamemode

Server alt:V ditenagai oleh resource — skrip yang mendefinisikan semua logika gameplay. Tanpa resource, server tidak memiliki fungsionalitas kustom. Resource ditempatkan di direktori resources/.

Struktur Resource

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)

Memuat Resource

Tambahkan nama resource ke array resources di server.toml untuk memuatnya saat startup:

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

Setiap resource harus memiliki file resource.toml di direktorinya yang mendefinisikan tipe, dependensi, dan entry point skripnya. Untuk detail tentang membuat dan mengelola resource, lihat Pengaturan Admin dan Resource alt:V.

Pengaturan CDN

alt:V menggunakan mekanisme CDN untuk menyajikan file sisi client (model, tekstur, skrip) ke pemain yang terhubung. CDN bawaan menyajikan file langsung dari server tanpa konfigurasi tambahan — ini adalah default dan berfungsi baik untuk sebagian besar server. Untuk server berskala besar dengan banyak aset kustom, Anda dapat secara opsional mengonfigurasi CDN eksternal dengan mengunggah file client ke web server dan mengatur URL CDN di konfigurasi resource Anda, mengurangi penggunaan bandwidth server game.

Voice Chat

alt:V menyertakan sistem voice chat bawaan yang memungkinkan komunikasi suara posisional (3D) antar pemain. Voice chat diaktifkan dan dikonfigurasi di server.toml.

Konfigurasi Voice

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

bitrate mengatur kualitas suara (64000 adalah standar). Field external* mengonfigurasi server suara eksternal — biarkan kosong/nol untuk menggunakan server suara bawaan, yang direkomendasikan untuk sebagian besar pengaturan. Opsi server suara eksternal hanya diperlukan untuk konfigurasi lanjutan di mana pemrosesan suara dialihkan ke mesin terpisah.

Cara Pemain Terhubung

Pemain terhubung ke server alt:V melalui alt:V launcher, bukan melalui GTA V secara langsung.

Melalui Browser Server

1. Unduh dan pasang alt:V launcher dari altvmp.com.
2. Luncurkan alt:V launcher. Launcher akan mendeteksi dan memverifikasi instalasi GTA V.
3. Dari launcher, telusuri Server Browser.
4. Cari server Anda berdasarkan nama atau gunakan filter (gamemode, tag, jumlah pemain).
5. Klik server Anda dan pilih Connect.
6. Jika server memiliki password, pemain akan diminta memasukkannya.
7. GTA V akan diluncurkan dengan mod multiplayer alt:V dan terhubung ke server Anda.

Melalui Direct Connect

1. Di alt:V launcher, pilih Direct Connect.
2. Masukkan alamat IP dan port server Anda dalam format IP:PORT (mis., 192.168.1.1:7788).
3. Klik Connect.

Untuk menemukan alamat IP dan port server Anda, lihat Cara Menemukan IP dan Port Server Anda.

Jumlah Pemain Maksimum dan Performa

Server alt:V dapat mendukung jumlah pemain yang tinggi, tetapi performa sangat bergantung pada resource dan paket server Anda:

• 32–128 pemain: Rentang umum untuk sebagian besar server. Gamemode sederhana berjalan mulus pada jumlah yang lebih tinggi.
• 128–512+ pemain: Memungkinkan untuk server yang dioptimasi dengan resource yang efisien. Memerlukan lebih banyak CPU dan RAM.
• Efisiensi resource: Skrip yang kurang dioptimasi adalah penyebab utama masalah performa. Skrip sisi server yang menjalankan operasi berat setiap tick atau mempertahankan struktur data besar di memori dapat menjadi bottleneck server.
• Kueri database: Gamemode yang menggunakan database (MySQL, MongoDB) harus menggunakan kueri async untuk menghindari pemblokiran main thread.

Artikel Terkait

• Pengaturan Admin dan Resource alt:V — Pengembangan resource, pengaturan database, alat admin, dan pemecahan masalah
• Cara Menemukan IP dan Port Server Anda
• Cara Mengunggah File melalui SFTP
• Panduan Memulai Server — Panduan umum untuk memulai server game apa pun di Legion Hosting

Butuh Bantuan Lebih Lanjut?

Jika Anda mengalami masalah yang tidak dibahas dalam panduan ini, tim dukungan kami siap membantu. Buka tiket di legionhosting.net/submitticket.php dengan detail server Anda dan deskripsi masalahnya.