Cara Install QBCore FiveM Menggunakan txAdmin

Cara tercepat dan paling rapi untuk memasang QBCore adalah lewat recipe di txAdmin. Recipe akan mengunduh resource QBCore, membuat database, mengimpor tabel, dan menulis server.cfg secara otomatis. Tutorial ini memandu kamu dari server kosong sampai bisa masuk ke kota QBCore pertamamu, lalu membahas konfigurasi awal yang wajib kamu ubah sebelum server dibuka untuk pemain.

Tutorial ini berlaku untuk Windows maupun Linux. Kalau kamu belum pernah menjalankan FXServer sama sekali, baca dulu panduan utama Cara Membuat Server FiveM Sendiri dari Nol.

Persiapan

Pastikan semua ini sudah siap:

• FXServer artifact versi Recommended dari runtime.fivem.net. txAdmin sudah ikut di dalamnya.
• License key dari portal.cfx.re.
• MariaDB atau MySQL yang sudah berjalan, beserta user yang boleh membuat database.
• Git tidak wajib untuk recipe, tapi berguna untuk mengelola resource setelahnya.

Menyiapkan MariaDB

Di Ubuntu/Debian:

sudo apt update
sudo apt install mariadb-server
sudo mysql_secure_installation

Lalu buat user khusus untuk FiveM. Jangan memakai user root untuk server game:

CREATE USER 'fivem'@'localhost' IDENTIFIED BY 'ganti_dengan_password_kuat';
GRANT ALL PRIVILEGES ON qbcore.* TO 'fivem'@'localhost';
FLUSH PRIVILEGES;

Di Windows, kamu bisa memasang MariaDB dari mariadb.org. Yang penting, catat host, port (default 3306), username, password, dan nama database yang akan dipakai.

Langkah 1: Jalankan txAdmin

Jalankan FXServer.exe (Windows) atau ./run.sh (Linux). Console akan menampilkan alamat panel txAdmin di port 40120 beserta PIN. Buka alamat tersebut, masukkan PIN, lalu login dengan akun Cfx.re kamu dan buat password admin.

Panduan menjalankan txAdmin sebagai service di Linux ada di Cara Install FiveM Server di Ubuntu Menggunakan txAdmin.

Langkah 2: Pilih recipe QBCore

1. Di setup wizard, isi nama server.
2. Pada pilihan tipe deployment, pilih Popular Recipes.
3. Pilih QBCore Framework dari daftar recipe.
4. Tentukan lokasi folder data server, misalnya txData/QBCore. Biarkan default kalau kamu belum punya struktur sendiri.
5. Klik lanjut untuk masuk ke halaman deployment.

Daftar recipe dan isinya bisa berubah seiring update txAdmin dan QBCore. Kalau tampilan berbeda, rujuk panduan instalasi resmi QBCore dan dokumentasi txAdmin di GitHub.

Langkah 3: Isi license key dan database

Deployer akan meminta beberapa data:

• License key: tempel key dari portal Cfx.re.
• Database host: biasanya localhost atau 127.0.0.1.
• Port: 3306.
• Username dan password: user yang tadi kamu buat.
• Database name: misalnya qbcore.

Klik Run Recipe. txAdmin akan mengunduh resource QBCore dari GitHub, mengimpor file SQL, lalu menampilkan server.cfg yang dihasilkan. Proses ini bisa memakan beberapa menit tergantung koneksi. Kalau ada langkah yang gagal, log di layar biasanya menunjukkan penyebabnya, misalnya kredensial database yang salah.

Langkah 4: Periksa server.cfg lalu start

Sebelum menyimpan, baca sekilas server.cfg. Bagian yang perlu kamu kenali:

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

set mysql_connection_string "mysql://fivem:password@localhost/qbcore?charset=utf8mb4"

sv_licenseKey "LICENSE_KEY_KAMU"
sv_maxclients 48

ensure oxmysql
ensure qb-core
ensure [qb]
ensure [standalone]
ensure [voice]
ensure [defaultmaps]

Struktur pastinya bisa sedikit berbeda tergantung versi recipe. Simpan, lalu klik Start Server. Perhatikan live console: kalau tidak ada error merah dan muncul pesan bahwa server sudah berjalan, kamu siap masuk.

Langkah 5: Masuk ke server

Buka FiveM, tekan F8, lalu ketik:

connect localhost:30120

Ganti localhost dengan IP server kalau server tidak berjalan di PC yang sama. Kamu akan melihat layar multicharacter QBCore. Buat karakter, pilih lokasi spawn, dan kamu sudah berada di kota QBCore.

Langkah 6: Jadikan dirimu admin

QBCore memakai sistem ACE bawaan FiveM untuk izin. Pertama, cari identifier kamu. Saat kamu online, buka menu Players di txAdmin, klik namamu, lalu salin identifier license: atau fivem:.

Tambahkan ke server.cfg:

add_principal identifier.license:IDENTIFIER_KAMU qbcore.god

Recipe QBCore biasanya sudah menyertakan definisi grup qbcore.god, qbcore.admin, dan qbcore.mod beserta izinnya. Restart server, lalu coba command admin seperti /admin (dari qb-adminmenu) atau /car adder. Berikan qbcore.god hanya kepada orang yang benar-benar kamu percaya.

Langkah 7: Konfigurasi awal yang wajib diubah

Pengaturan inti QBCore berada di resources/[qb]/qb-core/config.lua. Beberapa yang biasanya disesuaikan:

• Uang awal setiap tipe (cash, bank) untuk karakter baru.
• Lokasi spawn default.
• Jumlah maksimal karakter per pemain (diatur di resource multicharacter).
• Nama server dan pengaturan lain yang tampil ke pemain.

Daftar job dan gang ada di qb-core/shared/jobs.lua dan qb-core/shared/gangs.lua. Kalau kamu ingin menambah pekerjaan baru, ikuti Cara Membuat Sistem Job Custom di QBCore.

Jangan lupa mengubah sv_hostname, sets sv_projectName, dan sets sv_projectDesc agar servermu tampil dengan nama yang benar di server list.

Langkah 8: Amankan server sebelum dibuka

Server QBCore baru biasanya langsung menarik perhatian, termasuk dari orang yang mencari celah. Beberapa langkah dasar:

• Pisahkan rahasia. Pindahkan sv_licenseKey dan mysql_connection_string ke file terpisah, misalnya secrets.cfg, lalu panggil dengan exec secrets.cfg di server.cfg. Jangan masukkan file itu ke repository Git.
• Batasi akses txAdmin. Port 40120 sebaiknya hanya bisa diakses dari IP admin atau lewat VPN, dan setiap admin memakai akun sendiri dengan izin yang sesuai.
• Batasi database. MariaDB cukup mendengarkan di 127.0.0.1 kalau database berada di mesin yang sama dengan FXServer.
• Audit script pihak ketiga. Sebelum memasang resource dari sumber tidak dikenal, cek apakah ada event server yang memberi uang atau item tanpa validasi. Hindari resource bocoran atau hasil crack, karena sering berisi backdoor.

Mengelola update QBCore

QBCore dan resource-nya terus diperbarui. Supaya update tidak merusak server:

1. Simpan seluruh folder resources di repository Git privat, sehingga setiap perubahan tercatat dan bisa dikembalikan.
2. Catat perubahan yang kamu buat di resource bawaan. Lebih baik lagi, simpan modifikasi di resource terpisah atau file konfigurasi agar mudah digabung dengan versi baru.
3. Uji update di server staging dengan salinan database sebelum menerapkannya di server utama.
4. Ambil backup database sebelum setiap update besar.

Masalah yang sering muncul

oxmysql tidak bisa terhubung ke database

Cek format mysql_connection_string, pastikan service MariaDB berjalan, dan user punya izin ke database tersebut. Password dengan karakter khusus seperti @ atau / perlu di-encode di URL, atau pakai format server=...;uid=...;password=...;database=....

Error "No such export GetCoreObject"

Resource yang memanggil QBCore berjalan sebelum qb-core siap, atau nama folder qb-core diubah. Pastikan ensure qb-core ada sebelum resource lain yang bergantung padanya.

Tabel database tidak ditemukan

Import SQL saat recipe gagal di tengah jalan. Import ulang file SQL dari folder resource yang bersangkutan, atau jalankan ulang recipe di database kosong.

Stuck di loading screen

Biasanya ada resource yang error saat start. Buka live console dan cari pesan error pertama, bukan yang terakhir. Untuk sisi pemain, lihat juga Cara Mengatasi FiveM Crash dan Stuck Loading.

Langkah berikutnya

• Ganti inventory bawaan dengan yang lebih modern: Cara Install ox_inventory dan ox_lib di QBCore.
• Pelajari scripting dasar: Belajar Lua FiveM dari Nol.
• Siapkan backup sejak hari pertama: Cara Backup dan Restore Database Server FiveM.
• Masih ragu dengan pilihan framework? Baca QBCore vs ESX vs Qbox.

Jalankan servermu di infrastruktur yang sama dengan Noctis Roleplay

Noctis Roleplay adalah server QBCore yang kami kembangkan in-house dan jalankan di jaringan Noctis sendiri di Singapore (AS202118) dengan anti-DDoS. Infrastruktur yang sama tersedia lewat Hosting FiveM Noctis: vDedicated dengan core AMD Ryzen khusus, DDR5, NVMe, dan root penuh, siap untuk txAdmin dan recipe QBCore. VDS Lite (2 vCPU, 8 GB RAM) cocok untuk sebagian besar server QBCore yang sudah diluncurkan. Lihat semua paket di Noctis Cloud atau tanya langsung di Discord Noctis.