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

1. Install - Place the plugin in your server's plugins folder
2. Restart - Start your server to generate the configuration
3. Configure (Optional) - Edit economy_config.json to customize settings
4. 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.