Funciones y variables importantes

Esta sección detalla las funciones y variables principales utilizadas o expuestas por el script.
Comprender estos elementos te ayudará a personalizar o integrar el script con otros recursos.

Funciones principales

Para configurar el sistema de municiones del rifle de dardos paralizantes, debes implementar la función siguiente que verificará si el jugador tiene munición antes de permitirle disparar.

Verificación de posesión de munición (lado del servidor)

La función se encuentra en la carpeta: /server/opensource.lua.

AddEventHandler(Config.EventHasItem, function(target, cb)
  -- if true
  --  Remove one ammunition item from inventory
  --  cb(true)

  -- if false
  --  cb(false)
end)

Ejemplo de implementación con ox_inventory

Aquí hay un ejemplo de implementación usando ox_inventory:

AddEventHandler(Config.EventHasItem, function(target, cb)
  local src = target or source

  -- Check if the player has at least 1 ammunition
  local count = exports.ox_inventory:Search(src, 'count', 'ammo-dartrifle')

  if count and count > 0 then
    -- Remove 1 piece of ammunition
    local removed = exports.ox_inventory:RemoveItem(src, 'ammo-dartrifle', 1)
    if removed then
      cb(true)
    else
      cb(false)
    end
  else
    cb(false)
  end
end)

En el archivo weapons.lua, agrega las definiciones de elementos para el rifle de dardos paralizantes y sus municiones:

  ['WEAPON_DARTRIFLE'] = {
    label = 'Stun dart rifle',
    weight = 4200,
    durability = 0.5,
    ammoname = 'ammo-dartrifle',
    client = {
      image = 'dart_rifle.png',
    }
  },

En el archivo items.lua, agrega la definición del elemento para la munición del rifle de dardos paralizantes:

  ["ammo-dartrifle"] = {
    label = 'Stun dart rifle ammunition',
    weight = 20,
    stack = true,
    description = 'Dart for stun dart rifle.',
    client = {
      image = 'dart_rifle_ammo.png',
    }
  },

Agrega las imágenes dart_rifle.png y dart_rifle_ammo.png en la carpeta web/images de ox_inventory.

¡Eso es todo! Ahora tienes un sistema de municiones funcional para el rifle de dardos paralizantes.

Mejores prácticas

• Utiliza variables locales (local) para limitar el alcance a la función o script concerniente.