promotional bannermobile promotional banner
premium banner

SimpleEconomy

A comprehensive economy plugin for Hytale servers, providing player balances, bank accounts, and a full economy API compatible with Cassaforte's economy interface. The mod does not interact with real money transactions.

Description

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.