Uso

Las tres ventanas#

Inventory tiene una ventana para los jugadores y dos para los administradores, y conviene saber desde el principio cuál es cuál:

Un administrador con ambos permisos cambia entre el creador y la configuración con las pestañas Creator / Settings de la parte superior. El creador se abre en su pestaña Stats: lo que se ha creado recientemente, con qué script, y cualquier alerta.

Casi nada se configura en archivos. Cada ajuste se edita en el juego, se guarda en la base de datos y sobrevive a las actualizaciones. Las listas de ítems y armas aún se pueden escribir en archivos si lo prefieres — consulta Ítems más abajo.

Con qué arranca un servidor nuevo#

En el primer arranque se escriben en el creador cuatro puntos de ejemplo, listos para editar o eliminar:

La configuración empieza con tres rarezas (common, epic, legendary), nueve modelos de máquinas expendedoras que venden bebidas, café y golosinas, seis modelos de contenedores de basura con botín, un punto de reparación de armas y los tamaños de maletero de cada clase de vehículo de GTA. Se escriben una sola vez; eliminarlos nunca los recupera.

El inventario#

Pulsa TAB. Lo que se abre junto a tus bolsillos depende de dónde estés, comprobado en este orden:

1. En un vehículo: su guantera.

2. Detrás de un vehículo abierto: su maletero (delante en los coches con motor trasero). Un vehículo cerrado lo indica.

3. Junto a una bolsa en el suelo: ese botín.

4. Junto a un contenedor de basura: su botín.

5. En una máquina expendedora (sin target): su tienda.

6. En cualquier otro lugar: tu inventario y el Ground, donde todo lo que arrastres se convierte en una bolsa en el suelo.

Los stashes, tiendas, mesas de crafteo y puntos de venta creados en el creador se abren con E en el punto, o con el ojo de target cuando target está activado. Los jugadores pueden caminar con el inventario abierto; la cámara, apuntar y atacar están bloqueados.

Teclas#

Estas son las teclas iniciales. Cada una es una asignación de teclas de FiveM, así que cada jugador puede cambiar las suyas en ESC → Settings → Key Bindings → FiveM. Las teclas iniciales del servidor están en Settings → Key binds.

Mover ítems#

Arrastra un ítem a una ranura. Sobre el mismo ítem se apila; sobre uno distinto, se intercambian. La casilla de cantidad de la parte superior de la columna central decide cuántos se mueven: un número mueve esa cantidad y divide la pila en una ranura vacía; 0 lo mueve todo. Los ítems únicos y las armas nunca se apilan.

Settings → Interaction → Right click on an item cambia el clic derecho entre Smart, Always move, Use y Off. Los botones de la columna central aceptan un ítem arrastrado sobre ellos:

Search, debajo de tu cuadrícula, atenúa cada ranura que no coincide, en ambas columnas; ignora mayúsculas y acentos y encuentra los ítems renombrados por su nuevo nombre. Sort apila todo lo que se puede apilar y ordena el resto desde la ranura 6 — primero las armas, luego por orden alfabético — sin tocar las ranuras 1–5.

Hotbar y rueda rápida#

Cada jugador elige el aspecto de las cinco ranuras rápidas en el estudio de estilos: una Bar que Z hace aparecer en la parte inferior de la pantalla, o una Wheel como la rueda de armas de GTA: mantén Z, apunta a una ranura con el ratón o el stick derecho y suelta para usarla. La rueda muestra el nombre y la cantidad del ítem, o la munición y las estadísticas del arma. A pie, el jugador se queda quieto mientras está abierta; en un vehículo solo se detiene la cámara, así que se puede seguir conduciendo.

Settings → Item rules → Items blocked on keys 1-6 (una ganzúa por defecto) solo se pueden usar desde el inventario, y Settings → Vehicles decide si los ítems y las armas se pueden usar dentro de vehículos.

La tarjeta del ítem#

Al pasar el ratón sobre un ítem se muestra su tarjeta: su nombre (o el nombre que le dio el jugador), su descripción y sus datos — el DNI con el nombre y la fecha de nacimiento de su titular, el teléfono con su número, la bolsa con sus ranuras, el arma con su número de serie, munición y accesorios. Los datos que muestra cada ítem se configuran en Settings → Item rules → Item descriptions, con una vista previa en directo.

La tarjeta de un arma también muestra su daño, cadencia de fuego, precisión, alcance y cargador, comparados con el arma que tienes en las manos: la que sostienes es una barra pálida detrás, y la diferencia se muestra en verde cuando es mejor y en rojo cuando es peor. En la ranura, la línea inferior es el estado del ítem — verde, luego naranja por debajo del 50% y rojo por debajo del 25% — y el color de fondo es su rareza.

El estudio de estilos#

El botón Settings dentro del inventario abre el estudio de estilos, donde cada jugador diseña su propio inventario. Cada cambio se ve en directo, en una vista previa dibujada con los propios ítems del jugador. Cancel restaura lo que tenía, Restore original vuelve al estilo por defecto del servidor.

Presets son 12 estilos completos, cada uno con sus propios colores, forma de casilla, efectos y acabado:

Free mode cambia cada parte a mano:

A la izquierda, el jugador también elige el diseño Full o el Compact — una columna estrecha en un lado de la pantalla que le permite seguir caminando — y la esquina donde aparecen las notificaciones de ítems. Las elecciones se guardan en el propio PC del jugador. Con qué empieza un jugador nuevo se configura en Settings → Default appearance, y Settings → Interface → Show the Settings button puede fijarlo para todos.

Ítems#

Un ítem se puede crear de dos formas, y ambas pueden usarse a la vez. Un ítem del creador con el mismo nombre que uno del archivo lo reemplaza, y eliminar el ítem del creador recupera la versión del archivo.

['tosti'] = {
    ['name'] = 'tosti',                     -- unique id, same as the key
    ['label'] = 'Grilled Cheese Sandwich',
    ['weight'] = 200,                       -- grams
    ['type'] = 'item',                      -- 'item' or 'weapon'
    ['image'] = 'tosti.png',                -- file in web/dist/images, or a link
    ['unique'] = false,                     -- true: never stacks
    ['useable'] = true,
    ['shouldClose'] = true,                 -- closes the inventory when used
    ['description'] = 'Nice to eat',
    ['decay'] = 0.07,                       -- days from 100% to 0%
    ['delete'] = false,                     -- remove it when used broken
    ['object'] = 'prop_sandwich_01',        -- prop on the ground
    ['disableThrow'] = true,
    ['client'] = {
        status = { hunger = 200000 },       -- 1000000 = 100%
        usetime = 2500,
        anim = { dict = 'mp_player_inteat@burger', clip = 'mp_player_int_eat_burger_fp' },
        prop = { model = 'prop_cs_burger_01', pos = vec3(0.02, 0.02, -0.02), rot = vec3(0.0, 0.0, 0.0) },
        disable = { move = true, car = true, mouse = false, combat = true },
        removeAfterUse = true
    }
},

Rarezas#

Una rareza colorea la parte inferior de la ranura, y los jugadores pueden añadir un contorno a juego en el estudio de estilos. Se incluyen tres — common (gris), epic (morado) y legendary (dorado) — y Settings → Item rules → Rarities admite hasta 30 propias, cada una con un nombre y un color. Asigna una rareza a un ítem en el creador, o con rare en el archivo.

Durabilidad y deterioro#

Cada ítem tiene un estado de 100 a 0. Un ítem con decay lo pierde con el tiempo, se use o no: el número son los días que tarda en pasar del 100% al 0%, contados desde el momento en que se creó el ítem. 1 dura un día, 0.5 doce horas, 0.07 alrededor de una hora y cuarenta minutos; 0 nunca se deteriora. El estado se actualiza cada vez que se abre un inventario.

A 0, el ítem está estropeado y no se puede usar. Con delete (Delete when broken), un ítem estropeado desaparece cuando alguien intenta usarlo. Con Settings → Item rules → Throw away spoiled items activado, también desaparece por sí solo: al abrir el inventario y en una comprobación periódica de los jugadores conectados (Check online players every, 5 minutos por defecto), y se avisa al jugador. Los ítems en distinto estado no se apilan. Las armas, en cambio, se desgastan al disparar — consulta Armas.

Renombrar ítems#

Un jugador hace clic en uno de sus propios ítems, escribe un nombre (hasta 64 caracteres) y confirma. A partir de entonces, la tarjeta, la búsqueda y Sort usan el nuevo nombre. Las armas no se pueden renombrar. Settings → Item rules decide si se permite renombrar, cuánto cuesta en efectivo y qué ítems conservan su nombre (money y phone por defecto).

Combinar ítems#

Suelta un ítem sobre otro y, si el destino lo acepta, aparece un botón Combine: se usa uno de cada y se entrega la recompensa, con una animación y una barra de progreso opcionales.

['combinable'] = {
    accept = { 'aluminumoxide' },    -- items that can be dropped on this one
    reward = 'thermite',             -- what the player gets
    anim = { ['dict'] = 'anim@amb@business@weed@weed_inspecting_high_dry@', ['lib'] = 'weed_inspecting_high_base_inspector', ['text'] = 'Mixing powder..', ['timeOut'] = 10000 }
},

Límites de carga e ítems protegidos#

Armas#

Las armas son ítems del inventario. Usar una la desenfunda, y volver a usarla la enfunda; la rueda de armas propia de GTA se sustituye por la hotbar. Cada arma recibe un número de serie, conserva la munición cargada al guardarla y se desgasta al disparar.

Munición#

La munición es un ítem. Úsala, o pulsa R con el arma en la mano, y se carga la primera munición compatible de tu inventario:

Por defecto, un ítem de munición llena un cargador, y un arma nunca lleva más de un cargador. Settings → Weapons cambia ambas cosas: One magazine at a time desactivado permite que cada recarga añada un cargador completo extra, y One bullet per ammo item hace que cada ítem sea una sola bala. La tabla Ammo items vincula cualquier ítem a cualquier tipo de munición de GTA.

Descargar. Selecciona una de tus armas con balas y pulsa Unload en las acciones: las balas vuelven al inventario como su ítem de munición. El servidor cuenta lo que está realmente cargado. Cuando un ítem de munición es un cargador entero, solo salen cargadores enteros y el resto se queda en el arma. El bidón de gasolina, el extintor y las bolas de nieve no se pueden descargar.

Desgaste y reparación#

Cada disparo resta 0.15% del estado de un arma — unos 667 disparos de nueva a rota — configurable por arma en Settings → Weapons → Wear per weapon. La pistola eléctrica, la porra y la linterna nunca se desgastan. Un arma rota se guarda y no se puede usar hasta repararla:

• Repair kit (weapon_repairkit): con el arma en la mano, cada kit restaura un 10% (Repair kit restores).

• Repair points: colócate en uno con el arma en la mano y pulsa E para devolverla al 100% por un precio en efectivo según el tipo de arma — desde $1,000 para pistolas hasta $10,000 para armas pesadas. Los puntos se añaden en tu posición en Settings → Weapons → Repair points.

La pantalla de accesorios#

Haz clic en un arma y pulsa Attachments. El arma aparece delante del jugador con sus detalles — calibre, número de serie, munición y estado — y un punto por cada pieza que admite: supresor, linterna, mira, cañón, empuñadura, cargador y tinte, unidos al arma con líneas. Debajo se listan los accesorios que lleva el jugador compatibles con esta arma.

• Montar: arrastra un accesorio a su punto. Se monta al instante y se ve en el arma. Usar el ítem del accesorio con el arma en la mano también lo monta.

• Quitar: arrastra un accesorio montado a Remove attachment y vuelve al inventario.

• Girar: arrastra el arma. ESC o Back vuelve al inventario.

Qué ítem encaja en qué arma lo define la tabla Attachment items de Settings → Weapons, y el componente de cada arma se configura en la pestaña Weapons del creador.

Tintes#

Ocho tintes de color sirven para todas las armas — negro, verde, dorado, rosa, militar, LSPD, naranja y platino — junto a acabados de camuflaje y de lujo. El ítem tinte personalizado (weapontint_url) pinta un arma con cualquier imagen: úsalo, pega un enlace, revisa la vista previa y guarda. Con Tints are single-use activado, un tinte se gasta al quitarlo o reemplazarlo en lugar de volver al inventario.

Arrojadizas#

Las granadas, los cócteles molotov, las bombas lapa, las bengalas, el humo y el gas BZ, las bombas caseras, las minas de proximidad y las pelotas gastan un ítem cada vez que se saca uno. La lista está en Settings → Weapons → Throwable weapons.

Armas add-on#

Creator → Weapons → Create new da a conocer al inventario un arma cargada por su propio resource: su ítem, munición, desgaste y accesorios. Edit an existing weapon hace lo mismo con una integrada; eliminar el registro más tarde restaura la original.

Settings → Vehicles → Weapons usable inside vehicles desactiva los disparos desde vehículos guardando las armas dentro de ellos.

La ropa como ítems#

Lo que lleva puesto un personaje se guarda como ítems: la ropa se puede quitar, guardar, vender, intercambiar o regalar. El botón Clothing abre una pantalla con el personaje en el centro y una ranura para cada prenda a su alrededor, cada una unida con una línea a su lugar en el cuerpo.

• Ponerse: arrastra una prenda del inventario a su ranura, o usa el ítem.

• Quitarse: arrástrala de vuelta al inventario, o pulsa la mano de su ranura.

• Volver: el botón Back o ESC vuelve al inventario.

La ropa comprada en una tienda de ropa o cambiada en un menú de apariencia se convierte en ítems por sí sola: una prenda distinta del atuendo por defecto se convierte en su ítem en uno o dos segundos. Un chaleco da 100 de armadura la primera vez que se pone (Settings → Clothing → Vest armour) y conserva la armadura que le quedaba al quitárselo. La ropa puesta se guarda al cerrar el inventario. La pantalla de ropa necesita un personaje freemode y no se puede abrir en un vehículo.

Stashes, maleteros y el suelo#

Stashes#

Creator → Stashes → Create new coloca un stash para una casa, una banda, un trabajo o la comisaría:

Eliminar un punto de stash lo quita del mundo, pero lo que guardaron los jugadores se queda en la base de datos. Otros scripts pueden abrir cualquier stash por id — consulta Integraciones.

Maleteros y guanteras#

Cada vehículo tiene un maletero, que se abre desde detrás de un coche abierto, y una guantera, que se abre desde un asiento. Las guanteras admiten 100 kg en 5 ranuras; los maleteros dependen de la clase de vehículo de GTA:

Settings → Vehicles cambia cada clase, da a modelos concretos su propio tamaño (Use my vehicle rellena el que ocupas), y lista los coches con motor trasero cuyo maletero se abre por delante. También decide quién abre qué: por defecto, cualquiera abre cualquier maletero y guantera; si se desactiva, un coche con dueño solo se abre para su dueño y para la policía a partir del rango que elijas. Los maleteros de los coches cuya matrícula contiene PLZI solo se abren para la policía. Only owned cars keep their items deja de guardar los maleteros de los coches sin dueño.

El suelo#

Arrastra un ítem a la columna Ground y se convierte en una bolsa en el suelo — el propio prop del ítem cuando está solo, una bolsa de papel cuando hay varios, el modelo del arma si es un arma. Las bolsas admiten 130 ranuras, se ven desde 9.5 m y desaparecen 15 minutos después de que nadie las toque, nunca mientras alguien las tiene abiertas (Settings → Capacity). Con OneSync, las bolsas y los ítems lanzados o colocados se pueden empujar caminando contra ellos y patear con la tecla de ataque sin arma, y se abren dondequiera que acaben.

Ítems contenedor#

Algunos ítems abren su propio pequeño inventario al usarlos, como la caja de cigarrillos que se incluye como ejemplo. Usar uno mantiene el inventario abierto y muestra la caja en la columna derecha; Close container restaura la columna.

• Cada ítem físico es su propia caja: dos cajas de cigarrillos guardan contenidos distintos.

• El contenido inicial de una caja solo se añade la primera vez que se abre. Después, conserva lo que los jugadores dejen dentro.

• Solo puede abrirla el jugador que la lleva, y se cierra sola en cuanto sale de su inventario (tirada, entregada, robada…).

• Abrir una de una pila requiere una ranura libre: primero la caja se separa de la pila.

• Un contenedor nunca entra dentro de sí mismo y, por defecto, tampoco dentro de otro contenedor (Containers inside containers).

Se configuran en Settings → Item rules → Containers: el ítem, un título, ranuras, peso máximo y su contenido inicial. El ítem debe ser utilizable en tu lista de ítems, y es mejor que sea único para que cada caja ocupe su propia ranura. config/storage.lua contiene la misma lista para los servidores que prefieren archivos; lo que se guarda en el panel la reemplaza.

Tiendas, puntos de venta y crafteo#

Tiendas#

Creator → Shops → Create new empieza por el Type: una Shop vende lo que listes, un Buyer compra los ítems de los jugadores al precio que fijes. Se puede cambiar más tarde.

Los jugadores compran arrastrando un producto a sus bolsillos, y la casilla de cantidad decide cuántos; el clic derecho compra uno. Un producto limitado muestra cuántos quedan y "Sold out" al llegar a cero. El peso, las ranuras y el dinero se comprueban antes de cobrar nada. El stock vuelve a empezar lleno cuando el resource se reinicia.

Tiendas de society. Con Players pay with en Society, el dinero sale de la cuenta de society del trabajo del comprador, y solo los trabajos de la lista Access de la tienda, desde su rango mínimo, pueden comprar allí. Una tienda de society sin ningún trabajo en Access no la puede usar nadie. El dinero pasa por esx_society (esx_addonaccount) en ESX, y por qb-banking, Renewed-Banking o qb-management en QBCore y Qbox, el que esté iniciado.

Settings → Interaction → Sell points desactivado cierra todos los compradores: ninguno se abre y no se puede vender nada.

En un comprador, cada tarjeta muestra el precio, cuántos tiene el jugador y el total; soltar el ítem sobre su tarjeta lo vende, y se paga en la cuenta del comprador.

Mesas de crafteo#

Creator → Crafting → Create new: un nombre de mesa, un prop y hasta 100 recetas. Cada receta es el ítem que se craftea, cuántos, el tiempo de crafteo, la probabilidad de éxito y hasta 30 ingredientes. En QBCore y Qbox una receta también puede otorgar y requerir reputación de crafteo (Settings → Crafting).

En la mesa, cada tarjeta de receta muestra un tic verde cuando el jugador lo tiene todo y una cruz roja cuando falta algo, el tiempo y la probabilidad, y cada ingrediente como tienes / necesitas. Fija la cantidad y arrastra la receta a tu inventario para craftearla. El servidor vuelve a comprobar los ingredientes cuando se acaba el tiempo y tira la probabilidad por su cuenta. Los ingredientes se gastan aunque falle la probabilidad. Con Settings → Crafting → Allow cancelling crafting activado, el jugador puede cancelar la barra de progreso, y no se quita nada hasta que termina.

Máquinas expendedoras y contenedores de basura#

Las máquinas expendedoras son props del mapa: pulsa TAB junto a una, o usa el ojo de target. Settings → Vending machines contiene las categorías — productos con precio, máximo por compra y stock opcional, la cuenta con la que se pagan y el tiempo de reposición — y qué modelos de máquina venden cada categoría. Su interruptor Vending machines desactivado cierra todas las máquinas: con target la opción se oculta; sin él, el inventario se abre como siempre.

Los contenedores de basura funcionan igual. Cada modelo en Settings → Garbage tiene sus ranuras y uno o más conjuntos de botín; una búsqueda elige un conjunto al azar, y aparece botín nuevo 2 minutos después.

Colocar un punto#

Los stashes, tiendas, puntos de venta y mesas comparten los mismos paneles. En Placement, pulsa Here para usar el lugar donde estás, o Select para apuntar a un lugar a hasta 60 m:

En el mundo, los jugadores abren un punto con E a menos de 2 m, bajo un pequeño marcador flotante cuando no hay ped ni prop, o con el ojo de target cuando target está activado. Cada fila de la lista tiene un botón Teleport para ir allí. Las distancias y la velocidad de colocación están en Settings → Creator points.

Intercambiar, lanzar y colocar#

Intercambiar. Pulsa Trade y elige un jugador a menos de 3 m. Recibe una tarjeta con el nombre de quien lo pide y una cuenta atrás de 30 segundos: E acepta, G rechaza. Después, ambos comparten una ventana con cinco ranuras de oferta cada uno, donde cada ítem que se pone se ve en directo en la otra pantalla. El intercambio solo se produce cuando ambos confirman, y el servidor comprueba que cada ítem ofrecido está realmente en el inventario de cada jugador antes de mover nada.

Lanzar. Arrastra un ítem a Throw, o pulsa H para el arma en la mano. Apunta con el clic derecho y lanza con el clic izquierdo, una unidad cada vez; Backspace cancela. Cae como un prop que todos ven, y se recoge con E.

Colocar. Arrastra un ítem a Place: una silueta suya sigue tu punto de mira. Gíralo en tres ejes con las teclas que se muestran en pantalla y pulsa el clic izquierdo para dejarlo; si apuntas a un vehículo, se mueve con él. Cualquiera cerca lo recoge con E.

Cada uno tiene su interruptor en Settings → Interaction, que también puede delegar el lanzamiento en jonska-itemthrowing y la colocación en kq_placeable_items.

Robo y policía#

X levanta las manos. Un jugador que abre el inventario a menos de 3 m de alguien con las manos arriba — o muerto, con Loot dead players activado — mientras empuña un arma obtiene un botón Steal. Tras una breve barra de progreso, el inventario de la víctima se abre a la derecha, y se avisa a la víctima de que la están robando. /searchplayer abre directamente al jugador más cercano con las manos arriba.

• La ranura protegida — la última, que se usa con la tecla 6 — nunca se muestra a los ladrones. La policía la ve al registrar, salvo que se desactive.

• Los ítems que no se pueden robar se quedan con su dueño.

• Con Robbed weapons can break into parts, un arma robada puede romperse (20% por defecto) en piezas aleatorias para el ladrón.

• Trabajos de policía (police y sheriff) registran sin las reglas de robo y abren maleteros y guanteras restringidos.

Todo ello está en Settings → Robbery & police.

Herramientas de administración#

Give#

Creator → Give entrega cualquier ítem o arma a uno o más jugadores conectados a la vez — hasta 64, ordenados por distancia. Elige el ítem en una cuadrícula con imágenes, luego la cantidad y la calidad; un arma también admite su munición y, si quieres, un número de serie. Los DNI y las licencias se rellenan con los datos del jugador que los recibe. Cada entrega se registra en la lista compartida Recent gives y se envía al webhook de Discord de administración. En las pestañas Items y Weapons, Give it to me es la forma rápida de probar uno.

Estadísticas y alertas antiduplicación#

Cada ítem que entra en el inventario de un jugador se registra con quién lo recibió y quién lo dio: el script que llamó a AddItem, o la acción del inventario — tienda, crafteo, intercambio, admin. Activity lo representa en gráficos de la última hora, día o semana: ítems creados por script, los ítems más creados, qué script los entrega y los últimos ítems entregados.

Las entregas de administradores y las transferencias entre jugadores nunca activan alertas. Se avisa a todos los administradores conectados, la alerta va al webhook de administración y espera en Alerts hasta que se marca como leída. Los límites y los días de historial que se conservan están en Settings → Anti-dupe alerts.

Who has what analiza jugadores conectados y desconectados, stashes, maleteros y guanteras: los ítems con más unidades en circulación, los que poseen más personas y — para cualquier ítem — cada jugador y almacenamiento que lo tiene, con la cantidad.

Extra carry weight#

/inventoryextraweight <id> <kg> da a un personaje peso de carga extra además de Settings → Capacity. Se guarda en la base de datos para ese personaje. Sin kg muestra el valor actual, y 0 lo elimina. Los scripts hacen lo mismo con el export SetPlayerExtraWeight, consulta Comandos y exports.

La configuración#

/inventoryconfig contiene todo el comportamiento, en 17 secciones. Cada campo muestra su valor por defecto y lo que hace; Ctrl+F busca en todos ellos y Ctrl+S guarda.

Estos valores están en tu base de datos, no en un archivo. Un campo marcado como Restart se guarda al instante pero se aplica tras reiniciar el inventario; todo lo demás se aplica a todos los jugadores al guardar. Show advanced settings muestra las opciones de desarrollador, cada sección tiene su propio restablecimiento y todo el panel se puede restablecer escribiendo RESET.