> ## Content Index
> Fetch the complete content index at: https://noctis.id/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# Cara Install QBCore FiveM Menggunakan txAdmin
- URL: https://noctis.id/blog/install-qbcore-txadmin/
- Published: 2026-10-18T21:36:24.000Z
- Updated: 2026-10-18T21:36:24.000Z
- Description: Tutorial install QBCore FiveM lewat recipe txAdmin: menyiapkan MariaDB, menjalankan recipe, masuk ke server, set admin, konfigurasi awal, dan solusi error yang sering muncul.
- Author: Noctis
- Tags: FiveM, FiveM Development

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](https://noctis.id/blog/cara-membuat-server-fivem/).

## Persiapan

Pastikan semua ini sudah siap:

- **FXServer artifact** versi Recommended dari [runtime.fivem.net](https://runtime.fivem.net/artifacts/fivem/?ref=noctis.id). txAdmin sudah ikut di dalamnya.
- **License key** dari [portal.cfx.re](https://portal.cfx.re/?ref=noctis.id).
- **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:

```bash
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:

```sql
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](https://mariadb.org/download/?ref=noctis.id). 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](https://noctis.id/blog/install-fivem-server-ubuntu-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](https://docs.qbcore.org/qbcore-documentation/guides/windows-installation?ref=noctis.id) dan dokumentasi [txAdmin di GitHub](https://github.com/citizenfx/txAdmin?ref=noctis.id).

## 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:

```cfg
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:

```text
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`:

```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](https://noctis.id/blog/qbcore-custom-job/).

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](https://noctis.id/blog/fivem-crash-stuck-loading/).

## Langkah berikutnya

- Ganti inventory bawaan dengan yang lebih modern: [Cara Install ox\_inventory dan ox\_lib di QBCore](https://noctis.id/blog/install-ox-inventory-ox-lib-qbcore/).
- Pelajari scripting dasar: [Belajar Lua FiveM dari Nol](https://noctis.id/blog/tutorial-lua-fivem/).
- Siapkan backup sejak hari pertama: [Cara Backup dan Restore Database Server FiveM](https://noctis.id/blog/backup-restore-database-fivem/).
- Masih ragu dengan pilihan framework? Baca [QBCore vs ESX vs Qbox](https://noctis.id/blog/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](https://noctis.id/id/fivem-hosting/?ref=noctis.id): 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](https://noctis.id/id/cloud/?ref=noctis.id) atau tanya langsung di [Discord Noctis](https://discord.gg/b2USAXKFdT?ref=noctis.id).