Selamat datang di tutorial langkah demi langkah tentang cara membuat item kustom di QBCoreyang merupakan kerangka kerja populer untuk server roleplay FiveM. Panduan ini akan memandu Anda melalui seluruh proses, mulai dari mendefinisikan item di shared.lua
untuk membuat ikon untuk inventaris Anda. Mari kita mulai!
Daftar Isi
Pendahuluan
Item khusus meningkatkan pengalaman bermain peran dengan menambahkan elemen unik ke server Anda. Baik Anda memperkenalkan makanan, senjata, atau benda-benda lain yang baru, panduan ini akan membantu Anda mengintegrasikannya dengan mulus ke dalam server QBCore Anda.
Memahami Sistem Item QBCore
Dalam QBCore, item didefinisikan dalam file Lua bersama yang dapat diakses oleh server dan klien. Setiap item memiliki atribut spesifik seperti nama, label, berat, jenis, gambar, dan lainnya. Memahami atribut-atribut ini sangat penting untuk membuat item yang fungsional dan seimbang.
Membuat Item Baru di shared.lua
Menemukan lokasi shared.lua
Mengajukan
The shared.lua
adalah tempat semua definisi item disimpan. Anda dapat menemukannya di direktori berikut:
[qb] > qb-core > shared > items.lua
Catatan: Beberapa versi mungkin memiliki file bernama
shared.lua
atauitems.lua
.
Struktur Definisi Item
Sebuah item dalam QBCore didefinisikan menggunakan tabel Lua dengan kunci tertentu. Berikut adalah struktur umumnya:
["nama_barang"] = {
["nama"] = "nama item",
["label"] = "Label Item",
["weight"] = 0,
["type"] = "item",
["image"] = "itemimage.png",
["unik"] = false,
["dapat digunakan"] = true,
["shouldClose"] = true,
["dapat digabungkan"] = nihil,
["description"] = "Deskripsi Item"
},
- nama: Pengenal yang digunakan dalam skrip.
- label: Menampilkan nama dalam inventaris.
- berat badan: Bobot item (diatur ke 0 jika tidak digunakan).
- jenis: Biasanya diatur ke
"item"
. - gambar: Nama file dari ikon item.
- unik:
benar
jika item tersebut unik (tidak dapat ditumpuk). - dapat digunakan:
benar
jika barang tersebut dapat digunakan. - shouldClose:
benar
untuk menutup inventaris setelah digunakan. - dapat dikombinasikan: Menentukan apakah item dapat digabungkan dengan item lainnya.
- Deskripsi: Deskripsi singkat mengenai item tersebut.
Menambahkan Item Kustom Anda
- Buka
items.lua
ataushared.lua
Gunakan editor teks seperti Visual Studio Code atau Notepad++ untuk membuka file. - Tambahkan Definisi Item AndaMenyisipkan definisi item Anda di dalam item yang sudah ada. Misalnya: luaCode kopieren
["minuman_energi"] = { ["name"] = "minuman_energi", ["label"] = "Minuman Energi", ["weight"] = 500, ["type"] = "item", ["image"] = "minuman_energi.png", ["unique"] = false, ["useable"] = true, ["shouldClose"] = true, ["combined"] = nihil, ["description"] = "Sekaleng minuman energi yang menyegarkan." },
- Pastikan bahwa nama item Anda (
"minuman_energi"
) adalah unik dan menggunakan garis bawah alih-alih spasi. - File gambar (
"energy_drink.png"
) harus sesuai dengan ikon yang akan Anda tambahkan nanti.
- Pastikan bahwa nama item Anda (
- Menyimpan FileSetelah menambahkan item Anda, simpan file
items.lua
ataushared.lua
file.
Menambahkan Ikon Item ke UI Inventaris
Menemukan atau Membuat Ikon
Menggunakan Gambar yang Sudah Ada
- Sumber Daya Online:Pastikan Anda memiliki hak untuk menggunakan gambar, dengan mempertimbangkan lisensi.
Membuat Ikon Anda Sendiri
- Alat Desain Grafis:
- Adobe Photoshop
- GIMP (alternatif gratis)
- Canva (alat bantu online)
- Tips:
- Gunakan latar belakang transparan (format PNG).
- Jaga agar desain tetap konsisten dengan ikon yang ada.
Format dan Ukuran Gambar yang Didukung
- Format: PNG direkomendasikan untuk dukungan transparansi.
- Ukuran: Biasanya 64×64 piksel, tetapi periksa ikon item yang ada untuk mengetahui konsistensinya.
Menempatkan Ikon di Direktori yang Benar
- Arahkan ke Folder UI Inventaris:cssCode kopieren
[qb] > qb-inventaris > html > gambar
- Tambahkan Ikon Anda:
- Tempatkan gambar ikon Anda (mis,
minuman_energi.png
) ke dalamgambar
folder. - Pastikan nama file cocok dengan
"gambar"
dalam definisi item Anda.
- Tempatkan gambar ikon Anda (mis,
- Perbarui Sumber Daya:
- Jika server Anda sedang berjalan, Anda mungkin perlu memulai ulang
qb-inventory
sumber daya atau memulai ulang server secara keseluruhan.
- Jika server Anda sedang berjalan, Anda mungkin perlu memulai ulang
Menguji Barang Baru Anda
- Mulai ServerPastikan server Anda berjalan tanpa kesalahan.
- Berikan Diri Anda BarangnyaGunakan konsol dalam game atau menu admin untuk memberikan item:bashCode kopieren kepada diri Anda sendiri
/giveitem [YourPlayerID] minuman_energi 1
- Periksa Inventaris:
- Buka inventaris Anda.
- Pastikan bahwa item muncul dengan ikon, label, dan deskripsi yang benar.
- Gunakan Item:
- Cobalah untuk menggunakan item tersebut jika masih dapat digunakan.
- Memastikannya berperilaku seperti yang diharapkan.
Masalah Umum dan Pemecahan Masalah
- Item Tidak Muncul:
- Periksa kembali nama item dan pastikan nama tersebut telah ditambahkan dengan benar ke
items.lua
. - Pastikan file gambar berada di direktori yang benar dan sesuai dengan nama dalam definisi item.
- Periksa kembali nama item dan pastikan nama tersebut telah ditambahkan dengan benar ke
- Ikon Tidak Ditampilkan:
- Pastikan file gambar dalam format PNG dan ditempatkan di folder
gambar
folder. - Konfirmasikan nama file yang sama persis, termasuk sensitivitas huruf.
- Pastikan file gambar dalam format PNG dan ditempatkan di folder
- Kesalahan saat Memulai Server:
- Periksa konsol server untuk pesan kesalahan.
- Pastikan tidak ada kesalahan sintaksis dalam
items.lua
(misalnya, koma atau tanda kurung yang hilang).
Kesimpulan
Membuat item khusus di QBCore meningkatkan keunikan server Anda dan pengalaman pemain. Dengan mengikuti panduan ini, Anda sekarang dapat menambahkan item baru, menetapkan ikon, dan memecahkan masalah umum.