Panduan ini membahas cara memasang sumber daya (skrip) di server FiveM Anda, mengatur database MySQL untuk framework seperti ESX atau QBCore, dan memahami urutan pemuatan sumber daya. Jika Anda belum menyelesaikan pengaturan server awal, mulai dengan Panduan Pengaturan Server FiveM terlebih dahulu.

Memasang Sumber Daya dan Skrip

Server FiveM diperluas dengan sumber daya (juga disebut skrip). Sumber daya menambahkan fitur seperti dealer mobil, pekerjaan, elemen HUD, framework, dan banyak lagi.

Cara Memasang Sumber Daya

1. Unduh sumber daya dari sumbernya (GitHub, forum Cfx.re, Tebex, dll.).
2. Ekstrak folder sumber daya dari ZIP/arsip jika diperlukan.
3. Unggah folder sumber daya ke direktori resources/ server Anda menggunakan tab Files GPanel atau melalui SFTP.
4. Buka server.cfg dan tambahkan baris ensure untuk sumber daya tersebut:

# Add your custom resources
ensure my-new-resource

5. Mulai ulang server dari GPanel atau TXAdmin agar sumber daya dimuat.

Manifest Sumber Daya

Setiap sumber daya yang valid harus berisi file manifest. Sumber daya modern menggunakan fxmanifest.lua, sementara yang lebih lama menggunakan __resource.lua. Jika folder sumber daya yang diunduh tidak berisi salah satu dari file ini, sumber daya tidak akan dimuat. Beberapa unduhan menyarangkan folder sumber daya yang sebenarnya di dalam folder luar — pastikan folder yang Anda tempatkan di resources/ adalah folder yang berisi manifest.

Urutan Pemuatan Sumber Daya

Sumber daya dimuat sesuai urutan kemunculannya di server.cfg. Jika sebuah sumber daya bergantung pada yang lain (misalnya, skrip pekerjaan yang bergantung pada framework seperti ESX atau QBCore), pastikan dependensi tercantum sebelum sumber daya yang membutuhkannya:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

Mengatur Sumber Daya dengan Folder Kategori

Anda dapat mengatur sumber daya ke dalam subfolder di dalam direktori resources/. Gunakan notasi tanda kurung di server.cfg untuk memuat seluruh folder kategori:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

Ini memuat setiap sumber daya di dalam subfolder yang disebutkan. Ini adalah cara yang nyaman untuk mengelompokkan skrip terkait tanpa mencantumkan masing-masing secara individual.

Memuat Sumber Daya Secara Langsung (Hot-Loading) melalui TXAdmin

Anda tidak selalu memerlukan mulai ulang server penuh untuk memuat sumber daya baru. TXAdmin dapat memulai, menghentikan, dan memulai ulang sumber daya individual dari halaman Resources-nya. Setelah mengunggah sumber daya baru dan menambahkan baris ensure-nya, Anda dapat menjalankan perintah berikut di konsol langsung TXAdmin:

refresh
ensure my-new-resource

Perintah refresh memberi tahu server untuk memindai ulang direktori resources/ untuk entri baru.

Pengaturan Database (MySQL / MariaDB)

Banyak framework dan sumber daya FiveM (seperti ESX, QBCore, atau vRP) memerlukan database MySQL atau MariaDB. Legion Hosting menyediakan kredensial database dengan server Anda.

Menemukan Kredensial Database Anda

1. Di GPanel, buka tab Databases.
2. Jika belum ada database, klik New Database untuk membuat satu.
3. Catat detail berikut:
   • Host Database (alamat dan port)
   • Nama Database
   • Username
   • Kata Sandi (klik ikon mata untuk menampilkannya)

Mengonfigurasi Koneksi Database

Detail koneksi database diatur di server.cfg menggunakan string koneksi. Format pastinya bergantung pada sumber daya MySQL mana yang Anda gunakan, tetapi format yang paling umum adalah:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

Ganti placeholder dengan kredensial Anda yang sebenarnya dari tab Databases. Misalnya:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

Memilih Sumber Daya MySQL

Sumber daya MySQL mana pun yang Anda gunakan, ia harus di-ensure di server.cfg sebelum sumber daya apa pun yang bergantung padanya:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

Dasar-Dasar Framework

Framework menyediakan sistem inti gameplay yang menjadi dasar bagi sumber daya lain — hal-hal seperti identitas pemain, uang, inventaris, pekerjaan, dan kendaraan. Dua framework FiveM yang paling populer adalah:

Sebagian besar framework dipasang melalui sistem resep TXAdmin selama pengaturan awal. Jika Anda memilih resep seperti "QBCore" atau "ESX" selama pengaturan TXAdmin, framework dan dependensi intinya sudah terpasang. Jika Anda perlu memasang framework secara manual, ikuti dokumentasi resminya:

• Dokumentasi ESX
• Dokumentasi QBCore

Mendapatkan Bantuan

Jika Anda memerlukan bantuan dengan pemasangan sumber daya atau konfigurasi database:

1. Periksa dokumentasi atau halaman GitHub sumber daya untuk instruksi pemasangan dan masalah yang diketahui.
2. Tinjau konsol GPanel atau log TXAdmin untuk pesan kesalahan.
3. Buka tiket dukungan di https://legionhosting.net/submitticket.php dengan pesan kesalahan Anda dan nama sumber daya yang ingin Anda pasang.

Artikel Terkait

• Panduan Pengaturan Server FiveM
• Pemecahan Masalah FiveM
• Cara Mengunggah File melalui SFTP
• Cara Menemukan IP dan Port Server Anda