Panduan ini membahas pengembangan resource, pengaturan database, alat admin, pengelolaan pemain, pengelolaan kendaraan dan senjata, serta pemecahan masalah untuk server alt:V Anda di Legion Hosting. Untuk pengaturan awal server, konfigurasi server.toml, dan instruksi koneksi, lihat Panduan Pengaturan Server alt:V.

---

Pengaturan Admin

alt:V tidak memiliki sistem admin bawaan. Fungsionalitas admin diimplementasikan melalui resource (skrip) yang Anda buat atau pasang. Sebagian besar gamemode mengimplementasikan sistem admin mereka sendiri dengan level izin, peran, dan perintah admin.

Pendekatan Admin Umum

• Peran berbasis database: Sebagian besar framework roleplay dan gamemode menyimpan peran admin di database. Admin diberi peran (mis., moderator, admin, superadmin) yang memberikan level izin berbeda.
• Admin berbasis config: Pengaturan yang lebih sederhana mungkin menggunakan file konfigurasi yang mencantumkan Steam ID admin atau alt:V ID beserta level izinnya.
• Perintah konsol: Konsol server GPanel selalu memiliki akses penuh. Anda dapat menulis skrip sisi server yang menerima input konsol untuk operasi admin.

Menyiapkan Resource Admin

1. Pilih atau kembangkan resource admin yang sesuai dengan gamemode Anda.
2. Unggah resource ke direktori resources/ melalui tab Files atau SFTP.
3. Tambahkan nama resource ke array resources di server.toml.
4. Konfigurasikan resource admin (atur Steam/alt:V ID admin Anda, level izin, dll.).
5. Restart server.

---

Sistem Resource

Resource adalah blok pembangun inti server alt:V. Setiap resource adalah modul mandiri yang dapat berisi kode sisi server, kode sisi client, atau keduanya. Resource ditulis dalam JavaScript, TypeScript, atau C#.

Struktur Resource

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

Konfigurasi resource.toml

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

Field: type (js atau csharp), main (entry point sisi server), client-main (entry point sisi client, berjalan di GTA V pemain), client-files (file yang dikirim ke client, mendukung glob), deps (resource lain yang dimuat terlebih dahulu).

---

Memasang Resource

Untuk memasang resource yang sudah jadi di server Anda:

1. Unduh file resource (biasanya berupa folder yang berisi resource.toml dan file skrip).
2. Hentikan server Anda di GPanel.
3. Unggah folder resource ke resources/ melalui tab Files atau SFTP.
4. Tambahkan nama folder resource ke array resources di server.toml:

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

5. Jika resource memiliki dependensi, pastikan dependensi tersebut juga terpasang dan tercantum.
6. Konfigurasikan resource sesuai dokumentasinya (file config, pengaturan database, dll.).
7. Mulai server. Periksa konsol untuk pesan pemuatan resource dan error apa pun.

Menghapus Resource

1. Hentikan server Anda.
2. Hapus nama resource dari array resources di server.toml.
3. Secara opsional hapus folder resource dari resources/.
4. Mulai server.

---

Pengaturan Database

Sebagian besar gamemode alt:V memerlukan database untuk menyimpan data pemain, kendaraan, inventaris, dan informasi persisten lainnya. Dua sistem database paling umum untuk alt:V adalah MongoDB dan MySQL/MariaDB.

MongoDB

MongoDB adalah database dokumen NoSQL yang umum digunakan dengan resource JavaScript/TypeScript. Gunakan layanan terkelola seperti MongoDB Atlas (tersedia tier gratis) atau instance yang dihosting sendiri. Dapatkan connection string Anda (mis., mongodb+srv://user:[email protected]/mydb) dan konfigurasikan di file config resource Anda. Resource Node.js menggunakan paket npm mongodb.

MySQL / MariaDB

MySQL umum digunakan dengan resource C# dan beberapa framework JavaScript. Dapatkan database dari layanan terkelola atau instance yang dihosting sendiri, konfigurasikan resource Anda dengan detail koneksi (host, port, username, password, nama database), dan jalankan skrip migrasi SQL yang diperlukan.

---

Pengelolaan Pemain

Pengelolaan pemain di alt:V ditangani melalui resource Anda. Operasi umum meliputi:

Mengidentifikasi Pemain

alt:V menyediakan beberapa pengidentifikasi untuk setiap pemain yang terhubung:

Kicking dan Banning

Implementasikan fungsionalitas kick dan ban di resource Anda:

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

---

Pengelolaan Kendaraan dan Senjata

Kendaraan dan senjata dikelola melalui skrip sisi server. alt:V memberi Anda kendali penuh atas spawning, memodifikasi, dan menghapus kendaraan serta senjata.

Memunculkan Kendaraan

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

Memberikan Senjata

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

// Remove all weapons
player.removeAllWeapons();

Persistensi Kendaraan

Secara default, kendaraan hanya ada di memori server dan hilang saat restart. Untuk mempertahankan kendaraan lintas restart, simpan datanya (model, posisi, modifikasi, pemilik) di database dan buat ulang saat server mulai.

---

Pemecahan Masalah

Resource Tidak Memuat

• Periksa bahwa nama resource di server.toml persis sama dengan nama folder di resources/.
• Verifikasi resource memiliki file resource.toml yang valid dengan field type dan main yang benar.
• Periksa konsol untuk pesan error selama pemuatan resource. Error sintaks pada skrip akan mencegah resource mulai.
• Pastikan semua dependensi yang tercantum di deps terpasang dan dimuat.
• Verifikasi modul yang benar dimuat di server.toml (js-module untuk JavaScript, csharp-module untuk C#).

Pemain Tidak Dapat Terhubung

• Verifikasi server berjalan dan menampilkan status online di GPanel.
• Periksa bahwa pemain menggunakan alt:V launcher, bukan launcher GTA V biasa.
• Pastikan branch server alt:V cocok dengan yang dimiliki pemain (release, rc, atau dev). Branch yang tidak cocok mencegah koneksi.
• Jika dilindungi password, verifikasi pemain memasukkan password yang benar.
• Minta pemain mencoba direct connect dengan IP dan port. Lihat Cara Menemukan IP dan Port Server Anda.

Crash Server

• Periksa konsol untuk pesan error sebelum crash.
• Resource yang bermasalah adalah penyebab crash paling umum. Nonaktifkan resource yang baru ditambahkan untuk mengisolasi masalah.
• Pastikan file server Anda mutakhir. Picu instal ulang dari tab Startup jika diperlukan.
• Kebocoran memori pada resource dapat menyebabkan server kehabisan RAM seiring waktu. Pantau grafik resource GPanel untuk penggunaan memori yang terus meningkat.

Masalah Database dan Suara

• Verifikasi kredensial database dan connection string. Untuk MongoDB Atlas, whitelist IP server Anda di pengaturan akses jaringan.
• Periksa konsol untuk pesan error koneksi database.
• Voice chat memerlukan bagian [voice] di server.toml ditambah resource yang mengimplementasikan logika channel suara. Konfigurasi saja hanya menyiapkan infrastruktur.

Masalah Performa

• Profil resource Anda untuk operasi yang mahal (loop berat, panggilan database sinkron, pembuatan entitas berlebihan).
• Gunakan alt.setInterval dan alt.setTimeout secara hemat. Operasi per-tick yang berat adalah pembunuh performa paling umum.
• Pantau grafik resource GPanel untuk penggunaan CPU dan RAM.
• Pertimbangkan untuk meningkatkan paket server Anda untuk jumlah pemain yang tinggi. Buka tiket dukungan untuk mendiskusikan opsinya.

---

Artikel Terkait

• Panduan Pengaturan Server alt:V — Pengaturan awal, konfigurasi server.toml, voice chat, dan instruksi koneksi
• 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, deskripsi masalah, dan pesan error relevan apa pun dari konsol GPanel.