SimpleEconomy

SimpleEconomy

A powerful, lightweight economy system for Hytale servers

SimpleEconomy is a comprehensive economy management plugin designed specifically for Hytale servers. Whether you're running a small private server or a large community network, SimpleEconomy provides all the tools you need to manage your server's financial system with ease.

Features

Core Economy System

Player Balances - Track individual player money with automatic account creation on first join

Bank Accounts - Create shared bank accounts with multiple members and ownership management

Player-to-Player Payments - Easy money transfers between players with intuitive commands

Wealth Leaderboards - Check the top 10 richest players on the server with /bal top

UUID-Based System - Reliable player identification using Hytale's UUID system

Custom Currency - Personalize your economy with custom currency names

Performance & Reliability

Lightning Fast - Built with smart caching for instant balance lookups

Asynchronous Operations - All database operations run in the background to prevent server lag

Multiple Database Support - Choose between SQLite (simple setup) or PostgreSQL (optimized for large servers)

Auto-Configuration - Works out of the box with sensible defaults, fully customizable to your needs

Developer Friendly

Standard API Integration - Implements the Cassaforte Economy API for compatibility with other plugins

Clean Architecture - Modern codebase built with Kotlin for reliability and performance

Commands

Player Commands

Command Description Permission

/balance /bal /money Check your balance economy.user

/balance <player> /bal <player> /money <player> Check another player's balance economy.user

/balance top /bal top /money top Show top 10 richest players economy.user

/pay <player> <amount> Send money to another player economy.user

/bank create <name> Create a new bank account economy.user

/bank balance <name> Check a bank's balance economy.user

/bank deposit <bank> <amount> Deposit money into a bank account economy.user

/bank withdraw <bank> <amount> Withdraw money from a bank account economy.user

Admin Commands

Command Description Permission

/eco give <player> <amount> Give money to a player economy.admin

/eco take <player> <amount> Remove money from a player economy.admin

/eco set <player> <amount> Set a player's balance to a specific amount economy.admin

/eco reset <player> Reset a player's balance to zero economy.admin

Configuration

SimpleEconomy creates a configuration file (economy_config.json) on first launch with customizable options:

Economy Settings

Currency Names - Set singular and plural names for your money (default: "coin" / "coins")

Fractional Digits - Control decimal places for currency display (-1 for no decimals)

Starting Balance - Set the initial balance for new players

Auto-Create Accounts - Automatically create accounts when players join (can be disabled)

Database Options

SQLite (Default) - Perfect for most servers

No setup required

File-based storage in economy_data/economy.db

Ideal for small to medium servers

PostgreSQL - For high-performance networks

Connection pooling for optimal performance

Configurable host, port, and credentials

Recommended for servers with large player counts

Permissions

SimpleEconomy uses a straightforward permission system:

economy.user - Standard player permissions (granted to all players by default)

Access to all player and bank commands

Check balances and make payments

economy.admin - Administrator permissions (automatically given to server operators)

Access to all /eco management commands

Full control over player balances

Permissions integrate seamlessly with Hytale's native permission system and can be assigned to individual players or permission groups.

Integration & API

SimpleEconomy implements the Cassaforte Economy API, ensuring compatibility with other economy-enabled plugins and services. This standard integration allows:

Other plugins to check and modify player balances

Consistent economy behavior across your plugin ecosystem

Future-proof compatibility with economy addons

Wealth Leaderboard

The /bal top command displays the server's wealthiest players with a beautiful medal-based ranking:

=== Top 10 Richest Players ===

🥇 PlayerName1: 50,000 coins 🥈 PlayerName2: 42,500 coins 🥉 PlayerName3: 38,000 coins #4 PlayerName4: 25,000 coins #5 PlayerName5: 21,000 coins ... Perfect for:

Server competitions and events

Economy monitoring

Player motivation and engagement

Getting Started

Install - Place the plugin in your server's plugins folder

Restart - Start your server to generate the configuration

Configure (Optional) - Edit economy_config.json to customize settings

Play - The economy is ready to use! Player accounts are created automatically

Requirements

Hytale Server

Java Runtime Environment

Support

Need help? Have suggestions? Report issues in the project page.

SimpleEconomy - Making economy management simple on Hytale servers.