Cara Membuat Item (Kerangka Kerja QBCore)

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!

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 atau items.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

1. Buka items.lua atau shared.luaGunakan editor teks seperti Visual Studio Code atau Notepad++ untuk membuka file.
2. 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.
3. Menyimpan FileSetelah menambahkan item Anda, simpan file items.lua atau shared.lua file.

Menambahkan Ikon Item ke UI Inventaris

Menemukan atau Membuat Ikon

Menggunakan Gambar yang Sudah Ada

• Sumber Daya Online:
  • Flaticon
  • Pencari Ikon
  • OpenGameArt
  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

1. Arahkan ke Folder UI Inventaris:cssCode kopieren[qb] > qb-inventaris > html > gambar
2. Tambahkan Ikon Anda:
   • Tempatkan gambar ikon Anda (mis, minuman_energi.png) ke dalam gambar folder.
   • Pastikan nama file cocok dengan "gambar" dalam definisi item Anda.
3. Perbarui Sumber Daya:
   • Jika server Anda sedang berjalan, Anda mungkin perlu memulai ulang qb-inventory sumber daya atau memulai ulang server secara keseluruhan.

Menguji Barang Baru Anda

1. Mulai ServerPastikan server Anda berjalan tanpa kesalahan.
2. Berikan Diri Anda BarangnyaGunakan konsol dalam game atau menu admin untuk memberikan item:bashCode kopieren kepada diri Anda sendiri/giveitem [YourPlayerID] minuman_energi 1
3. Periksa Inventaris:
   • Buka inventaris Anda.
   • Pastikan bahwa item muncul dengan ikon, label, dan deskripsi yang benar.
4. 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.
• Ikon Tidak Ditampilkan:
  • Pastikan file gambar dalam format PNG dan ditempatkan di folder gambar folder.
  • Konfirmasikan nama file yang sama persis, termasuk sensitivitas huruf.
• 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.