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)

Admin Panel

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

Configuration

Real-time config editing with multi-language support

Pay GUI

Player-to-player payment interface

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.

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.

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.

Features:

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

Download EcotaleJobs

Installation

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

Commands

Permissions

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

Supported Languages

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.

The license changed starting with version 1.0.6 to ‘All rights reserved’; the earlier version is still on GitHub under the MIT License.