Construye inventarios modulares sin atar tu juego a una sola arquitectura.

Cada objeto es un ItemDefinition. Esto permite reutilizar la misma definición en pickups, recetas, loot tables, inventarios y equipamiento.

Acciones incluidas

↔

Arrastrar y soltar

Mueve, intercambia y combina pilas. También funciona entre el inventario y otro contenedor.

½

Dividir pilas

Usa Shift + clic para separar la mitad en el primer slot disponible.

•••

Menú contextual

El clic derecho muestra las acciones disponibles para ese objeto.

i

Tooltip

Muestra nombre, descripción, rareza, estadísticas, peso y valor al pasar el cursor.

Personalizar el tema

Crea un tema desde Assets → Create → ModularInventoryPro → UI Theme. Puedes cambiar colores, tamaños, separación y sprites, o aplicarlo en ejecución:

uiManager.SetTheme(miTema);

Esta referencia explica qué debes asignar en el Inspector y qué ocurre si dejas un campo vacío.

Qué archivos conviene modificar

Añade InventorySaveManager junto al inventario y asigna Inventory, Database y una Save Key única.

El formato incluye índice de slot, Item ID, cantidad, Instance ID, durabilidad, durabilidad máxima y Custom Data. Al cargar, las definiciones se resuelven desde Item Database; si un ID ya no existe, ese slot se omite y Unity muestra un aviso.

// Guardado manual en PlayerPrefs
saveManager.Save();
saveManager.Load();

// Persistencia durante la sesión
saveManager.PersistBetweenScenes = true;

// Empezar una partida nueva sin el inventario de la sesión anterior
saveManager.ClearSessionData();

// Almacenamiento personalizado
string json = saveManager.SaveToString();
saveManager.LoadFromString(json);

Serializador personalizado

public class MySerializer : IInventorySerializer
{
    public string Serialize(InventorySaveData data) { /* ... */ }
    public InventorySaveData Deserialize(string json) { /* ... */ }
}

saveManager.Serializer = new MySerializer();

Escucha los eventos estáticos desde código o añade InventoryEventRelay para conectarlos desde el Inspector sin escribir código.

InventoryEvents.OnItemAdded += (item, qty) =>
    Debug.Log($"Añadido: {qty}x {item.Definition.displayName}");

InventoryEvents.OnItemRemoved += (item, qty) => { };
InventoryEvents.OnItemMoved += (item, from, to) => { };
InventoryEvents.OnInventoryFull += inventory => { };
InventoryEvents.OnItemUsed += item => { };

Acción personalizada

[CreateAssetMenu(menuName = "MyGame/Actions/Teleport")]
public class TeleportAction : ItemAction
{
    public Vector3 destination;

    public override void Execute(ItemInstance item, InventorySystem inventory)
    {
        inventory.transform.position = destination;
    }
}

Proveedor de inventario personalizado

public class MyCustomProvider : IInventoryProvider
{
    // Implementa capacidad, slots, añadir, eliminar y validaciones.
}

inventorySystem.SetProvider(new MyCustomProvider());

Usa datos personalizados de ItemInstance para propiedades únicas como nombre generado, nivel, encantamiento o propietario.

instance.SetCustomData("quality", "masterwork");
string quality = instance.GetCustomData("quality", "normal");

Checklist antes de publicar tu juego

• Todos los Item IDs son únicos y no cambiarán.
• La Item Database incluye cada objeto utilizado.
• Los prefabs de pickup y contenedor tienen Collider.
• Cada Canvas interactivo tiene Graphic Raycaster y existe un EventSystem.
• Las Save Keys son únicas o compartidas de forma intencionada.
• Has probado cambio de escena, inventario lleno, pilas máximas y carga de una partida anterior.
• Los materiales funcionan en el render pipeline elegido.
• Los scripts de Demo que no uses se han sustituido por los sistemas definitivos de tu juego.