EnergyStorage

La API de Almacenamiento de Energía es una biblioteca ligera centrada en desarrolladores para mods de Hytale. Proporciona un sistema de energía completamente funcional y basado en componentes que otros mods pueden integrar fácilmente en sus máquinas, bloques, entidades o sistemas de juego personalizados. Este mod no añade contenido jugable por sí mismo. En su lugar, expone una API limpia y extensible construida alrededor del ComponentRegistryProxy, ComponentType y BuilderCode oficiales de Hytale, garantizando la máxima compatibilidad y estabilidad entre mods. Utiliza esta biblioteca cuando quieras dar a tus máquinas la capacidad de almacenar, recibir o extraer energía de manera predecible y estandarizada.

⚡ Características

• IEnergyStorage interfaz con soporte completo de simulación
• EnergyStorageComponent utilizando el  BuilderCodec de Hytale
• Serialización y validación automáticas
• Capacidad configurable, tasas máximas de recepción y extracción
• Lógica de transferencia de energía segura y determinista
• Integración fácil con cualquier EntityStore
• Registro limpio de EnergyModule para compatibilidad entre mods
• Diseñado como una dependencia compartida para otros mods

🧩 Ejemplos de Uso

1. Añadiendo un Componente de Energía a una Entidad de Bloque

Java:

EnergyStorageComponent energy = new EnergyStorageComponent(
    0,        // energía inicial
    50000,    // capacidad máxima
    2000,     // recepción máxima por tick
    2000      // extracción máxima por tick
);

blockEntity.addComponent(
    EnergyModule.get().getEnergyComponentType(),
    energy
);

Json:

{
    "components": {
        "energystorage:energy": {
            "EnergyStored": 2500,
            "MaxEnergy": 10000,
            "MaxReceive": 1000,
            "MaxExtract": 500
        }
    }
}

2. Recibiendo Energía

long inserted = energy.receiveEnergy(1000, false);
System.out.println("Inserted: " + inserted);

Modo de simulación (sin mutación):

long possible = energy.receiveEnergy(1000, true);

3. Extrayendo Energía

long extracted = energy.extractEnergy(500, false);
System.out.println("Extracted: " + extracted);

4. Comprobando el Estado del Almacenamiento

if (energy.isFull()) {
    System.out.println("¡El almacenamiento está lleno!");
}

if (energy.isEmpty()) {
    System.out.println("¡El almacenamiento está vacío!");
}

float ratio = (float) energy.getEnergyStored() / energy.getMaxEnergyStored();

5. Accediendo al Tipo de Componente (para otros mods)

ComponentType<EntityStore, EnergyStorageComponent> type =
        EnergyModule.get().getEnergyComponentType();

🛠️ ¿Para Quién Es Esto?

Esta biblioteca está destinada exclusivamente a desarrolladores que quieran:

• Construir máquinas que almacenen o transfieran energía
• Crear sistemas de automatización
• Implementar generadores, baterías, cables o redes eléctricas
• Compartir un estándar de energía común entre múltiples mods

Si tu mod necesita energía, esta API te proporciona una base limpia y estable.