ESX, QBCore dan Qbox: Atur Framework Anda dan Buat Pekerjaan

Framework yang berfungsi adalah fondasi dari server FiveM Anda. Sebelum menambahkan garasi, tablet, atau bisnis, pastikan pembuatan karakter, database, dan penugasan pekerjaan sudah berfungsi. Panduan ini mencakup instalasi baru dan satu contoh pekerjaan kecil di ESX Legacy, QBCore atau Qbox. Ikuti bagian sesuai framework Anda; menginstal ketiganya secara bersamaan bukan merupakan bagian dari pengaturan.

Mulai dengan instalasi bersih

Siapkan akun Cfx.re, kunci registrasi server, artefak FXServer yang sesuai dan layanan MariaDB yang sedang berjalan. Gunakan versi database yang didukung oleh framework pilihan Anda; Qbox secara eksplisit memerlukan MariaDB dan tidak mendukung MySQL atau XAMPP. Pada hosting terkelola, gunakan kontrol server dan txAdmin dari penyedia layanan. Lihat panduan pengaturan server FiveM resmi dan persyaratan Qbox.

1. Buka txAdmin dan pilih deployment resep baru di direktori data server baru.
2. Pilih resep resmi framework Anda: ESX Legacy, QBCore atau Qbox.
3. Masukkan kunci server dan detail koneksi MariaDB yang benar. Gunakan akun database khusus dengan akses ke database server ini.
4. Jalankan resep, tinjau konfigurasi yang dihasilkan, dan jalankan server. Pertahankan dependensi resep dan urutan resource.
5. Masuk, buat karakter, hubungkan kembali, dan pastikan karakter masih dapat dimuat sebelum menambahkan resource lainnya.

Resep mengunduh sumber daya dan menjalankan instalasi SQL-nya. Jangan mengimpor skema framework lengkap kedua setelahnya atau menerapkan resep baru di atas server yang sudah ada. Cadangkan file dan juga database sebelum melakukan perubahan di kemudian hari. Untuk langkah-langkah instalasi khusus framework, ikuti panduan instalasi ESX, panduan Windows QBCore atau panduan instalasi Qbox.

Pahami apa yang sebenarnya terkandung dalam sebuah pekerjaan

Setiap pekerjaan memiliki kunci internal, label tampilan dan pangkat bernomor. Kami menggunakan sky_example, dengan pangkat 0 dan 1, di seluruh bagian. Pastikan kunci tersebut identik di dalam framework, skrip pekerjaan dan integrasi apa pun. Label seperti “Contoh Perusahaan” hanyalah nama yang dilihat pemain.

Mendaftarkan pekerjaan membuat identitas framework-nya. Gameplay, garasi, penyimpanan, menu bos dan akun bisnis memerlukan sumber daya dan konfigurasi kompatibel mereka sendiri. Pekerjaan framework bukanlah bisnis yang sudah selesai. Lokasi di atas mengikuti skema ESX, file pekerjaan QBCore dan file pekerjaan Qbox.

ESX Legacy: buat pekerjaan di MariaDB

Buka database yang dikonfigurasi untuk server ini, bukan database server lain. Pertama, periksa apakah kunci contoh sudah ada:

SELECT name FROM jobs WHERE name = 'sky_example';
SELECT grade FROM job_grades WHERE job_name = 'sky_example';

Hanya jalankan insert berikut jika kedua pemeriksaan tidak mengembalikan baris. Jika pekerjaan sudah ada, periksa dan edit catatan yang ada alih-alih memasukkan duplikat.

INSERT INTO jobs (name, label)
VALUES ('sky_example', 'Example Company');

INSERT INTO job_grades
    (job_name, grade, name, label, salary, skin_male, skin_female)
VALUES
    ('sky_example', 0, 'employee', 'Employee', 100, '{}', '{}'),
    ('sky_example', 1, 'boss', 'Manager', 200, '{}', '{}');

job_name menghubungkan setiap grade ke pekerjaan tersebut. Kolom grade adalah pangkat yang digunakan untuk penugasan; id otomatis pada baris tersebut bukanlah pangkatnya. Pekerjaan tanpa grade akan diabaikan. Muat ulang katalog pekerjaan melalui konsol server:

refreshjobs

ESX Legacy saat ini dimulai dengan oxmysql, lalu esx_lib, lalu es_extended; tutorial lama mungkin mengabaikan esx_lib. Tetap gunakan dependensi yang disediakan oleh resep Anda. Lihat konfigurasi resep saat ini dan implementasi pemuatan pekerjaan.

Untuk integrasi esx_society, nama grade internal boss dikenali melalui konfigurasi boss default-nya. Label yang terlihat seperti “Manager” saja tidak memberikan hak apa pun. Registrasi society, akun, dan urutan dependensi tetap menjadi langkah pengaturan terpisah. Ikuti dokumentasi society jika resource pekerjaan Anda menggunakannya.

QBCore: tambahkan entri ke tabel jobs

Buka qb-core/shared/jobs.lua. Masukkan ini ke dalam tabel jobs yang sudah ada, di samping entri pekerjaan lainnya dan sebelum kurung penutupnya. Tetap pertahankan deklarasi tabel yang ada dan semua pekerjaan yang ada; ini adalah sebuah entri, bukan file pengganti.

['sky_example'] = {
    label = 'Example Company',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        ['0'] = { name = 'Employee', payment = 100 },
        ['1'] = { name = 'Manager', payment = 200, isboss = true },
    },
},

Tetap gunakan string untuk key grade, termasuk grade nol. Periksa koma dan kurung kurawal di sekitar entri tetangga, simpan, lalu lakukan restart server penuh yang terencana agar resource yang bergantung dapat memuat definisi yang sama. Perintah refresh dari FiveM memindai ulang resource dan manifest; ini tidak memuat ulang tabel Lua pekerjaan yang sedang berjalan. Jangan membuat baris SQL jobs gaya ESX untuk QBCore. definisi pekerjaan berada di Lua, sementara data karakter tetap menggunakan database.

isboss menandakan grade manajer; ini tidak memberikan izin perintah framework-admin. Resource manajemen yang kompatibel tetap harus menyediakan dan mengonfigurasi menu aktual beserta lokasinya.

Qbox: gunakan file job miliknya sendiri dan grade numerik

Buka qbx_core/shared/jobs.lua dan masukkan ini ke dalam tabel yang dikembalikan oleh return { ... }, sebelum kurung kurawal penutup terakhir. Pertahankan entri lainnya. Qbox menggunakan kunci grade numerik di sini; jangan menempelkan kunci string QBCore tanpa perubahan.

['sky_example'] = {
    label = 'Example Company',
    defaultDuty = false,
    offDutyPay = false,
    grades = {
        [0] = { name = 'Employee', payment = 100 },
        [1] = { name = 'Manager', payment = 200, isboss = true, bankAuth = true },
    },
},

Simpan dan lakukan restart server penuh yang terencana. bankAuth terpisah dari isboss dan digunakan oleh integrasi perbankan yang kompatibel; kedua flag ini tidak membuat akun atau menu. Sesuaikan pengaturan Anda dengan definisi job Qbox resmi.

Qbox menyertakan dukungan multijob. Batas pekerjaan dan apakah /setjob mengganti atau menambah keanggotaan dapat dikonfigurasi. Gunakan perintah keanggotaan yang didukung saat mengelola beberapa pekerjaan; jangan berasumsi sumber daya multijob QBCore eksternal kompatibel. Lihat perintah Qbox dan konfigurasi multijob.

Tugaskan, uji dan hubungkan kembali

Bergabunglah dengan karakter uji dan gunakan akun dengan izin perintah framework/ACE yang diperlukan. Login txAdmin saja tidak menetapkan izin tersebut. Jika Qbox mengaktifkan requireOptIn, gunakan /optin sebelum perintah admin. Ganti 1 di bawah dengan ID server karakter uji terhubung Anda saat ini; /job melaporkan job dari pemain yang memasukkannya:

/setjob 1 sky_example 0
/job
/setjob 1 sky_example 1
/job

Pastikan kedua grade menunjukkan job dan pangkat yang diharapkan. Sintaks penugasan didokumentasikan untuk ESX, QBCore dan Qbox; pemeriksaan opt-in kondisional Qbox ada di dalam implementasi perintahnya.

Untuk QBCore dan Qbox, contoh ini dimulai dalam keadaan tidak bertugas dan menonaktifkan gaji saat tidak bertugas. Gunakan aksi untuk mulai atau berhenti bertugas yang disediakan oleh resource pekerjaan yang Anda instal; tidak ada perintah /duty universal untuk diasumsikan. Pengaturan login juga memengaruhi apakah status bertugas yang tersimpan atau defaultDuty yang menang. Kemudian hubungkan kembali dan verifikasi pekerjaan, pangkat, dan perilaku status bertugas yang dimaksudkan.

Sebelum membuka pekerjaan kepada pemain, uji izinnya dengan kedua pangkat. Seorang karyawan tidak boleh mengakses fitur yang dicadangkan untuk manajemen. Tunggu interval gaji yang telah Anda konfigurasi daripada mengharapkan pembayaran segera setelah penugasan; jumlah contoh adalah placeholder untuk ekonomi Anda. Jika pengecekan gagal, baca kesalahan konsol relevan pertama dan selesaikan sebelum menambahkan resource lain.

Hubungkan pekerjaan Sky Anda setelahnya

Setelah penugasan framework berhasil, ikuti panduan instalasi Sky dan konfigurasi resource pekerjaan yang Anda instal dengan key framework dan pangkat yang sama. Gunakan Fitur bersama Jobs Base untuk pengaturan bersama yang relevan. Hanya konfigurasi pasangan pekerjaan tidak bertugas jika pengaturan Sky pilihan Anda menggunakannya, dan buat kedua pekerjaan dengan setiap pangkat yang diperlukan.

Terakhir diperiksa: 25 Oktober 2026. Sumber di atas adalah dokumentasi framework resmi, resep yang telah dikelola, dan implementasi GitHub. Periksa versi yang terinstal sebelum menerapkan contoh dari rilis yang lebih baru.