promotional bannermobile promotional banner
premium banner

TheEconomy

Economic System, Administrative Shop with NPC and Player Shop for Hytale fully customizable, and secondary currency, Cash.

Description

✅ EconomySystem — Hytale Economy Plugin

EconomySystem is a complete economy plugin for Hytale servers, featuring persistent player balances, money commands, admin tools, reward systems, a full Shop GUI, player-to-player shops, Secondary currency named Cash, multi-language support, MySQL database support, and a public API for easy integration with other mods.

✅ Compatibility tested with: LuckPerms, MyPermissions, and PermissionsPlus.
✅ Compatible with: VaultUnlocked and Cassaforte

⚠️ Warning — Custom HUD

This plugin includes a Custom HUD. Hytale currently allows only one custom HUD at a time. If you already use another plugin that enhances the screen (such as EyeSpy or any other HUD plugin), you must either:

  • Disable EconomySystem HUD in mods/Economy_Economy/SystemEconomySystem.json by setting "EnableHud" to false
  • Or install MultipleHUD to support more than one Custom HUD

✅ Main Features

  • Persistent Balances (JSON / MySQL) saved automatically every 30 seconds
  • MySQL Support: Full MySQL integration for scalable server deployments
  • Starter Money: New players receive a configurable starting balance
  • Safe & Stable: Thread-safe balance handling with secure saving
  • Shop System: Server shop with GUI, buy/sell support, and dynamic item loading
  • Player Shop System: Player-to-player shops with GUI, tabs, stock management, and persistence
  • Rewards System: Earn money from breaking blocks (ores/wood) and killing monsters
  • Advanced Currency Formatting: custom symbol, locale formatting, and short values (1k, 1kk, 1kkk)
  • Plugin Scoreboard
  • Minecraft-like Color Codes for messages, GUI, and HUD
  • Multi-language Support: EN / PT / ES / RU / PL / DE / HU / FR
  • Console Support: Admin commands work from the server console
  • Plugin's own scoreboard
  • The plugin has now been adapted to a color-coding system for messages similar to that of Minecraft.
  • Custom Hud (Lines and position)
  • Secondary currency named Cash
  • Addition of NPCs with individual shops for each NPC.
  • Ability to sell multiples commands on the console.
    • Example of a console command: money give {playername} {quantity}
    • Example of a multiple console commands: money give {playername} {quantity},kick {playername},kick {playername}

💰 Player Commands

  • /money → Shows your balance in a stylish on-screen title.
    Aliases: /eco /balance /bal
    Permission: theeconomy.player.money
  • /cash → Shows your balance of cash in a stylish on-screen title.
    Aliases: /cashbalance /cb
    Permission: theeconomy.player.cash
  • /hud <on/off> → Activate / deactivate your HUD
    Aliases: /ehud /economyhud
    Permission: theeconomy.player.hud
  • /money <player> → View another player’s balance
    Permission: theeconomy.player.money
  • /money pay <player> <amount> → Send money to another player
    Permission: theeconomy.player.money.pay
  • /money top → Displays the Top 10 richest players (special colors for Top 3)
    Aliases: /money ranking /money leaderboard
    Permission: theeconomy.player.money.top
  • /iteminfo → Shows information about the item in hand
    Aliases: /ii /item
    Permission: theeconomy.player.iteminfo

🛠 Admin Commands

  • /money set <player> <amount> → Set a player’s balance
    Permission: theeconomy.admin.money.set
  • /money give <player> <amount> → Add money to a player
    Permission: theeconomy.admin.money.give
  • /cash give <player> <amount> → Add cash to a player
    Permission: theeconomy.admin.cash.give
    ✅ Works from console!

🛒 Server Shop Commands & System

  • /shop → Opens the Shop GUI
    Aliases: /loja
    Permission: theeconomy.player.shop
  • Browse available items using a clean interface
  • Buy and sell items with a confirmation dialog
  • Quantity input field in the confirmation GUI
  • Shop supports translated item names, tooltips, and messages
  • Buy/Sell options are automatically disabled if the item price is set to 0
  • Displays an empty shop message when no items are available
  • Dynamic translated titles based on configured language

🛠 Server Shop Admin Commands

  • /shop npc add → Adds an NPC with an interactive feature to open a shop exclusively for that NPC.
    Permission: theeconomy.admin.shop.add
  • /shop npc movehere → Move a NPC to player Location.
    Permission: theeconomy.admin.shop.add
  • /shop npc list → List all NPC Shops
    Permission: theeconomy.admin.shop.add
  • /shop npc remove → Remove an NPC with an interactive feature to open a shop exclusively for that NPC.
    Permission: theeconomy.admin.shop.add
  • /shop manager → It allows you to manage Adminshop through the interface without using the commands below.
    Permission: theeconomy.admin.shop.manager
  • /shop add <itemid> <quantity> <pricesell> <pricebuy> → Adds an item to the shop
    Permission: theeconomy.admin.shop.add
  • /shop tab add <tabname> → Adds an tab to the shop
    Permission: theeconomy.admin.shop.add
  • /shop tab remove <tabname> → Removes an tab to the shop
    Permission: theeconomy.admin.shop.remove
  • /shop remove <uniqueid> → Removes an item from the shop
    Permission: theeconomy.admin.shop.remove
  • /shop rpshop <playername> <new name> → Rename player Shop
    Permission: theeconomy.admin.shop.rename.player

🧑‍🤝‍🧑 Player Shop System (Player-to-Player Shops)

Players can create their own personal shops and trade with others.

Player Shop Commands

  • /myshop →
    Aliases: /mshop /minhaloja
    Permission: theeconomy.player.myshop.manager
  • /myshop manager → It allows you to manage Playershop through the interface without using the commands below.
    Permission: theeconomy.player.myshop.manager
  • /myshop open → Opens your shop.
    Permission: theeconomy.player.myshop
  • /myshop close → Closes your shop
    Permission: theeconomy.player.myshop
  • /myshop add <priceBuy> <priceSell> → Adds the item in hand to your shop
    Permission: theeconomy.player.myshop
  • /myshop remove <uniqueid> → Removes an item from your shop
    Permission: theeconomy.player.myshop
  • /myshop tab add <name> → Adds a tab to the player's store.
    Permission: theeconomy.player.myshop
  • /myshop rename <name> → Rename the store.
    Permission: theeconomy.player.myshop
  • /playershop <nick> → Opens another player’s shop
    Aliases: /pshop /lojajogador
    Permission: theeconomy.player.playershop
  • /shops → Lists all open player shops
    Aliases: /lojas /shopslist
    Permission: theeconomy.player.shops

⛏ Block Break Rewards

Earn money automatically by breaking blocks:

  • Ore Rewards
    • Fully configurable per ore type
    • Can be enabled/disabled in config
  • Wood Rewards
    • Reward values can be configured per wood type
    • Can be enabled/disabled in config

🐲 Monster Kill Rewards

Players can earn money by defeating monsters:

  • Individual configuration system per monster
  • Each monster can have its own reward set.
  • Configurable via MonsterReward in EconomyConfig
  • Optional debug logs

⚙ Configuration Options

  • Enable/disable Ore Rewards
  • Enable/disable Wood Rewards
  • Enable/disable Player Shop system (EnablePlayerShop
  • Enable/disable Admin Shop system (EnableShop)
  • Enable/disable hud system (EnableHud)
  • Set default Language (EN / PT / ES / RU / DE)
  • Customize Currency Symbol
  • Configure Ore rewards per type
  • Configure Wood rewards per type
  • Configure Monster rewards per type

🗄️ MySQL Database Support

EconomySystem includes full MySQL database support for scalable server deployments.

MySQL Configuration (EconomySystem.json)

  • EnableMySQL (default: false)
  • MySQLHost (default: localhost)
  • MySQLPort (default: 3306)
  • MySQLUser (default: root)
  • MySQLPassword (default: empty)
  • MySQLDatabaseName (default: theeconomy)
  • MySQLTableName (default: bank)
  • MySQLAdminShopTableName (default: adminshop)
  • MySQLPlayerShopTableName (default: playershop)
  • ✅ Automatic table creation on first connection
  • ✅ Seamless migration between JSON and MySQL
  • ✅ Thread-safe database operations
  • ✅ Supports all plugin features (balances + shops + rewards)

🌍 Localization / Translation

  • Language_EN.json — English
  • Language_PT.json — Portuguese
  • Language_ES.json — Spanish
  • Language_RU.json — Russian
  • Language_PL.json — Polish
  • Language_DE.json — German
  • Language_HU.json — Hungarian
  • Language_FR.json — French

✅ All messages, GUIs, tooltips, and shop titles are fully translatable
✅ Supports placeholders and dynamic values
✅ Item names are translated in all messages and GUIs

🔌 Public API (EconomyAPI)

EconomySystem includes a public API available at: com.economy.api.EconomyAPI

  • Balance queries, management, and checks
  • Formatted balance retrieval
  • Player name/UUID helpers
  • Shop opening method for integrations

🔗 Placeholder API

EconomySystem includes a Placeholder API: com.economy.util.PlaceholderAPI

  • %balance% — Player balance (numeric)
  • %balance_formated% — Player balance (formatted)

🔌 Public API (EconomyAPI)

EconomySystem includes a public API located at:
com.economy.api.EconomyAPI

Available API Methods

Balance Queries

  • getBalance(UUID playerUUID)
  • getBalance(String playerName)

Balance Management

  • setBalance(UUID playerUUID, double value)
  • setBalance(String playerName, double value) (returns boolean)
  • addBalance(UUID playerUUID, double value)
  • addBalance(String playerName, double value) (returns boolean)
  • removeBalance(UUID playerUUID, double value) (returns boolean)
  • removeBalance(String playerName, double value) (returns boolean)

Balance Checks

  • hasBalance(UUID playerUUID, double value)
  • hasBalance(String playerName, double value)

Player Info Helpers

  • getPlayerName(UUID playerUUID)
  • getPlayerUUID(String playerName)

Formatted Balance

  • getFormattedBalance(UUID playerUUID)
  • getFormattedBalance(String playerName)

Shop Management

  • openShop(Player player) (returns boolean)
    • Opens the shop for a player
    • Automatically checks if shop is enabled in configuration
    • Returns true if shop was opened successfully, false otherwise

API Example

 
import com.economy.api.EconomyAPI;
import com.hypixel.hytale.server.core.entity.entities.Player;
import java.util.UUID;

// Get API instance
EconomyAPI api = EconomyAPI.getInstance();

// Balance queries
double balance = api.getBalance(playerUUID);
double balanceByName = api.getBalance("PlayerName");

// Balance management
api.setBalance(playerUUID, 1000.0);
api.addBalance(playerUUID, 100.0);
boolean success = api.removeBalance(playerUUID, 50.0);

// Balance checks
boolean hasEnough = api.hasBalance(playerUUID, 200.0);

// Formatted balance
String formatted = api.getFormattedBalance(playerUUID);

// Player info
String name = api.getPlayerName(playerUUID);
UUID uuid = api.getPlayerUUID("PlayerName");

// Open shop (in an event or command)
public void onPlayerCommand(Player player) {
    EconomyAPI api = EconomyAPI.getInstance();
    
    // Check balance
    double balance = api.getBalance(player.getUuid());
    
    // Add money
    api.addBalance(player.getUuid(), 100.0);
    
    // Open administrative shop
    if (api.openShop(player)) {
        // Shop opened successfully
    } else {
        // Failed to open shop (may be disabled or player offline)
    }
}

🔗 Placeholder API

EconomySystem includes a public Placeholder API for other plugins:

com.economy.util.PlaceholderAPI

Available Placeholders

  • %balance% - Player balance (numeric value)
  • %balance_formated% - Player balance (formatted with currency symbol)

Placeholder API Methods

  • PlaceholderAPI.getInstance().replacePlaceholders(UUID playerUUID, String text)
  • PlaceholderAPI.getInstance().replacePlaceholders(String playerName, String text)
  • PlaceholderAPI.getInstance().containsPlaceholders(String text)

Placeholder Example

 
PlaceholderAPI placeholderAPI = PlaceholderAPI.getInstance();

String text = "Your balance is %balance_formated%";
String result = placeholderAPI.replacePlaceholders(playerUUID, text);
// Result: "Your balance is $1,234.56"

🔐 Permissions

All permissions are registered and visible in LuckPerms:

Player Permissions

  • theeconomy.player.hud - Access to /hud command
  • theeconomy.player.money - Access to /money command
  • theeconomy.player.cash - Access to /cash command
  • theeconomy.player.money.pay - Access to /money pay command
  • theeconomy.player.money.top - Access to /money top command
  • theeconomy.player.shop - Access to /shop or /loja command
  • theeconomy.player.iteminfo - Access to /iteminfo command
  • theeconomy.player.myshop - Access to /myshop commands
  • theeconomy.player.myshop.manager - Access to /myshop manager
  • theeconomy.player.playershop - Access to /playershop or /pshop command
  • theeconomy.player.shops - Access to /shops command

Admin Permissions

  • theeconomy.admin.money.set - Access to /money set command
  • theeconomy.admin.cash.give - Access to /cash give command
  • theeconomy.admin.money.give - Access to /money give command
  • theeconomy.admin.shop.add - Access to /shop add command
  • theeconomy.admin.shop.add - Access to /shop add command
  • theeconomy.admin.shop.manager - Access to /shop manager command

Permission Groups

  • theeconomy.player.* - Grants all player permissions
  • theeconomy.admin.* - Grants all admin permissions
  • theeconomy.* - Grants all permissions

🎨 Color Code System

✨ New Feature: EconomySystem includes a Minecraft-like color code system for customizing messages in chat, GUIs, and HUD!

Color Codes

Use & or § followed by a code to apply colors and formatting:

Basic Colors

  • &0 - Black
  • &1 - Dark Blue
  • &2 - Dark Green
  • &3 - Dark Cyan
  • &4 - Dark Red
  • &5 - Dark Purple
  • &6 - Gold
  • &7 - Gray
  • &8 - Dark Gray
  • &9 - Blue
  • &a - Green
  • &b - Cyan
  • &c - Red
  • &d - Pink
  • &e - Yellow
  • &f - White

Formatting Codes

  • &l - Bold
  • &o - Italic
  • &r - Reset (removes all formatting and colors)

Where It Works

  • ✅ Chat Messages: All command messages, errors, success notifications
  • ✅ GUI Text: Window titles, labels, button text, tooltips, confirmations
  • ✅ HUD Text: All HUD labels, shop status, temporary notifications

Usage Examples

In Translation Files (JSON)

 
{
  "chat_welcome": "&aWelcome to the server!",
  "chat_error": "&cError: &fSomething went wrong!",
  "chat_info": "&bInfo: &fYour shop is open"
}

Combining Colors and Formatting

 
&l&6Gold Bold Text
&c&lRed Bold Text
&a&oGreen Italic Text
&l&6&oGold Bold Italic Text

Default HUD Colors

The plugin uses default colors in the HUD that can be customized in translation files:

  • &l&6 - Bold Gold (for main labels: Nick, Money, Top Rank, Shop)
  • &a - Green (for positive status: Shop Open, Gains)
  • &c - Red (for negative status: Shop Closed)
  • &r - Reset (returns to default after label)

Recommended Color Usage

  • Success: &a (Green) - &aOperation successful!
  • Error: &c (Red) - &cError processing command!
  • Warning: &e (Yellow) - &eWarning: Insufficient balance!
  • Info: &b (Cyan) - &bInfo: Your shop is open
  • Highlight: &6 (Gold) - &6Top Rank: #1
  • Title: &l&6 (Bold Gold) - &l&6Administrative Shop

Quick Reference

Code Color Example
&0 Black &0Black Text
&1 Dark Blue &1Dark Blue Text
&2 Dark Green &2Dark Green Text
&3 Dark Cyan &3Dark Cyan Text
&4 Dark Red &4Dark Red Text
&5 Dark Purple &5Dark Purple Text
&6 Gold &6Gold Text
&7 Gray &7Gray Text
&8 Dark Gray &8Dark Gray Text
&9 Blue &9Blue Text
&a Green &aGreen Text
&b Cyan &bCyan Text
&c Red &cRed Text
&d Pink &dPink Text
&e Yellow &eYellow Text
&f White &fWhite Text
&l Bold &lBold Text
&o Italic &oItalic Text
&r Reset &rNormal Text

Note: You can also use § instead of & (e.g., §a = &a)

  • EconomySystem developed by Agmar Martins
  • Russian Translation: Lylex — Thank you for your contribution! 🙏
  • German Translation: SalimoSB - HyHero — Thank you for your contribution! 🙏
  • Hungarian Translation: Marvar — Thank you for your contribution! 🙏

Version: 1.0.8-beta