Een item maken (QBCore Framework)

Welkom bij deze stap-voor-stapcursus over het maken van een aangepast item in QBCore, een populair framework voor FiveM roleplay servers. Deze gids leidt je door het hele proces, van het definiëren van het item in gedeeld.lua om een pictogram voor je inventaris te maken. Laten we beginnen!

Inleiding

Aangepaste voorwerpen verbeteren de roleplay-ervaring door unieke elementen aan je server toe te voegen. Of je nu nieuw voedsel, wapens of diverse voorwerpen introduceert, deze handleiding helpt je ze naadloos te integreren in je QBCore-server.

Het itemsysteem van QBCore begrijpen

In QBCore worden items gedefinieerd in een gedeeld Lua-bestand dat toegankelijk is voor zowel de server als de client. Elk item heeft specifieke attributen zoals naam, label, gewicht, type, afbeelding en meer. Inzicht in deze attributen is cruciaal voor het maken van functionele en uitgebalanceerde items.

Een nieuw item maken in gedeeld.lua

De gedeeld.lua Bestand

De gedeeld.lua bestand is waar alle itemdefinities zijn opgeslagen. Je kunt het vinden in de volgende map:

[qb] > qb-kern > gedeeld > items.lua

Opmerking: Bij sommige versies heeft het bestand de naam gedeeld.lua of items.lua.

Item Definitie Structuur

Een item in QBCore wordt gedefinieerd met behulp van een Lua-tabel met specifieke sleutels. Dit is de algemene structuur:

["itemnaam"] = {
    ["naam"] = "artikelnaam",
    ["label"] = "Item Label",
    ["weight"] = 0,
    ["type"] = "item",
    ["image"] = "itemimage.png",
    ["uniek"] = false,
    ["bruikbaar"] = waar,
    ["shouldClose"] = true,
    ["combineerbaar"] = nil,
    ["description"] = "Beschrijving item".
},

• naam: Identificatiecode gebruikt in scripts.
• label: Weergavenaam in de inventaris.
• gewicht: Itemgewicht (ingesteld op 0 indien niet gebruikt).
• type: Gewoonlijk ingesteld op "item".
• afbeelding: Bestandsnaam van het pictogram van het item.
• uniek: Echt als het item uniek is (kan niet worden gestapeld).
• bruikbaar: Echt of het item gebruikt kan worden.
• moetSluiten: Echt om de inventaris te sluiten na gebruik.
• combineerbaar: Bepaalt of het item gecombineerd kan worden met andere items.
• beschrijving: Een korte beschrijving van het item.

Je aangepaste item toevoegen

1. Open items.lua of gedeeld.lua:Gebruik een teksteditor zoals Visual Studio Code of Notepad++ om het bestand te openen.
2. Je objectdefinitie toevoegen:Voeg uw itemdefinitie in binnen de bestaande items. Bijvoorbeeld:luaCode kopieren[energy_drink"] = { ["name"] = "energy_drink", ["label"] = "Energy Drink", ["weight"] = 500, ["type"] = "item", ["image"] = "energy_drink.png", ["unique"] = false, ["useable"] = true, ["shouldClose"] = true, ["combinable"] = nil, ["description"] = "Een blikje verfrissende energiedrank." },
   • Zorg ervoor dat je itemnaam ("energie_drank") is uniek en gebruikt underscores in plaats van spaties.
   • Het afbeeldingsbestand ("energie_drank.png") moet overeenkomen met het pictogram dat je later zult toevoegen.
3. Het bestand opslaan:Sla na het toevoegen van je item de items.lua of gedeeld.lua bestand.

Het itempictogram toevoegen aan de voorraadinterface

Een pictogram zoeken of maken

Bestaande afbeeldingen gebruiken

• Online bronnen:
  • Flaticon
  • Icoonzoeker
  • OpenGameArt
  Zorg ervoor dat je het recht hebt om de afbeeldingen te gebruiken en overweeg licenties.

Je eigen pictogram maken

• Grafisch ontwerp:
  • Adobe Photoshop
  • GIMP (gratis alternatief)
  • Canva (online hulpmiddel)
• Tips:
  • Gebruik een transparante achtergrond (PNG-indeling).
  • Houd het ontwerp consistent met bestaande pictogrammen.

Ondersteunde afbeeldingsindelingen en -formaten

• Formaat: PNG wordt aanbevolen voor ondersteuning van transparantie.
• Maat: Meestal 64×64 pixels, maar controleer bestaande pictogrammen voor items op consistentie.

Het pictogram in de juiste directory plaatsen

1. Navigeer naar de map Inventory UI:cssCode kopieren[qb] > qb-inventaris > html > afbeeldingen
2. Uw pictogram toevoegen:
   • Plaats je pictogramafbeelding (bijv, energie_drank.png) in de afbeeldingen map.
   • Zorg ervoor dat de bestandsnaam overeenkomt met de "afbeelding" veld in je objectdefinitie.
3. Bron bijwerken:
   • Als uw server draait, moet u mogelijk de qb-inventaris bron of herstart de server volledig.

Je nieuwe artikel testen

1. De server startenControleer of uw server zonder fouten draait.
2. Geef jezelf het item:Gebruik de in-game console of een adminmenu om jezelf het item:bashCode kopieren/giveitem [YourPlayerID] energy_drink 1
3. Controleer de inventaris:
   • Open je inventaris.
   • Controleer of het item wordt weergegeven met het juiste pictogram, label en beschrijving.
4. Gebruik het item:
   • Probeer het voorwerp te gebruiken als het bruikbaar is.
   • Zorg ervoor dat het zich gedraagt zoals verwacht.

Veelvoorkomende problemen en probleemoplossing

• Item verschijnt niet:
  • Controleer de naam van het item en zorg ervoor dat het correct is toegevoegd aan items.lua.
  • Controleer of het afbeeldingsbestand in de juiste map staat en overeenkomt met de naam in de objectdefinitie.
• Pictogram wordt niet weergegeven:
  • Zorg ervoor dat het afbeeldingsbestand de PNG-indeling heeft en in de afbeeldingen map.
  • Controleer of de bestandsnaam exact overeenkomt, inclusief hoofdlettergevoeligheid.
• Fouten bij het starten van de server:
  • Controleer de serverconsole op foutmeldingen.
  • Controleer of er geen syntaxfouten zijn in items.lua (bijvoorbeeld ontbrekende komma's of haakjes).

Conclusie

Aangepaste voorwerpen maken in QBCore verbetert het unieke karakter van je server en de spelerservaring. Als je deze handleiding volgt, kun je nu nieuwe items toevoegen, pictogrammen toewijzen en veelvoorkomende problemen oplossen.