Ecotale - Economy Plugin for Hytale

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

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:

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

Note: Permissions are auto-generated by Hytale's command system using the format {group}.{plugin}.command.{command}.

Important: LuckPerms Override Behavior

If you install LuckPerms (or other permission plugins), Hytale's default Adventure mode permissions are overridden. This means commands that normally work for all players will be blocked until you explicitly grant permissions.

#### Quick Fix for All Players

# Grant basic economy commands to everyone
/lp group default permission set ecotale.ecotale.command.bal true
/lp group default permission set ecotale.ecotale.command.pay true

# Grant admin commands to staff only
/lp group admin permission set ecotale.ecotale.command.eco true

#### Testing Permissions

# Check if a player has permission
/lp user <username> permission check ecotale.ecotale.command.bal

# View all permissions for a player
/lp user <username> permission info

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

Building from Source

./gradlew shadowJar

Output: build/libs/Ecotale-1.0.0.jar

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.

License

MIT License - 2026 Tera-bytez