SmartEconomy

SmartEconomy — Lightweight, Modern, and Flexible Economy Plugin

Requirements:

• Vault (Required)
• PlaceholderAPI (Optional — for placeholders)

SmartEconomy is a fast, lightweight, and easy-to-use Minecraft economy plugin with Vault and PlaceholderAPI support. Whether you want a simple server economy or a foundation for more advanced shop and rewards systems, SmartEconomy gives you the tools without unnecessary bloat.

---

✨ Features

• 💰 Vault Support — Works with any plugin that hooks into Vault (shops, jobs, etc.).
• 📊 PlaceholderAPI Support — Use %smarteconomy_balance%, %smarteconomy_balance_formatted%, %smarteconomy_balance_short%, and more.
• 🪙 Daily Rewards — Give your players an automatic daily bonus with a cooldown.
• 💵 Player-to-Player Payments — Players can send money securely to each other.
• 🏆 Top Balances — Show the richest players with /balancetop.
• 🛠 Admin Controls — Easily give, take, or set balances.
• 💾 Flexible Storage — Choose between YAML or MySQL.
• ⚡ Lightweight & Fast — Optimized to run efficiently even on busy servers.
• 🔄 Auto Config Updates — New config entries are added automatically without overwriting your custom settings.

---

📜 Commands

Command	Aliases	Description
/balance	/bal, /money	Show your current balance
/pay <player> <amount>	—	Send money to another player
/balancetop	/baltop, /moneytop	Show the richest players
/daily	—	Claim your daily reward
/economy <give|take|set|reload> [player] [amount]	/eco	Economy admin commands

---

🔑 Permissions

Permission	Default	Description
smarteconomy.balance	true	Allows checking balance
smarteconomy.pay	true	Allows sending money
smarteconomy.daily	true	Allows claiming daily rewards
smarteconomy.balancetop	true	Allows viewing top balances
smarteconomy.admin	op	Allows economy admin commands

---

⚙ Configuration Example

Spoiler

# SmartEconomy Configuration
Config-Version: 1

# Economy Settings
economy:
  starting-balance: 100.0
  currency-symbol: "$"
  daily-reward: 50.0
  daily-cooldown-hours: 24
  daily-enabled: true # Set to false to disable daily rewards

# Data Storage Settings
storage:
  type: "yaml" # yaml or mysql
  auto-save-interval: 5 # minutes

  # MySQL Settings (only used if type is mysql)
  mysql:
    host: "localhost"
    port: 3306
    database: "smarteconomy"
    username: "root"
    password: ""
    table-prefix: "se_"

# Messages
# Available PlaceholderAPI placeholders (can be used if PlaceholderAPI is installed):
# %smarteconomy_balance% - Raw balance (e.g. "100.50")
# %smarteconomy_balance_formatted% - Formatted balance with symbol (e.g. "$100.50")
# %smarteconomy_balance_short% - Short format (e.g. "1.5K")
# %smarteconomy_currency_symbol% - Currency symbol (e.g. "$")

messages:
  prefix: "&8[&aSmartEconomy&8] &r"

  # Balance Messages
  balance-self: "&aYour balance: &e%smarteconomy_balance_formatted%"
  # Alternative: "&aYour balance: &e%symbol%%balance%"
  balance-other: "&a%player%'s balance: &e%smarteconomy_balance_formatted%"
  # Alternative: "&a%player%'s balance: &e%symbol%%balance%"

  # Pay Messages
  pay-sent: "&aYou sent &e%symbol%%amount% &ato &e%player%"
  pay-received: "&aYou received &e%symbol%%amount% &afrom &e%player%"
  pay-insufficient: "&cYou don't have enough money!"
  pay-self: "&cYou cannot pay yourself!"
  pay-invalid-amount: "&cInvalid amount! Must be positive."
  pay-player-not-found: "&cPlayer not found!"

  # Daily Messages
  daily-claimed: "&aYou claimed your daily reward of &e%symbol%%amount%&a!"
  daily-already-claimed: "&cYou have already claimed your daily reward! Try again in %time%."
  daily-disabled: "&cDaily rewards are currently disabled."

  # Balance Top Messages
  baltop-header: "&8&m--------&r &aTop 10 Richest Players &8&m--------"
  baltop-entry: "&e%position%. &a%player% &7- &e%symbol%%balance%"
  # Alternative: "&e%position%. &a%player% &7- &e%smarteconomy_balance_formatted%"
  baltop-empty: "&cNo players found in the database."

  # Economy Admin Messages
  eco-give: "&aGave &e%symbol%%amount% &ato &e%player%"
  eco-take: "&aTook &e%symbol%%amount% &afrom &e%player%"
  eco-set: "&aSet &e%player%'s &abalance to &e%symbol%%amount%"
  eco-reload: "&aConfiguration reloaded!"
  eco-invalid-player: "&cPlayer not found!"
  eco-invalid-amount: "&cInvalid amount!"
  eco-insufficient-funds: "&cPlayer doesn't have enough money!"

  # General Messages
  no-permission: "&cYou don't have permission to use this command!"
  invalid-usage: "&cInvalid usage! Use: %usage%"
  player-only: "&cThis command can only be used by players!"

---

📥 Installation

1. Download the latest version of SmartEconomy, Vault and PlaceholderAPI.
2. Place it in your server's plugins folder.
3. Restart your server to generate the config.
4. Edit the config to your liking and reload.

---

💡 Tip: Pair SmartEconomy with any Vault-compatible shop or jobs plugin for a full-featured economy experience.