EconomyAPI

EconomyAPI

Una base económica ligera y amigable para desarrolladores para servidores de Hytale.

EconomyAPI es una utilidad fundamental diseñada para manejar el “trabajo pesado” de la gestión de divisas. Proporciona un sistema centralizado para almacenar, recuperar y modificar los saldos de los jugadores, permitiendo que otros mods se centren en características como tiendas, subastas o reclamaciones de terrenos sin preocuparse por un sistema de dinero centralizado.

🎮 Para Jugadores

Por sí mismo, este mod es una Biblioteca/Dependencia. No añade ítems ni bloques al mundo del juego. Probablemente lo necesites porque otro mod que disfrutas (como un mod de Tienda o Comercio) lo utiliza para gestionar el dinero.

Comandos Disponibles:

Comando
Descripción
Permiso

/balance (jugador)
/bal
Consulta el saldo de alguien
ninguno

/setbalance <jugador> <cantidad>
/setbal
Establece el saldo de un jugador a un valor específico.
economy.admin.setbalance

/economyapi
/economy
/eco

Consulta los créditos de este mod
ninguno

/baltop
Consulta los 5 jugadores más ricos en tu servidor
ninguno

Puedes ganar dinero matando mobs.

📦 Instalación

Descarga el EconomyAPI.jar.

Colócalo en la carpeta mods de tu servidor.

Reinicia el servidor.

Mods que utilizan esta API

• SimpleGambler
• ¡Haz que tu mod aparezca aquí! Solo mándame un mensaje.

👨‍💻 Para Desarrolladores

¡Deja de reinventar la rueda! Usa EconomyAPI como la única fuente de verdad para la divisa de tu servidor.

¿Por qué usar esta API?

• Almacenamiento Persistente: Guarda automáticamente en un archivo balances.json en la carpeta de datos del plugin.
• Seguro para UUID: Utiliza el sistema UUID de Hytale para asegurar que los datos persistan incluso si los jugadores cambian de nombre.
• Acceso Fácil: Integración sencilla a través de nuestra API.

Ejemplo de Implementación:

import com.sennecoolgames.economyapi.EconomyAPI; 
import com.sennecoolgames.economyapi.EconomyInterface; 

EconomyInterface eco = EconomyAPI.getApi();

// obtener saldo
double wallet = eco.getBalance(player.getUuid());

// establecer saldo
eco.setBalance(player.getUuid(), amount);

// depositar (añadir dinero)
eco.deposit(player.getUuid(), amount);

// retirar (quitar dinero) (Devuelve false si el usuario no tiene suficiente dinero)
if (eco.withdraw(playerRef.getUuid(), amount)) {
    doSomething()
} else {
    commandContext.sendMessage(Message.raw("¡No tienes suficiente dinero!"));
}

Próximamente

• Tienda
• Registro de transacciones
• Permisos adecuados para compatibilidad con luckperms