Cassaforte

Una API de abstracción de plataforma para plugins de Hytale, que proporciona interfaces de economía, permisos y chat.

Descripción general

Cassaforte ofrece una capa de abstracción limpia para plugins de Hytale, similar a cómo funcionan otras APIs de plataforma para diferentes implementaciones de servidor. Permite que los plugins interactúen con sistemas de economía, permisos y chat a través de una interfaz unificada.

Características

• API de Economía: Gestión de saldo, depósitos, retiros y soporte bancario
• API de Permisos: Gestión de permisos de jugadores y grupos
• API de Chat: Formateo de prefijos/sufijos y nodos de información de jugadores/grupos
• Identificación basada en UUID: Soporte completo para jugadores offline
• Java 25: Java moderno sin dependencias en tiempo de ejecución
• API Limpia: Interfaces puras con clases base abstractas

Instalación

Agrega Cassaforte como una dependencia en tu proyecto Gradle:

dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

dependencies {
		implementation 'com.github.Filocava99:Cassaforte:0.1.0'
	}

Uso

API de Economía

import it.cassaforte.api.economy.Economy;
import it.cassaforte.api.economy.EconomyResponse;
import java.util.UUID;

public class MyPlugin {
    private final Economy economy;

    public MyPlugin(Economy economy) {
        this.economy = economy;
    }

    public void depositPlayer(UUID playerId, double amount) {
        EconomyResponse response = economy.depositPlayer(playerId, amount);
        if (response.transactionSuccess()) {
            // Manejar éxito
        }
    }

    public double getBalance(UUID playerId) {
        return economy.getBalance(playerId);
    }
}

API de Permisos

import it.cassaforte.api.permission.Permission;
import java.util.UUID;

public class MyPlugin {
    private final Permission permission;

    public MyPlugin(Permission permission) {
        this.permission = permission;
    }

    public boolean hasPermission(UUID playerId, String node) {
        return permission.playerHas(playerId, node);
    }

    public boolean addToGroup(UUID playerId, String groupName) {
        return permission.playerAddGroup(playerId, groupName);
    }
}

API de Chat

import it.cassaforte.api.chat.Chat;
import java.util.UUID;

public class MyPlugin {
    private final Chat chat;

    public MyPlugin(Chat chat) {
        this.chat = chat;
    }

    public String getFormattedPlayerName(UUID playerId, String playerName) {
        String prefix = chat.getPlayerPrefix(playerId);
        String suffix = chat.getPlayerSuffix(playerId);
        return prefix + playerName + suffix;
    }
}

Estructura del Proyecto

it.cassaforte.api/
├── economy/
│   ├── Economy.java              # Interfaz principal de economía
│   ├── AbstractEconomy.java      # Implementación base
│   └── EconomyResponse.java      # Respuesta de operación
├── permission/
│   └── Permission.java           # Interfaz de permisos
└── chat/
    └── Chat.java                 # Interfaz de formateo de chat

Construcción

./gradlew build

Requisitos

• Java 25
• Gradle 9.0+
• API del Servidor Hytale

Licencia

LGPL-3.0-or-later

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Pull Request.