Establece límites de inventario en torno a las actividades que los jugadores necesitan completar: suministros ordinarios, equipo de trabajo y una elección significativa sobre la carga extra. El peso, las ranuras y los metadatos de los objetos resuelven problemas diferentes, así que inspecciona tu recurso de inventario real antes de cambiar los valores.
Identifica la implementación del inventario
Registra el recurso/versión del inventario, su integración con el framework y dónde define los objetos, la capacidad del jugador, el almacenamiento del vehículo y los alijos. ESX, QBCore y Qbox no implican un formato de inventario universal. Utiliza el código fuente instalado o la documentación del autor del inventario.
Haz una copia de seguridad de la configuración y los inventarios almacenados. Prueba los cambios en una instancia separada; reducir la capacidad puede dejar los contenedores existentes por encima de su nuevo límite.
Comprende los tres límites
El peso limita la masa total transportada en las unidades del recurso. Las ranuras limitan el número de pilas distintas. Las reglas de apilamiento determinan si los objetos con el mismo nombre y distintos metadatos pueden compartir una ranura. Un contenedor puede quedarse sin ranuras aunque aún tenga margen de peso.
Usa la misma unidad de forma consistente. Si tu inventario usa gramos, un objeto que pesa 500 y una capacidad de 20.000 representan 0,5 kg y 20 kg. Esos números son una ilustración, no una configuración de servidor recomendada.
Crea un equipamiento representativo
Haz una lista de lo que un nuevo jugador necesita para una sesión normal, luego repite para cada trabajo. Calcula la cantidad × el peso del objeto y las ranuras de pila requeridas. Incluye munición, herramientas y consumibles. Prueba el equipamiento en el juego en lugar de depender solo de una hoja de cálculo.
Elige las capacidades del vehículo y del alijo según su propósito. Un vehículo utilitario puede soportar la logística sin obligar a cada jugador a llevar un almacén entero. La población del servidor por sí sola no determina una capacidad de carga sensata.
Edita el recurso que posee la configuración
En las configuraciones de QBCore, las definiciones de objetos compartidos y los límites de contenedores del inventario pueden residir en diferentes recursos. En ox_inventory, las definiciones de objetos ordinarios y las definiciones de armas son preocupaciones separadas. Sigue la estructura de archivos real de tu versión instalada.
No copies un ajuste genérico PlayerMaxWeight, useWeight ni una función de almacén a un archivo a menos que ese recurso los utilice. Busca la clave y su uso en el código fuente. Conserva los nombres y el comportamiento de los objetos existentes al cambiar el límite previsto.
Conservar metadatos
Los números de serie, la durabilidad, la munición y los accesorios son específicos de la implementación. Verifica los rangos y los nombres de los campos antes de cualquier conversión; una escala de durabilidad de 0 a 1 no es intercambiable con una de 0 a 100. Conserva los objetos únicos por separado e informa de los campos desconocidos en lugar de eliminarlos.
Una migración de inventario necesita un convertidor versionado para el esquema de origen y destino exactos, con recuentos y metadatos comparados antes y después. No ejecutes SQL genérico contra tablas de objetos de jugador adivinadas.
Prueba la capacidad y la persistencia
- Añade y elimina una cantidad conocida; confirma que el peso mostrado y el aplicado coinciden.
- Llena las ranuras con pilas distintas, luego prueba una pila coincidente y un objeto con metadatos diferentes.
- Prueba las transferencias entre el jugador, el vehículo y el alijo cuando cualquiera de los destinos esté lleno. Confirma que el fallo no pierde ni duplica objetos.
- Vuelve a conectar y reinicia el servidor de prueba. Comprueba las cantidades, la propiedad y los metadatos.
- Prueba un contenedor existente por encima de la nueva capacidad propuesta y decide cómo los jugadores pueden recuperarse sin eliminar objetos.
Implementa cambios comprensibles
Explica los límites cambiados y ofrece a los jugadores una forma de reorganizar el almacenamiento existente. Observa las transferencias rechazadas, los objetos transportados con frecuencia y los comentarios de los jugadores. Ajusta el cuello de botella específico en lugar de aumentar repetidamente todas las capacidades.
Documentación de referencia
Fuente: qbcore-fivem/qb-inventory · Fuente: overextended/ox_inventory