Ecotale - Economy Plugin for Hytale

A complete economy system plugin for Hytale servers with persistent storage, customizable HUD, and multi-language support.

Compatible with VaultUnlocked, thanks to creatorfromhell.

Discord Link

Screenshots

Balance HUD

On-screen balance display with smart formatting (K, M, B)

Balance HUD

Admin Panel

Complete economy management GUI with Dashboard, Players, Top, Log, and Config tabs

Admin Dashboard

Admin Players

Admin Log

Configuration

Real-time config editing with multi-language support

Admin Config

Pay GUI

Player-to-player payment interface

Pay GUI

Features

Core Economy

Player Balances - Persistent balance storage with H2/MySQL database
Transfers - Player-to-player payments with configurable fees
Admin Controls - Full economy management GUI

User Interface

Balance HUD - On-screen balance display with smart formatting (K, M, B)
Admin Panel - Complete GUI with tabs for Dashboard, Players, Top, Log, Config
Multi-language - 8 languages: English, Spanish, Portuguese, French, German, Russian, Japanese, Chinese

Technical

Thread-safe - Per-player locking for atomic operations
Multiple Storage Options - H2 (default), JSON, or MySQL for shared databases
API - Public API for other plugins with rate limiting
Events - Cancellable events for balance changes and transactions
All-in-one JAR - No external dependencies required

Addon Mods

Extend Ecotale with these companion plugins:

EcotaleMarketplace

A complete player-driven economy marketplace for Hytale servers. Buy and sell items globally with a user-friendly UI.

EcotaleJobs Preview

Buying Items

Global Access - Open the marketplace from anywhere.
Categorized Items - Easily find what you need (Weapons, Tools, Materials, etc.).
Search System - Quickly search for specific items by name.
Safe Transactions - If you don't have enough inventory space, the purchase will fail and you won't lose any money.

Selling Items

Inventory Listing - Select any valid item from your inventory and set your own price.
Management - View all your active listings and cancel them at any time to get your items back.
Sales History - Track what you've sold and how much you've earned.

Download EcotaleMarketplace

EcotaleCoins - Physical Currency

Transform your virtual economy into a tangible experience with physical coin items.

EcotaleCoins Preview

Features:

6 coin denominations (Copper → Adamantite)
Physical loot drops from mobs
Bank system for secure storage (/bank)
Risk/reward: coins drop on death

Download EcotaleCoins

EcotaleJobs - Reward System

Earn currency through gameplay activities.

EcotaleJobs Preview

Features:

Mining rewards with Vein Streak system
Mob kill rewards (all NPCs auto-classified)
VIP multipliers (permission-based)
Anti-farm protection

Download EcotaleJobs

Installation

Download Ecotale-1.0.0.jar
Place in your Hytale mods/ folder
Restart server

Commands

Command	Description	Permission
`/balance`	View your balance	None (all players)
`/pay`	Open Pay GUI	None (all players)
`/topb`	Open Top Balance GUI	None (all players)
`/pay player amount`	Send money to another player	None (all players)
`/eco`	Open admin panel GUI	`ecotale.ecotale.command.eco`
`/eco give amount player`	Give money	`ecotale.ecotale.command.eco`
`/eco take amount player`	Take money	`ecotale.ecotale.command.eco`
`/eco set amount player`	Set balance	`ecotale.ecotale.command.eco`
`/eco reset player`	Reset to starting balance	`ecotale.ecotale.command.eco`

Permissions

Permission	Description	Default
`ecotale.ecotale.command.bal`	Access to /balance command	All players
`ecotale.ecotale.command.pay`	Access to /pay command	All players
`ecotale.ecotale.command.topb`	Access to /topb command	All players
`ecotale.ecotale.command.eco`	Access to /eco admin commands	Admin only

Configuration

Located in mods/Ecotale_Ecotale/Ecotale.json:

{
  "CurrencySymbol": "$",
  "CurrencyName": "Coins",
  "StartingBalance": 100.0,
  "MaxBalance": 1000000000.0,
  "TransferFee": 0.05,
  "DecimalPlaces": 2,
  "EnableHudDisplay": true,
  "Language": "en-US",
  "StorageProvider": "h2"
}

Storage Providers

Provider
`h2`
`json`
`mysql`
`mongoDB (not tested)`

Supported Languages

Code	Language
en-US	English
es-ES	Espanol
pt-BR	Portugues
fr-FR	Francais
de-DE	Deutsch
ru-RU	Russian
ja-JP	Japanese
zh-CN	Chinese

Translations

API Usage

import com.ecotale.api.EcotaleAPI;

// Get balance
double balance = EcotaleAPI.getBalance(playerUuid);

// Deposit/Withdraw
EcotaleAPI.deposit(playerUuid, 100.0, "Quest reward");
EcotaleAPI.withdraw(playerUuid, 50.0, "Shop purchase");

// Transfer
EcotaleAPI.transfer(fromUuid, toUuid, 100.0, "Trade");

See docs/API.md for full API documentation.