Cara Membuat Pekerjaan (Kerangka Kerja QBCore)

Selamat datang di tutorial mendetail tentang cara membuat pekerjaan khusus di QBCorekerangka kerja yang banyak digunakan untuk server roleplay FiveM. Panduan ini akan memandu Anda melalui proses penambahan pekerjaan baru melalui shared.luamenetapkan upah, dan mengonfigurasi izin dan tugas khusus pekerjaan.

Pendahuluan

Membuat pekerjaan khusus akan meningkatkan pengalaman bermain peran dengan memberikan peran dan tanggung jawab yang unik kepada para pemain. Baik Anda memperkenalkan layanan baru, divisi penegakan hukum, atau pekerjaan lain, panduan ini akan membantu Anda mengintegrasikannya dengan mulus ke server QBCore Anda.

Memahami Pekerjaan di QBCore

Dalam QBCore, tugas didefinisikan dalam file konfigurasi bersama yang dapat diakses oleh server dan klien. Setiap pekerjaan memiliki atribut seperti nama, label, status tugas default, nilai (peringkat), dan banyak lagi. Memahami atribut-atribut ini sangat penting untuk menciptakan pekerjaan yang fungsional dan seimbang.

Membuat Pekerjaan Baru di shared.lua

Menemukan lokasi shared.lua Mengajukan

The shared.lua berisi definisi untuk semua pekerjaan. Anda dapat menemukannya di direktori berikut:

[qb] > qb-core > shared > jobs.lua

Catatan: Dalam beberapa pengaturan, file mungkin diberi nama shared.lua di dalam qb-core folder.

Struktur Definisi Pekerjaan

Sebuah pekerjaan di QBCore didefinisikan menggunakan tabel Lua dengan kunci tertentu. Berikut adalah struktur umumnya:

["nama_pekerjaan"] = {
    label = "Label Pekerjaan",
    defaultDuty = false,
    offDutyPay = false,
    nilai = {
        [0] = {
            nama = "Peserta Pelatihan",
            pembayaran = 50
        },
        [1] = {
            nama = "Karyawan",
            pembayaran = 100
        },
        -- Nilai tambahan...
    }
},

• nama pekerjaan: Pengenal yang digunakan dalam skrip (gunakan huruf kecil tanpa spasi).
• label: Menampilkan nama pekerjaan.
• defaultDuty: benar jika pemain bertugas secara default.
• offDutyPay: benar jika pemain menerima pembayaran saat tidak bertugas.
• nilai: Tabel yang mendefinisikan peringkat yang berbeda dalam pekerjaan.

Menambahkan Pekerjaan Khusus Anda

1. Buka jobs.lua atau shared.lua

Gunakan editor teks seperti Visual Studio Code atau Notepad++ untuk membuka file.

2. Tambahkan Definisi Pekerjaan Anda

Masukkan definisi pekerjaan Anda di dalam pekerjaan yang sudah ada. Misalnya, untuk membuat pekerjaan "Pengemudi Pengiriman":

["pengiriman"] = {
    label = "Pengemudi Pengiriman",
    defaultDuty = false,
    offDutyPay = false,
    nilai = {
        [0] = {
            nama = "Peserta Pelatihan",
            pembayaran = 50
        },
        [1] = {
            nama = "Pengemudi",
            pembayaran = 100
        },
        [2] = {
            nama = "Pengemudi Senior",
            pembayaran = 150
        },
        [3] = {
            nama = "Manajer",
            pembayaran = 200,
            isBoss = true
        }
    }
},

• nama pekerjaan: "pengiriman" (digunakan dalam skrip dan basis data).
• label: "Pengemudi Pengiriman" (ditampilkan kepada pemain).
• defaultDuty: Atur ke salah sehingga pemain harus melakukan absensi.
• offDutyPay: Atur ke salah untuk meniadakan gaji saat tidak bertugas.
• nilai: Menentukan peringkat dari 0 ke atas.

3. Menyimpan File

Setelah menambahkan pekerjaan Anda, simpan file jobs.lua atau shared.lua file.

Menetapkan Upah

Upah ditetapkan dalam nilai tabel untuk setiap peringkat. The pembayaran menentukan berapa banyak yang diperoleh pemain per siklus pembayaran saat bertugas.

Contoh

nilai = {
    [0] = {
        nama = "Peserta Pelatihan",
        pembayaran = 50
    },
    [1] = {
        nama = "Pengemudi",
        pembayaran = 100
    },
    -- Nilai tambahan...
}

• pembayaran: Jumlah yang dibayarkan kepada pemain dengan kelas tersebut.

Menyesuaikan Siklus Pembayaran

Siklus pembayaran biasanya dikelola oleh qb-cek gaji atau sumber daya serupa. Pastikan sumber daya dikonfigurasikan dengan benar untuk menangani interval pembayaran.

Mengonfigurasi Izin dan Tugas Pekerjaan

Pangkat dan Izin

Setiap tingkatan pekerjaan dapat memiliki izin tertentu. The isBoss parameter memberikan kemampuan manajemen seperti perekrutan dan promosi.

Contoh

[3] = {
    nama = "Manajer",
    pembayaran = 200,
    isBoss = true
}

• isBoss: Atur ke benar untuk pangkat tertinggi untuk mengelola pangkat yang lebih rendah.

Menambahkan Fungsi Khusus Pekerjaan

Untuk menambahkan fungsi yang spesifik untuk pekerjaan baru Anda (misalnya, akses ke kendaraan, seragam, atau alat), Anda harus mengonfigurasi skrip tambahan.

1. Membuat Naskah Pekerjaan

Di folder sumber daya Anda, buat skrip baru untuk pekerjaan Anda:

[pekerjaan] > qb-pengiriman

2. Menentukan Tindakan Pekerjaan

Dalam skrip pekerjaan Anda, Anda dapat mendefinisikan tindakan seperti memulai misi pengiriman, mengakses kendaraan, dll.

-- Contoh: delivery_job.lua

RegisterNetEvent('qb-delivery:startJob')
AddEventHandler ('qb-delivery:startJob', function()
    src lokal = sumber
    local Player = QBCore.Functions.GetPlayer(src)
    if Player.PlayerData.job.name == 'pengiriman' and Player.PlayerData.job.onduty then
        -- Mulai misi pengiriman
    lain
        TriggerClientEvent('QBCore:Notify', src, 'Anda bukan pengemudi pengiriman atau sedang tidak bertugas', 'error')
    akhir
akhir)

3. Tambahkan Poin Interaksi

Gunakan sumber daya seperti qb-target untuk menciptakan titik interaksi untuk pekerjaan Anda, seperti stasiun absensi atau garasi kendaraan.

4. Menetapkan Seragam dan Kendaraan

Konfigurasikan seragam kerja dan kendaraan di qb-pakaian dan qb-garasimasing-masing.

Menguji Pekerjaan Baru Anda

1. Mulai Server

Pastikan server Anda berjalan tanpa kesalahan.

2. Menambahkan Pekerjaan ke Database

Anda harus memberikan tugas kepada pemain untuk mengujinya.

• Menggunakan Perintah Dalam Game:bashCode kopieren/setjob [playerID] pengiriman 0
• Entri Basis Data LangsungMemperbarui pekerjaan pemain dalam database jika perlu.

3. Verifikasi Fungsionalitas Pekerjaan

• Periksa Penugasan Pekerjaan:
  • Buka menu pemutar Anda untuk memastikan pekerjaan ditetapkan dengan benar.
• Uji Status Saat Bertugas:
  • Jam masuk jika defaultDuty adalah salah.
• Periksa Pembayaran Upah:
  • Tunggu siklus pembayaran untuk mengonfirmasi pembayaran gaji.
• Menguji Tindakan Spesifik Pekerjaan:
  • Mencoba mengakses kendaraan kerja atau memulai misi.

Masalah Umum dan Pemecahan Masalah

Pekerjaan Tidak Muncul atau Dapat Ditugaskan

• Periksa Nama PekerjaanPastikan nama pekerjaan di jobs.lua sama persis ketika menetapkannya.
• Sinkronisasi Basis DataJika Anda mengedit database secara manual, pastikan untuk memulai ulang server atau sumber daya.

Upah Tidak Dibayarkan

• Status Saat BertugasKonfirmasikan bahwa pemain sedang bertugas jika offDutyPay adalah salah.
• Sumber Daya GajiPastikan skrip gaji berjalan dan dikonfigurasi dengan benar.

Izin Tidak Berfungsi

• Parameter isBossVerifikasi bahwa isBoss diatur untuk nilai yang benar.
• Konflik Sumber DayaPeriksa konflik dengan skrip lain yang mengelola izin.

Kesalahan saat Memulai Server

• Kesalahan SintaksisPeriksa koma, tanda kurung, atau sintaks yang salah di jobs.lua.
• Ketergantungan Sumber DayaPastikan semua sumber daya yang diperlukan dimulai dalam urutan yang benar.

Kesimpulan

Membuat pekerjaan khusus di QBCore memungkinkan Anda untuk memperluas peluang roleplay server Anda secara signifikan. Dengan mengikuti panduan ini, Anda sekarang dapat menambahkan pekerjaan baru, mengatur upah, mengonfigurasi izin, dan memecahkan masalah umum. Para pemain Anda akan menghargai peran baru dan kedalaman yang mereka tambahkan ke dalam pengalaman bermain game.

Untuk tutorial dan sumber daya lainnya, kunjungi qbcore.net dan bergabunglah dengan forum komunitas kami untuk mendapatkan dukungan dan kolaborasi.