Skip to main content

Installation

1. Copiar el recurso​

Copia la carpeta cold_inventory dentro de tu carpeta de recursos, por ejemplo:

resources/[cold_store]/cold_inventory

No cambies el nombre de la carpeta si otros recursos van a consumir sus exports como exports.cold_inventory.

2. Dependencias​

El recurso necesita:

  • oxmysql
  • ox_lib
  • cold_lib
  • Un framework opcional: qbx_core, qb-core o es_extended

El fxmanifest.lua declara estas dependencias:

dependencies {
    'oxmysql',
    'ox_lib',
    'cold_lib',
}

3. Orden en server.cfg​

QBOX​

ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure cold_lib
ensure cold_inventory

QBCore​

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure cold_lib
ensure cold_inventory

ESX​

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure cold_lib
ensure cold_inventory

Standalone / solo​

ensure oxmysql
ensure ox_lib
ensure cold_lib
ensure cold_inventory
warning

Si cold_inventory sustituye a ox_inventory, no añadas ensure ox_inventory. El manifest de cold_inventory ya incluye:

provide 'ox_inventory'

4. Base de datos​

No necesitas importar SQL manualmente. Al iniciar, el recurso crea las tablas que necesita:

  • cold_inventory_meta
  • cold_inventory_players
  • cold_inventory
  • cold_inventory_vehicles
  • cold_inventory_drops
  • cold_inventory_journal
  • cold_inventory_audit
  • cold_inventory_snapshots
  • cold_inventory_preferences
  • cold_inventory_documents

Comprueba que oxmysql puede conectarse correctamente a MySQL/MariaDB antes de arrancar cold_inventory.

5. Seleccionar framework​

Por defecto se usa deteccion automatica:

setr cold_inventory:mode "auto"

En modo auto, el recurso busca en este orden:

  1. qbx_core → qbox
  2. qb-core / qb_core → qbcore
  3. es_extended → esx
  4. Si no encuentra ninguno → solo

Tambien puedes forzarlo:

setr cold_inventory:mode "qbox"
# o qbcore / esx / solo

6. Configuracion base recomendada​

Puedes empezar sin tocar ningun convar: el recurso incluye valores por defecto. Si quieres dejar explicitamente los ajustes principales en server.cfg:

setr cold_inventory:mode "auto"
setr cold_inventory:cells 48
setr cold_inventory:carry 30000
setr cold_inventory:command "inv"
setr cold_inventory:hotbar 1
setr cold_inventory:hotbar_slots 5
setr cold_inventory:persist_drops 1
setr cold_inventory:vehicle_trunks 1
setr cold_inventory:vehicle_gloveboxes 1
setr cold_inventory:save_interval_ms 30000
setr cold_inventory:save_on_disconnect 1

7. Permisos ACE recomendados​

add_ace group.admin cold_inventory.give allow

Este ACE controla por defecto /giveitem y /colditems.

Administracion avanzada​

add_ace group.admin cold_inventory.admin allow

Permite usar:

  • /coldinvhealth
  • /coldinvinspect [serverId]
  • /coldinvfreeze [serverId] [on|off] [motivo]
  • /coldinvrepair [serverId]
  • /coldinvaudit [ownerKey]

Documentos oficiales​

add_ace group.admin cold_inventory.documents allow

Permite usar los comandos de emision y revocacion de documentos.

8. Catalogos de items e imagenes​

Los catalogos editables estan en:

data/items.lua
data/weapons.lua
data/documents.lua

Las imagenes se guardan en:

web/images/

Un item puede indicar su imagen mediante la propiedad image dentro de data/items.lua.

9. Oficina de documentacion​

La oficina NPC para recuperar documentos perdidos se configura en:

config.lua

Viene activada por defecto. Revisa coordenadas, precios, modelo del ped y documentos ofrecidos antes de abrir el servidor al publico.

10. Primer test​

Arranca el servidor y comprueba que no aparecen errores de dependencias o MySQL.

Con un usuario que tenga el ACE cold_inventory.give, prueba:

/giveitem water 5
/giveitem bread 2
/giveitem phone 1
/colditems

Tambien puedes entregar a otro jugador indicando su server ID:

/giveitem 12 water 5

Abre el inventario con:

TAB

o con:

/inv

11. Verificacion final​

Comprueba al menos estos puntos:

  1. El inventario abre con TAB.
  2. Los items entregados aparecen y pueden moverse entre slots.
  3. El jugador conserva sus items despues de reconectar.
  4. Los drops pueden crearse y volver a abrirse.
  5. Un maletero o glovebox se abre al estar en la posicion correcta.
  6. No hay errores SQL en la consola.

Listo.