Ledger – La API de Economía Completa para Hytale

La solución económica tipo Vault que los servidores de Hytale necesitan.

Ledger proporciona una API de economía unificada y estandarizada que permite a los desarrolladores de plugins integrar fácilmente características económicas sin preocuparse por los detalles de implementación. Así como Vault lo hizo para Minecraft, Ledger lo hace para Hytale.

Características Clave

Para Propietarios de Servidores

• Sin Configuración Requerida – Funciona directamente con valores predeterminados sensatos
• Múltiples Opciones de Almacenamiento – JSON para simplicidad, SQLite para rendimiento
• Registro de Transacciones – Registro completo de toda la actividad económica
• Moneda Personalizable – Define tu propio nombre de moneda, símbolo y decimales
• Comandos Basados en Permisos – Control detallado sobre quién puede hacer qué

Para Desarrolladores de Plugins

• API Sencilla – Depositar, retirar, transferir en solo unas pocas líneas de código
• Completamente Asíncrono – Todas las operaciones devuelven CompletableFuture para llamadas no bloqueantes
• Sistema de Eventos – Eventos PreTransacción, PostTransacción, CambioDeSaldo
• Soporte para Múltiples Monedas – Registra y gestiona múltiples monedas
• Cacheo de Cuentas – Cacheo incorporado para un rendimiento óptimo

Comandos

Comando	Descripción	Permiso
/balance	Consulta tu saldo	ledger.balance
/pay <jugador> <cantidad>	Envía dinero a otro jugador	ledger.pay
/baltop	Ver a los jugadores más ricos	ledger.baltop
/eco give/take/set	Gestión económica para administradores	ledger.admin
/ledger reload	Recargar configuración	ledger.admin.reload

Inicio Rápido para Desarrolladores

// Obtener el servicio de economía
EconomyService economy = Ledger.getEconomyOrThrow();

// Consultar saldo
economy.getBalance(playerUuid).thenAccept(balance -> {
    System.out.println("Saldo: " + balance);
});

// Depositar dinero
economy.deposit(playerUuid, 100.0);

// Retirar dinero
economy.withdraw(playerUuid, 50.0);

// Transferir entre jugadores
economy.transfer(senderUuid, receiverUuid, 25.0);

Configuración

Todas las configuraciones son personalizables a través de config.json:

• Nombre de la moneda, símbolo y decimales
• Saldo inicial para nuevos jugadores
• Límites de saldo mínimo y máximo
• Límites de transacción y tiempos de espera
• Tipo de almacenamiento (JSON o SQLite)
• Registro de transacciones activado/desactivado

¿Por Qué Elegir Ledger?

Estandarización – Una API para todos los plugins de economía. No más problemas de compatibilidad.

Rendimiento – Construido con operaciones asíncronas y cacheo desde cero.

Fiabilidad – El registro de transacciones asegura que nunca se pierda dinero.

Extensibilidad – El sistema de eventos permite que otros plugins reaccionen a cambios económicos.

Soporte

¿Encontraste un error? ¿Tienes una solicitud de función?

Visita nuestro repositorio de GitHub

Ledger v1.1.0 – Hecho para la comunidad de Hytale por KarmaByte