EcotaleCoins - Physical Currency

EcotaleCoins - Physical Currency

Physical coin items and banking system for the Ecotale economy. Players collect coins in the world and store them in the bank.

355.0 загрузок
Обновлён 15 дней назад

Описание

EcotaleCoins - физическая валюта для Hytale

Физические монеты и банковская система для экономики Ecotale. Игроки собирают монеты в мире и хранят их в банке.

Version Author Requires

Скриншоты

Банковский ГУИ

Bank GUI

Физические монеты

Physical Coins

Особенности

Физическая валюта

  • 6 номиналов монет - КОПЕР, Железный, Кобальт, Золотой, МИТРИЛ, АДАМАНТИТ
  • Мир падает Монеты падают из толпы при установке EcotaleJobs
  • Оптимальный срыв Большие значения автоконвертируются в высшие номиналы
  • Система пикапов Прогуляйтесь по монетам, чтобы собрать их

Банковская система

  • Безопасное хранение Банковский баланс отдельно от инвентарных монет
  • Депозит/Вывод Преобразование между банковскими и физическими монетами
  • обмен Преобразование между номиналами монет
  • консолидировать Объедините маленькие монеты в большие

API

  • Полный API провайдера для других плагинов
  • Сбрасывайте монеты на позиции предприятия
  • Безопасная обработка транзакций

установка

  1. устанавливать Экотале первый
  2. скачать EcotaleCoins-1.0.0.jar
  3. Место в твоей сказке модс/ папка
  4. Запустите сервер

Первое поведение стартапа

При первой установке плагин извлекает активы монет для Mods/Ecotale_EcotaleCoins/. Это создает пакет активов, который Hytale должна загрузить.

Сервер автоматически перезагружается после извлечения активов. Это ожидаемое поведение - Hytale требует перезапуска для регистрации новых пакетов активов.

[EcotaleCoins] Впервые обнаружена установка. Перезапуск сервера для загрузки активов

После перезапуска монеты будут работать нормально. Такое случается только один раз.

командование

Командование Описание Разрешение
/ Банк Открыть банк ГУИ Все игроки (приключенческий режим)
/банковский депозит <сумма | все> Депонировать монеты в банк Все игроки (приключенческий режим)
/bank withdraw <сумма> Вывод монет из банка Все игроки (приключенческий режим)

Разрешения

Разрешение Описание по умолчанию
ecotale.ecotalecoins.command.bank Доступ к /банковским командам Все игроки (приключенческий режим)

Оригинальное название: LuckPerms Override Behavior

Если вы устанавливаете LuckPermsКоманды будут заблокированы для всех игроков, пока вы не предоставите разрешения:

# Доступ к банку для всех игроков
/lp group default permission set ecotale.ecotalecoins.command.bank true

# Проверить разрешение
/lp-пользователь <имя пользователя> проверка разрешения ecotale.ecotalecoins.command.bank

кастомизация

Все активы монет извлекаются Mods/Ecotale_EcotaleCoins/ могут быть изменены.

Настройка текстуры

Расположенный в Common/Items/Currency/Coins/:

Файл Описание
Coin_Copper.png Текстура медной монеты (64x64)
Coin_Iron.png Текстура железной монеты
Обсуждение Cobalt.png Текстура кобальтовой монеты
Coin_Gold.png Текстура золотых монет
Coin_Mithril.png Текстура монеты Митрил
Coin_Adamantite.png Текстура адамантитских монет

Для настройки: Замените любой PNG текстурой 64x64 и перезапустите сервер.

Модель кастомизации

Файл Описание
Coin.blockymodel Сброшенная монета 3D модель
Coin_Held.blockymodel Модель монеты для хранения / инвентаризации

Иконная кастомизация

Расположенный в Common/Icons/Items/Coins/ - они появляются в инвентарном интерфейсе.


Ценность монеты

Монета Базовая стоимость Относительная ценность
каппер 1 1 1 монета
Железный 1010 10 медь
Кобальт 100 10 железо
Золото 1000000000 10 кобальт
МИТРИЛ 100.000 10 золотых
АДАМАНТИТ 100 тысяч 10 митхрил

конфигурация

Примечание: Экотале Монеты не имеют конфигурационного файла. Значения монет определяются в CoinType.java Он не может быть изменен без перекомпилирования.

Если вам нужны настраиваемые значения монет, отправьте запрос функции или измените CoinType.java:

Публичный код CoinType
COPPER("Coin_Copper", 1, "Copper"),
IRON("Coin_Iron", 10, "Iron"),
COBALT("Coin_Cobalt", 100, "Cobalt"),
GOLD("Coin_Gold", 1_000, "Gold"),
MITHRIL("Coin_Mithril", 10_000, "Mithril"),
ADAMANTITE("Coin_Adamantite", 100_000, "Adamantite");
//...
?

API использование

импортировать com.ecotale.api.EcotaleAPI;
импортировать com.ecotale.api.PhysicalCoinsProvider;

// Проверьте, доступен ли аддон монет
если (EcotaleAPI.isPhysicalCoinsAvailable()) {
Монеты PhysicalCoinsProvider = EcotaleAPI.getPhysicalCoins();

// Бросьте монеты в позиции предприятия
coin.dropCoinsAtEntity (entityRef, магазин, CommandBuffer, 500L);
?

Строительство из источника

Требования: Поместите JARs в libs/ папка:

  • hytale-server.jar (Hytale выделенный сервер)
  • Экотале-1.0.0.jar (перенаправлено с «Ecotale Project»)
./gradlew jar

Результат: build/libs/EcotaleCoins-1.0.0.jar

Лицензия

Лицензия MIT - 2026 Tera-bytez

Показать оригинальное описание (English)

EcotaleCoins - Physical Currency for Hytale

Physical coin items and banking system for the Ecotale economy. Players collect coins in the world and store them in the bank.

Version Author Requires

Screenshots

Bank GUI

Bank GUI

Physical Coins

Physical Coins

Features

Physical Currency

  • 6 coin denominations - COPPER, IRON, COBALT, GOLD, MITHRIL, ADAMANTITE
  • World drops - Coins drop from mobs when EcotaleJobs is installed
  • Optimal breakdown - Large values auto-convert to highest denominations
  • Pickup system - Walk over coins to collect them

Bank System

  • Secure storage - Bank balance separate from inventory coins
  • Deposit/Withdraw - Convert between bank and physical coins
  • Exchange - Convert between coin denominations
  • Consolidate - Combine small coins into larger ones

API

  • Full provider API for other plugins
  • Drop coins at entity positions
  • Secure transaction handling

Installation

  1. Install Ecotale first
  2. Download EcotaleCoins-1.0.0.jar
  3. Place in your Hytale mods/ folder
  4. Start the server

First Startup Behavior

On first installation, the plugin extracts coin assets to mods/Ecotale_EcotaleCoins/. This creates an asset pack that Hytale must load.

The server will automatically restart once after extracting assets. This is expected behavior - Hytale requires a restart to register new asset packs.

[EcotaleCoins] First-time setup detected. Restarting server to load assets...

After the restart, coins will work normally. This only happens once.

Commands

Command Description Permission
/bank Open bank GUI All players (Adventure mode)
/bank deposit <amount|all> Deposit coins to bank All players (Adventure mode)
/bank withdraw <amount|all> Withdraw coins from bank All players (Adventure mode)

Permissions

Permission Description Default
ecotale.ecotalecoins.command.bank Access to /bank commands All players (Adventure mode)

Important: LuckPerms Override Behavior

If you install LuckPerms, commands will be blocked for all players until you grant permissions:

# Grant bank access to all players
/lp group default permission set ecotale.ecotalecoins.command.bank true

# Verify permission
/lp user <username> permission check ecotale.ecotalecoins.command.bank

Customization

All coin assets are extracted to mods/Ecotale_EcotaleCoins/ and can be modified.

Texture Customization

Located in Common/Items/Currency/Coins/:

File Description
Coin_Copper.png Copper coin texture (64x64)
Coin_Iron.png Iron coin texture
Coin_Cobalt.png Cobalt coin texture
Coin_Gold.png Gold coin texture
Coin_Mithril.png Mithril coin texture
Coin_Adamantite.png Adamantite coin texture

To customize: Replace any PNG with your own 64x64 texture and restart the server.

Model Customization

File Description
Coin.blockymodel Dropped coin 3D model
Coin_Held.blockymodel Held/inventory coin model

Icon Customization

Located in Common/Icons/Items/Coins/ - these appear in the inventory UI.


Coin Values

Coin Base Value Relative Value
COPPER 1 1 coin
IRON 10 10 copper
COBALT 100 10 iron
GOLD 1,000 10 cobalt
MITHRIL 10,000 10 gold
ADAMANTITE 100,000 10 mithril

Configuration

Note: EcotaleCoins does not have a config file. Coin values are defined in CoinType.java enum and cannot be changed without recompiling.

If you need configurable coin values, submit a feature request or modify CoinType.java:

public enum CoinType {
    COPPER("Coin_Copper", 1, "Copper"),
    IRON("Coin_Iron", 10, "Iron"),
    COBALT("Coin_Cobalt", 100, "Cobalt"),
    GOLD("Coin_Gold", 1_000, "Gold"),
    MITHRIL("Coin_Mithril", 10_000, "Mithril"),
    ADAMANTITE("Coin_Adamantite", 100_000, "Adamantite");
    // ...
}

API Usage

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

// Check if coins addon is available
if (EcotaleAPI.isPhysicalCoinsAvailable()) {
    PhysicalCoinsProvider coins = EcotaleAPI.getPhysicalCoins();

    // Drop coins at entity position
    coins.dropCoinsAtEntity(entityRef, store, commandBuffer, 500L);
}

Building from Source

Requirements: Place JARs in libs/ folder:

  • hytale-server.jar (Hytale dedicated server)
  • Ecotale-1.0.0.jar (from Ecotale project)
./gradlew jar

Output: build/libs/EcotaleCoins-1.0.0.jar

License

MIT License - 2026 Tera-bytez

Последние версии

EcotaleCoins-1.0.0.jar

Early Access 19.01.2026 133.9 КБ
Скачать