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.