EcotaleCoins – Physical Currency

Artículos de monedas físicas y sistema bancario para la economía de Ecotale. Los jugadores recolectan monedas en el mundo y las almacenan en el banco.

Capturas de pantalla

Interfaz del Banco

Monedas Físicas

Características

Moneda Física

6 denominaciones de monedas – COBRE, HIERRO, COBALTO, ORO, MITRIL, ADAMANTITA
Caídas del mundo – Las monedas caen de los mobs cuando EcotaleJobs está instalado
Desglose óptimo – Los valores grandes se convierten automáticamente a las denominaciones más altas
Sistema de recogida – Camina sobre las monedas para recogerlas

Sistema Bancario

Almacenamiento seguro – El saldo del banco es separado de las monedas del inventario
Depositar/Retirar – Convertir entre el banco y las monedas físicas
Intercambiar – Convertir entre denominaciones de monedas
Consolidar – Combinar monedas pequeñas en monedas más grandes

API

API de proveedor completa para otros plugins
Dejar caer monedas en posiciones de entidades
Manejo seguro de transacciones

Instalación

Instala Ecotale primero

Descarga EcotaleCoins-1.0.0.jar

Coloca en tu carpeta mods/ de Hytale

Inicia el servidor

Comportamiento en el Primer Inicio

En la primera instalación, el plugin extrae los activos de monedas a mods/Ecotale_EcotaleCoins/. Esto crea un paquete de activos que Hytale debe cargar.

El servidor se reiniciará automáticamente una vez después de extraer los activos. Este es un comportamiento esperado – Hytale requiere un reinicio para registrar nuevos paquetes de activos.

[EcotaleCoins] Configuración de primera vez detectada. Reiniciando el servidor para cargar activos...

Después del reinicio, las monedas funcionarán normalmente. Esto solo sucede una vez.

Comandos

Comando
Descripción
Permiso

/bank
Abrir interfaz del banco
Todos los jugadores (modo aventura)

/bank deposit <cantidad|todo>
Depositar monedas en el banco
Todos los jugadores (modo aventura)

/bank withdraw <cantidad|todo>
Retirar monedas del banco
Todos los jugadores (modo aventura)

Permisos

Permiso
Descripción
Predeterminado

ecotale.ecotalecoins.command.bank
Acceso a los comandos /bank
Todos los jugadores (modo aventura)

Importante: Comportamiento de Sobrescritura de LuckPerms

Si instalas LuckPerms, los comandos estarán bloqueados para todos los jugadores hasta que otorgues permisos:

# Otorgar acceso al banco a todos los jugadores
/lp group default permission set ecotale.ecotalecoins.command.bank true

# Verificar permiso
/lp user <nombre_de_usuario> permission check ecotale.ecotalecoins.command.bank

Personalización

Todos los activos de monedas se extraen a mods/Ecotale_EcotaleCoins/ y pueden ser modificados.

Personalización de Textura

Ubicado en Common/Items/Currency/Coins/:

Archivo
Descripción

Coin_Copper.png
Textura de moneda de cobre (64×64)

Coin_Iron.png
Textura de moneda de hierro

Coin_Cobalt.png
Textura de moneda de cobalto

Coin_Gold.png
Textura de moneda de oro

Coin_Mithril.png
Textura de moneda de mitril

Coin_Adamantite.png
Textura de moneda de adamantita

Para personalizar: Reemplaza cualquier PNG con tu propia textura de 64×64 y reinicia el servidor.

Personalización de Modelo

Archivo
Descripción

Coin.blockymodel
Modelo 3D de moneda caída

Coin_Held.blockymodel
Modelo de moneda en mano/inventario

Personalización de Icono

Ubicado en Common/Icons/Items/Coins/ – estos aparecen en la interfaz de usuario del inventario.

Valores de Monedas

Moneda
Valor Base
Valor Relativo

COPPER
1
1 moneda

IRON
10
10 cobre

COBALT
100
10 hierro

GOLD
1,000
10 cobalto

MITHRIL
10,000
10 oro

ADAMANTITE
100,000
10 mitril

Configuración

Nota: EcotaleCoins no tiene un archivo de configuración. Los valores de las monedas están definidos en el enum CoinType.java y no pueden ser cambiados sin recompilar.

Si necesitas valores de monedas configurables, envía una solicitud de función o modifica CoinType.java:

public enum CoinType {
    COPPER("Coin_Copper", 1, "Cobre"),
    IRON("Coin_Iron", 10, "Hierro"),
    COBALT("Coin_Cobalt", 100, "Cobalto"),
    GOLD("Coin_Gold", 1_000, "Oro"),
    MITHRIL("Coin_Mithril", 10_000, "Mitril"),
    ADAMANTITE("Coin_Adamantite", 100_000, "Adamantita");
    // ...
}

Uso de la API

import com.ecotale.api.EcotaleAPI;
import com.ecotale.api.PhysicalCoinsProvider;

// Verificar si el complemento de monedas está disponible
if (EcotaleAPI.isPhysicalCoinsAvailable()) {
    PhysicalCoinsProvider coins = EcotaleAPI.getPhysicalCoins();

    // Dejar caer monedas en la posición de la entidad
    coins.dropCoinsAtEntity(entityRef, store, commandBuffer, 500L);
}

Construcción desde la Fuente

Requisitos: Coloca los JAR en la carpeta libs/: