Configuración

Toda la configuración está en config.lua, el único archivo que no está protegido con escrow. Cada opción está comentada en el propio archivo.

General

Opción	Por defecto	Descripción
Config.Locale	'en'	Idioma de la interfaz: 'en' o 'es'
Config.Framework	'auto'	'auto', 'esx', 'qb', 'qbx' o 'none'
Config.Inventory	'auto'	'auto', 'ox', 'qb', 'esx' o 'native'
Config.Key	'TAB'	Tecla por defecto. Cada jugador puede cambiarla en las teclas de FiveM
Config.AutoConfigureInventory	false	ox_inventory: aplicar automáticamente los ajustes recomendados

Comportamiento

Opción	Por defecto	Descripción
Config.TapTime	200	Milisegundos dentro de los que soltar cuenta como toque
Config.QuickHolster	true	Un toque enfunda el arma de la mano y la vuelve a sacar
Config.WeaponAnimations	false	Reproducir las animaciones de enfundar y desenfundar de ox_inventory (hasta 1,4 s cada una)
Config.MouseSensitivity	2.5	Rapidez con la que el ratón mueve la selección
Config.Scale	1.0	Tamaño de la rueda. 0.8 es un 20 % más pequeña
Config.Blur	false	Desenfocar el juego detrás de la rueda
Config.ZIndex	999	Dibujar la rueda por encima de las interfaces de otros recursos

Armas

Opción	Por defecto	Descripción
Config.HideNativeWheel	true	Ocultar y desactivar la rueda de armas de GTA
Config.ShowUnarmed	true	Incluir Desarmado en la sección de cuerpo a cuerpo
Config.ShowEmptyCategories	true	Mostrar en gris las secciones sin armas
Config.Categories	orden de GTA	Secciones y grupos de armas de GTA que contienen
Config.WeaponCategory	{}	Mover armas concretas a otra sección
Config.Images	nil	Sustituir la ruta de los iconos de armas y objetos

Objetos y contenedores

Opción	Por defecto	Descripción
Config.Items	true	Activar la rueda de objetos
Config.ItemCategories	8 categorías	Qué objetos pertenecen a cada categoría
Config.ItemBlacklist	objetos de dinero	Objetos que nunca aparecen en la rueda
Config.Actions	todas activas	{ use = true, give = true, drop = true }
Config.GiveDistance	3.0	Distancia máxima, en metros, para dar un objeto
Config.Containers	true	Pestaña de maletero, guantera y suelo
Config.ContainerWeaponsCategory	'ammo'	Categoría que agrupa las armas guardadas, mostrada como Armas y munición. false para desactivarlo
Config.Hotbar	true	Mostrar la hotbar de 1 a 5
Config.HotbarTime	5	Segundos que la hotbar sigue visible al cerrar la rueda

Notificaciones y sonido

Opción	Por defecto	Descripción
Config.NotifyPosition	'top-right'	'top-right', 'top-left' o 'top-center'
Config.NotifyTime	4	Segundos que una notificación permanece en pantalla
Config.Notify	nil	Tu propia función de notificaciones (ver abajo)
Config.Sounds	true	Sonidos de la interfaz
Config.SoundVolume	0.12	Volumen, de 0.0 a 1.0
Config.CanOpen	comprobaciones de muerte y ocupado	Tus propias condiciones antes de abrir (ver abajo)

Categorías de objetos

Un objeto se coloca en la primera categoría que incluya su nombre en items o cuyos patterns coincidan con él. Los patrones son patrones de Lua aplicados al nombre del objeto en minúsculas. Los objetos que no coinciden con ninguna categoría van a la última, así que conviene mantener una categoría general al final.

config.lua

{ id = 'medical', items = { 'bandage', 'medikit', 'mi_botiquin' }, patterns = { 'bandage', 'med' } },

Para renombrar una categoría, o poner nombre a una que añadas, usa label. Sin él, el texto sale del idioma elegido:

config.lua

{ id = 'drugs', label = 'Drogas', items = { 'weed', 'coke' }, patterns = { '^weed', 'coke' } },

Las secciones de armas también admiten label.

Secciones de armas

Cada sección agrupa grupos de armas de GTA. Para mover un arma concreta sin cambiar los grupos:

config.lua

Config.WeaponCategory = {
    ['WEAPON_FLAREGUN'] = 'throwables',
}

Condiciones para abrir

Config.CanOpen se ejecuta cada vez que se pulsa la tecla. Devuelve false para impedir que la rueda se abra, por ejemplo con tus propios sistemas de muerte o esposas:

config.lua

Config.CanOpen = function()
    local state = LocalPlayer.state
    if state.dead or state.isDead or state.invBusy then return false end
    if state.handcuffed then return false end
    return true
end

Notificaciones

La rueda incluye sus propias notificaciones. Para usar el sistema de notificaciones de tu servidor, define Config.Notify. Recibe el mensaje, el tipo ('success', 'warning', 'error' o 'inform') y, cuando el mensaje se refiere a un objeto, su nombre:

config.lua

Config.Notify = function(message, kind, item)
    exports.ox_lib:notify({ description = message, type = kind })
end

Iconos

Los iconos se toman de la carpeta de imágenes del propio inventario. Si tus imágenes están en otro sitio, indica la ruta, donde %s es el nombre del objeto o del arma:

config.lua

Config.Images = 'nui://mi-inventario/html/images/%s.png'

Idioma

La interfaz está disponible en inglés y español mediante Config.Locale. Los nombres de las categorías se pueden cambiar con label, como se muestra arriba. Para otro idioma, contacta con nosotros en Discord.