HyVoltz

HyVoltz es una API de electricidad ligera para mods de Hytale. La API se llama HyVoltz; la unidad de energía que maneja se llama voltz. Todas las utilidades de almacenamiento, transferencia y E/S lateral funcionan en voltz.

Características

• Interfaces de almacenamiento y transferencia de voltz
• Configuración de E/S lateral por cara de bloque
• Ayudantes de transferencia conscientes de la simulación
• Implementaciones de referencia simples para una integración rápida

Descripción general de la API

Paquete: com.siriuswolf.hyvoltz.api.power

Tipos principales (almacenar/transferir voltz):

• PowerConsumer (recibir)
• PowerProvider (extraer)
• PowerStorage (ambos + capacidad)

E/S lateral:

• PowerSide se asigna a BlockFace de Hytale
• PowerConnection define NINGUNO / ENTRADA / SALIDA / AMBOS
• SidedPowerAccess / MutableSidedPowerAccess para configuración por lado
• SidedPowerConsumer, SidedPowerProvider, SidedPowerStorage para E/S controladas por lado

Implementaciones de referencia:

• SimplePowerStorage para capacidad y E/S con límite de tasa
• SidedPowerConfig para estado de conexión por lado
• SidedPowerStorageImpl combina ambos para un uso fácil

Ayudantes:

• PowerTransfer para transferencia segura con soporte de simulación

Uso básico

Crea un almacenamiento de estilo capacitor simple (10,000 voltz):

import com.siriuswolf.hyvoltz.api.power.*;

public final class BasicCapacitor extends SidedPowerStorageImpl { public BasicCapacitor() { super(10_000, 200, 200, new SidedPowerConfig(PowerConnection.BOTH)); } }

Transfiere voltz entre dos almacenamientos:

int moved = PowerTransfer.transfer(source, PowerSide.EAST, target, PowerSide.WEST, 100, false);

Consejo: ¡Realmente prefiero shadowjar, échale un vistazo para las compilaciones!

Dependencia de la API del servidor

El proyecto está dirigido a la última API del servidor de Hytale. Actualiza la ruta del jar del servidor en build.gradle.kts si tu instalación es diferente:

...game/latest/Server/HytaleServer.jar

Notas de integración

• Agrega HyVoltz al classpath de tu mod y referencia la API desde com.siriuswolf.hyvoltz.api.power.
• Si tu mod se carga junto a HyVoltz como un plugin separado, decláralo como una dependencia en tu manifiesto.

Licencia

Apache 2.0. Consulta https://www.apache.org/licenses/LICENSE-2.0
(Esto solo significa que no puedes venderlo, y requiere atribución, por favor no lo llames tuyo. ¡Pero haz lo que quieras con él, diviértete y crea cosas geniales!)