Introducción

Asset para Unity que permite añadir un sistema de inventarios y drag and drop a cualquier proyecto con cualquier tipo de datos.

Resuelve tareas como:

• mostrar datos en la UI del inventario
• mover objetos entre inventarios
• stacking, swap y transferencia rápida
• sincronizar cambios de UI con los datos del juego
• añadir comprobaciones y reglas para permitir o bloquear transferencias
• crear acciones especiales para inventarios
• menú contextual
• selección múltiple y transferencia múltiple
• trabajo con objetos de forma compleja

Sirve tanto para inventarios UI simples y escenarios como equipamiento, como para lógica más compleja como comercio y comprobaciones de servidor.

Qué es este asset

No es solo un conjunto de slots de UI. A diferencia de muchas alternativas que requieren que tus datos tengan un tipo específico, permite visualizar casi cualquier dato en un inventario:

• ScriptableObject
• modelos runtime
• listas, diccionarios y campos fijos
• distintas representaciones del mismo objeto en distintos inventarios

La idea clave es que el inventario visual está separado de tu modelo de juego.

El sistema tiene muchos puntos de extensión, por lo que puede crecer gradualmente:

• empezar con una mochila y un cofre simples
• reservar algunos slots para equipamiento
• añadir reglas que bloqueen el drag desde un slot o el drop en un slot bajo ciertas condiciones
• convertir tipos de objeto entre inventarios
• implementar comercio, crafting, comprobaciones de servidor y lógica similar

El asset está pensado no solo para empezar rápido, sino también para escalar sin reescribir toda la lógica de inventario.

Warning

Para tus propios tipos de datos normalmente necesitas escribir algo de código de integración.

Conviene entender este coste desde el principio: para tus propios tipos de datos normalmente necesitas escribir algo de código de integración.

Esto permite que el sistema entienda:

• cómo y qué datos obtener de tus clases
• cómo representar tus datos en slots de inventario
• cómo escribir de vuelta en tus modelos los cambios producidos por la UI

Para que cualquier tipo aparezca en slots de inventario, necesitas escribir un adapter: un pequeño puente entre tus datos y el slot.

Normalmente es un adapter pequeño y un DataBinding. Cuanto más complejo sea tu modelo de datos, más gruesa será esta capa de integración, pero drag and drop, swap, stacking, transferencias y flujo de eventos ya los resuelve el asset.

Para varios casos comunes ya existen clases plantilla de DataBinding.

Dependencias

• Paquete obligatorio: Unity.ugui
• Paquete opcional: com.unity.inputsystem

La parte base del asset compila y funciona sin com.unity.inputsystem. El nuevo Input System solo es necesario para funciones construidas alrededor de InputAction. El seguimiento de modalidad pointer/navigation también funciona en proyectos con input legacy.

Modelo básico

Para la mayoría de proyectos conviene tener este modelo en mente:

flowchart LR
    Inventory@{ shape: rounded, label: "<b>Universal Inventory</b>\ngestiona estados de UI, transferencias y distribución de objetos por slots" }

    Slot@{ shape: rounded, label: "<b>Universal Slot</b>\nContiene un adapter y la cantidad del objeto en el slot" }

    Adapter@{ shape: rounded, label: "<b>IItem Adapter</b>\nGuarda una referencia a los datos del objeto" }
    style Adapter fill:#FF44

    Binding@{ shape: rounded, label: "<b>Data Binding</b><br/>sincroniza tus datos con la UI" }
    style Binding fill:#FF44

    Data@{ shape: rounded, label: "Tus modelos de datos" }

    Inventory --> Slot    
    Slot --> Adapter
    Binding <--> Data    
    Inventory <--> Binding

• define IItemAdapter para que el slot pueda guardar tus datos correctamente
• define DataBinding para editar datos según los cambios de UI

Subsistemas

• visualización de datos en inventario
• transferencia entre inventarios
• áreas de drop
• sistema de reglas
• acciones configurables
• auto-transfer
• selección múltiple
• transferencia múltiple
• menú contextual
• ejemplo de tooltip
• ejemplo de conversión de tipos durante transferencia
• ejemplo de inventarios anidados
• ejemplo de objetos de forma compleja

Ver también:

• Quick Start — primer inventario funcional
• Ejemplos — resumen de las 6 demos y su arquitectura
• Data Binding — dónde escribir sync, rules y business hooks
• Feedback — dónde enviar bugs, ideas y problemas de integración