TheEconomy

✅ 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> &rarr; Activate / deactivate your HUD Aliases: /ehud /economyhud Permission: theeconomy.player.hud

/money <player> &rarr; View another player&rsquo;s balance Permission: theeconomy.player.money

/money pay <player> <amount> &rarr; Send money to another player Permission: theeconomy.player.money.pay

/money top &rarr; Displays the Top 10 richest players (special colors for Top 3) Aliases: /money ranking /money leaderboard Permission: theeconomy.player.money.top

/iteminfo &rarr; Shows information about the item in hand Aliases: /ii /item Permission: theeconomy.player.iteminfo

🛠 Admin Commands

/money set <player> <amount> &rarr; Set a player&rsquo;s balance Permission: theeconomy.admin.money.set

/money give <player> <amount> &rarr; Add money to a player Permission: theeconomy.admin.money.give

/cash give <player> <amount> &rarr; Add cash to a player Permission: theeconomy.admin.cash.give ✅ Works from console!

🛒 Server Shop Commands & System

/shop &rarr; 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 &rarr; Adds an NPC with an interactive feature to open a shop exclusively for that NPC. Permission: theeconomy.admin.shop.add

/shop npc movehere &rarr; Move a NPC to player Location. Permission: theeconomy.admin.shop.add

/shop npc list &rarr; List all NPC Shops Permission: theeconomy.admin.shop.add

/shop npc remove &rarr; Remove an NPC with an interactive feature to open a shop exclusively for that NPC. Permission: theeconomy.admin.shop.add

/shop manager &rarr; 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> &rarr; Adds an item to the shop Permission: theeconomy.admin.shop.add

/shop tab add <tabname> &rarr; Adds an tab to the shop Permission: theeconomy.admin.shop.add

/shop tab remove <tabname> &rarr; Removes an tab to the shop Permission: theeconomy.admin.shop.remove

/shop remove <uniqueid> &rarr; Removes an item from the shop Permission: theeconomy.admin.shop.remove

/shop rpshop <playername> <new name> &rarr; Rename player Shop Permission: theeconomy.admin.shop.rename.player

🧑&zwj;🤝&zwj;🧑 Player Shop System (Player-to-Player Shops)

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

Player Shop Commands

/myshop &rarr; Aliases: /mshop /minhaloja Permission: theeconomy.player.myshop.manager

/myshop manager &rarr; It allows you to manage Playershop through the interface without using the commands below. Permission: theeconomy.player.myshop.manager

/myshop open &rarr; Opens your shop. Permission: theeconomy.player.myshop

/myshop close &rarr; Closes your shop Permission: theeconomy.player.myshop

/myshop add <priceBuy> <priceSell> &rarr; Adds the item in hand to your shop Permission: theeconomy.player.myshop

/myshop remove <uniqueid> &rarr; Removes an item from your shop Permission: theeconomy.player.myshop

/myshop tab add <name> &rarr; Adds a tab to the player's store. Permission: theeconomy.player.myshop

/myshop rename <name> &rarr; Rename the store. Permission: theeconomy.player.myshop

/playershop <nick> &rarr; Opens another player&rsquo;s shop Aliases: /pshop /lojajogador Permission: theeconomy.player.playershop

/shops &rarr; 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 &mdash; English

Language_PT.json &mdash; Portuguese

Language_ES.json &mdash; Spanish

Language_RU.json &mdash; Russian

Language_PL.json &mdash; Polish

Language_DE.json &mdash; German

Language_HU.json &mdash; Hungarian

Language_FR.json &mdash; 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% &mdash; Player balance (numeric)

%balance_formated% &mdash; 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 &sect; 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 &sect; instead of & (e.g., &sect;a = &a)

EconomySystem developed by Agmar Martins

Russian Translation: Lylex &mdash; Thank you for your contribution! 🙏

German Translation: SalimoSB - HyHero &mdash; Thank you for your contribution! 🙏

Hungarian Translation: Marvar &mdash; Thank you for your contribution! 🙏

Version: 1.0.8-beta