ai-inventory
Inventario en cuadrícula con tamaños de objeto, ranuras rápidas, objetos en el suelo, alijos, maleteros y guanteras, tiendas, fabricación y armas. Responde a las API de ox_inventory y qb-inventory.
ai-inventory es un inventario en cuadrícula: cada objeto ocupa un número de celdas (un teléfono 1x1, un rifle 4x2) y se puede girar al arrastrarlo. Contiene los objetos del jugador, el suelo, los alijos, los maleteros y guanteras de los vehículos, las tiendas y los bancos de fabricación, y las armas como objetos.
Qué hace en el juego
- La cuadrícula. Todos los inventarios tienen el mismo número de columnas; solo cambian las filas y el límite de peso. Los objetos tienen un tamaño en celdas y un peso; el inventario rechaza lo que no cabe o pesa demasiado.
- La pantalla (F2): la ropa del personaje en dos columnas alrededor del personaje, las cinco ranuras rápidas, la cuadrícula del jugador y el segundo inventario (suelo, maletero, alijo, tienda, banco de fabricación) a la derecha. Hacer clic en una prenda la quita o la vuelve a poner.
- Ranuras rápidas. Cinco ranuras propias (no celdas de la cuadrícula). Las teclas 1 a 5 las usan; TAB las muestra como una barra abajo.
- Usar objetos. Doble clic, o el menú del objeto. La comida y la bebida hacen una animación, llenan el hambre y la sed (ai-hud) y se gastan. El servidor comprueba que el objeto sigue ahí después de la animación.
- Dar, tirar, dividir. El menú del objeto lo da al jugador más cercano, lo tira al suelo o divide un montón.
- Objetos en el suelo. Los objetos tirados quedan en una bolsa en el suelo. Tirar junto a tu propia bolsa los añade a ella. Las bolsas desaparecen tras unos minutos sin tocarlas.
- Maleteros y guanteras. F2 en la parte trasera de un vehículo abre su maletero (si está abierto); dentro de un vehículo, su guantera. El maletero de un vehículo en propiedad se queda con el vehículo, lleve la matrícula que lleve; el maletero de cualquier otro vehículo es temporal.
- Alijos. Almacenes en lugares fijos, compartidos o uno por personaje, abiertos a todos o a algunos trabajos y bandas.
- Tiendas. Lugares con productos y precios, un blip en el mapa y un NPC opcional, pagados con efectivo y después con banco (según la configuración).
- Bancos de fabricación. Recetas que convierten materiales en objetos en unos segundos.
- Armas. Las armas son objetos con número de serie. La munición es un objeto; R recarga a partir de ella. Los accesorios (linterna, silenciador...) son objetos que se montan en el arma en la mano. La rueda de armas de GTA está desactivada por defecto: las armas salen de las ranuras rápidas.
- Rarezas. Los objetos pueden pertenecer a una rareza cuyo color tiñe su recuadro.
- Armas de otras fuentes. Un arma que no dio ai-inventory se le quita al jugador.
Instalación
La receta de txAdmin de AI Core lo instala. A mano: pon la carpeta en resources/[ai]/ y añade ensure ai-inventory a server.cfg después de ensure ai-core. Necesita ai-core y la base de datos:
add_convar_permission ai-inventory read mysql_connection_stringLa tabla ai_inventory_inventories se crea en el primer inicio. Las imágenes de los objetos van en la carpeta dist/web/images del recurso (incluye las imágenes de ox_inventory).
Quita ox_inventory y qb-inventory: ai-inventory responde a sus nombres.
Ajustes del panel
Abre el panel de administración (F10) y elige Inventory.
Pestaña Items
Cada objeto que existe en el juego. Cada objeto es un registro; su clave (water, lockpick) es el nombre de objeto que usan los scripts. El script viene con 242 objetos (tomados de las listas de ox_inventory).
Item (objeto): el nombre que ven los jugadores y qué tipo de objeto es.
| Ajuste | Qué cambia | Valores | Por defecto para un objeto nuevo |
|---|---|---|---|
| Name | El nombre que ven los jugadores. | hasta 48 caracteres | |
| Description | Una línea bajo el nombre. | hasta 240 caracteres | |
| Kind | Item, Weapon (se empuña al usarlo), Ammo (recarga el arma en la mano), Attachment (se monta en el arma en la mano). | Item / Weapon / Ammo / Attachment | Item |
| Rarity | Tiñe el recuadro del objeto con el color de una rareza (pestaña Rarities). Vacío: un recuadro normal. | una rareza | ninguna |
| Picture | Nombre de archivo en la carpeta de imágenes (water.png) o un enlace https completo. Vacío muestra un icono. | hasta 200 caracteres | |
| Other names | Nombres que usan otros scripts para este objeto (por ejemplo pistol_ammo), para que sigan funcionando. | hasta 30 nombres |
Size and weight (tamaño y peso): cuántas celdas ocupa el objeto y cuánto pesa.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Width | Celdas de izquierda a derecha. Los jugadores pueden girar un objeto al arrastrarlo. | 1 a 8 celdas | 1 |
| Height | Celdas de arriba abajo. | 1 a 8 celdas | 1 |
| Weight | Gramos por unidad (1000 g = 1 kg). | 0 a 1,000,000 g | 100 |
| Stack size | Máximo de unidades en un montón. 1 separa cada unidad, para objetos con datos propios. | 1 a 100,000 | 10 |
Using (uso): qué pasa cuando un jugador usa el objeto.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Can be used | Desactivado: usarlo no hace nada salvo que un script gestione este objeto. | activado / desactivado | desactivado |
| Used up per use | Unidades que se quitan cada vez que se usa. 0 lo conserva. | 0 a 1000 | 0 |
| Close the inventory | Cierra la pantalla del inventario cuando se usa el objeto. | activado / desactivado | desactivado |
| Animation | Se reproduce mientras se usa. | None / Eat / Drink / Bandage / Put on armour | None |
| Use time | Cuánto dura la animación antes de que el objeto haga efecto. | 0 a 60,000 ms | |
| Hunger | Se suma al hambre del jugador al usarlo (en negativo la baja). Necesita un HUD que lleve las necesidades. | -100 a 100 | |
| Thirst | Se suma a la sed. | -100 a 100 | |
| Stress | Se suma al estrés. | -100 a 100 |
Weapon (arma): solo para armas y accesorios.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Ammo item | Nombre del objeto que carga el arma (por ejemplo ammo-9). | un nombre de objeto | |
| Thrown | Granadas y similares: la cantidad del montón es la munición. | activado / desactivado | desactivado |
| Attachment hashes | Nombres de componente de GTA que puede ser este accesorio (COMPONENT_AT_PI_FLSH); se usa el primero que admita el arma en la mano. | hasta 20 nombres |
Borrar un objeto: los jugadores que lo tienen conservan un montón que nadie puede usar.
Pestaña Rarities
Grupos de color a los que pertenecen los objetos. Incluidos: Common, Uncommon, Rare, Epic, Legendary, Medical, Special.
| Ajuste | Qué cambia | Valores |
|---|---|---|
| Name | El nombre de la rareza. | hasta 32 caracteres |
| Colour | Tiñe el recuadro de cada objeto de esta rareza. | un color |
Borrar una rareza: sus objetos pierden su color.
Pestaña Shops
Lugares donde los jugadores compran objetos. El script viene con 45 tiendas (24/7, LTD, Rob's Liquor, ferreterías, Ammu-Nation y otras, más tiendas de trabajo para policía y EMS).
Shop (tienda): dónde está la tienda y quién puede comprar allí.
| Ajuste | Qué cambia | Valores | Por defecto para una tienda nueva |
|---|---|---|---|
| Shop name | El nombre que ven los jugadores. | hasta 48 caracteres | |
| Place | Ponte donde los jugadores deben abrirla y usa tu posición. | un punto | |
| Reach | A qué distancia debe estar un jugador para abrirla. | 0.5 a 30 m | 2 |
| Jobs | Solo los miembros de estos trabajos pueden usarla. Deja trabajos y bandas vacíos para todos. | nombres de trabajo | vacío |
| Gangs | Los miembros de estas bandas también pueden usarla. | nombres de banda | vacío |
| Only on duty | Los miembros del trabajo deben estar de servicio en ese trabajo. | activado / desactivado | desactivado |
| Map blip | Muestra la tienda en el mapa. | activado / desactivado | activado |
| Blip look | Imagen, color y tamaño del blip (cuando el blip está activado). | sprite, color, tamaño | |
| Paid from | Cuentas de dinero probadas en orden. | hasta 5 cuentas | cash, bank |
Products (productos): los objetos que vende la tienda y su precio por unidad. Hasta 100 filas, cada una con Item y Price (0 a 100,000,000 $).
NPC: un dependiente en la tienda. Model (vacío para ninguno, visible a menos de 50 m), What it does (una animación en reposo), Where it stands (punto del suelo y orientación; sin él, está en el punto de la tienda).
Pestaña Stashes
Almacenes en lugares fijos. Incluido: un Police Locker.
| Ajuste | Qué cambia | Valores | Por defecto para un alijo nuevo |
|---|---|---|---|
| Stash name | El nombre que ven los jugadores. | hasta 48 caracteres | |
| Place | Donde los jugadores lo abren. | un punto | |
| Reach | A qué distancia debe estar un jugador. | 0.5 a 30 m | 1.5 |
| Jobs, Gangs, Only on duty | Quién puede abrirlo (como en las tiendas). | todos | |
| One per character | Activado: cada personaje tiene su propio contenido. Desactivado: todos los que pueden abrirlo comparten uno. | activado / desactivado | desactivado |
| Rows | Filas de celdas; el ancho es el ajuste Columns. | 1 a 50 | 6 |
| Weight limit | Gramos. 0 significa sin límite. | 0 a 10,000,000 g | 100,000 |
Borrar un alijo: los objetos guardados en él se quedan en la base de datos.
Pestaña Crafting
Bancos donde los jugadores convierten materiales en objetos. Incluido: un Workbench.
Bench (banco): Bench name, Place, Reach (por defecto 1.5 m), Jobs, Gangs, Only on duty, como en las tiendas.
Recipes (recetas): hasta 50 filas.
| Ajuste | Qué cambia | Valores | Por defecto para una fila nueva |
|---|---|---|---|
| Makes | El objeto fabricado. | un nombre de objeto | lockpick |
| Amount | Cuántos se fabrican. | 1 a 1000 | 1 |
| Time | Cuánto tarda. | 0 a 600 s | 5 |
| Materials | Lo que usa, como item:count separados por comas: scrapmetal:3, paperbag:1. | hasta 400 caracteres | scrapmetal:3 |
Pestaña Settings
Qué tamaño tienen los inventarios.
| Tarjeta | Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|---|
| Grid | Columns | Celdas por fila en todos los inventarios. Los objetos que ya no caben pasan a celdas libres; un inventario demasiado lleno para eso recibe filas extra. | 6 a 14 | 8 |
| Grid | No GTA weapon wheel | La rueda de armas de GTA y el cambio de arma con la rueda del ratón se quedan desactivados: las armas se sacan de las ranuras rápidas (1-5). | activado / desactivado | activado |
| Player inventory | Rows | Lo que puede llevar un personaje, en filas. | 1 a 50 | 20 |
| Player inventory | Weight limit | Gramos; 0 = sin límite. | 0 a 10,000,000 g | 40,000 |
| Ground | Rows | Tamaño de una bolsa en el suelo. | 1 a 50 | 6 |
| Ground | Weight limit | Gramos; 0 = sin límite. | 0 a 10,000,000 g | 1,000,000 |
| Ground | Disappears after | Los objetos en el suelo desaparecen cuando nadie los ha tocado durante este tiempo. | 1 a 240 min | 15 |
| Ground | Bags per player | Cuántas bolsas puede tener un personaje en el suelo a la vez. | 1 a 100 | 10 |
| Trunk | Rows | El maletero de todos los vehículos. | 1 a 50 | 5 |
| Trunk | Weight limit | Gramos; 0 = sin límite. | 0 a 10,000,000 g | 80,000 |
| Glovebox | Rows | La guantera de todos los vehículos. | 1 a 50 | 2 |
| Glovebox | Weight limit | Gramos; 0 = sin límite. | 0 a 10,000,000 g | 10,000 |
Un cambio de columnas, filas o peso llega al momento a las pantallas abiertas.
Comandos
Ninguno propio. Los administradores dan y quitan objetos con las herramientas de objetos de ai-admin.
Teclas
| Tecla por defecto | Qué hace | Nombre en los ajustes de GTA |
|---|---|---|
| F2 | Abre el inventario (con el suelo, maletero o guantera que tengas al lado) o lo cierra | Open the inventory |
| TAB | Muestra u oculta la barra de ranuras rápidas | Show / hide the quick slots bar |
| 1 a 5 | Usa el objeto de esa ranura rápida | Use the item in quick slot 1 (to 5) |
| R | Recarga el arma en la mano a partir de un objeto de munición | Reload the weapon |
En la pantalla: arrastra para mover, gira el objeto mientras lo arrastras, doble clic para usar, clic derecho para el menú del objeto, Escape o F2 para cerrar.
Funciona con otros scripts
- Sustituye a ox_inventory (
provide, API de ox_inventory 2.44) y a qb-inventory (provide, API 2.0): sus exports responden, así que los scripts de ox y QB dan, quitan y comprueban objetos aquí. Mira la página para desarrolladores para saber qué se responde y qué no. - La capa de inventario de AI Core. Todos los scripts
ai-*y el puente ESX / QB dan y quitan objetos a través de AI Core, que llama a ai-inventory. - Puedes reemplazarlo. AI Core tiene adaptadores para otros inventarios (tgiann-inventory, codem-inventory, core_inventory, origen_inventory, jaksam_inventory y más), cada uno con sus propios límites. Un inventario soportado hace innecesario ai-inventory: AI Core te avisa en la consola de que lo quites. Mira Compatibilidad.
Límites conocidos
- Un uso a la vez por jugador.
- Una bolsa nueva en el suelo está limitada a una por segundo por jugador, al Bags per player del panel y a 50 por zona del mapa. Los resultados de fabricación y los objetos tirados por scripts se saltan estos límites.
- No se pueden tirar objetos desde dentro de un vehículo.
- No se responden los hooks de ox_inventory,
RegisterShopcon la forma de ox ni la confiscación (las tiendas vienen del panel o delRegisterShoppropio de ai-inventory).
ai-appearance para desarrolladores
Los exports de cliente de ai-appearance, la forma de los uniformes de trabajo y los eventos que usa con la pantalla de personajes de AI Core.
ai-inventory para desarrolladores
Los exports de servidor y de cliente de ai-inventory, los objetos usables, las tiendas de script, el evento usedItem y las API de ox_inventory y qb-inventory a las que responde.