🪙 MoneySMP 🪙

The PvP-Driven Economy System for Competitive Survival Servers

SmpEconomy is a lightweight, combat-focused economy plugin designed specifically for PvP survival environments.

No jobs. No chest shops. No unnecessary complexity.

Just pure risk vs reward.

---

🎯 Core features

Your money should reflect your skill.

• Players receive a configurable starting balance on join.
• Killing a player transfers a fixed amount of money from their account to yours.
• Death by mobs, fall damage, lava, etc. does not affect balance.
• No PvP = No economy change.

This creates a high-risk, competitive financial system built entirely around combat performance.

---

💸 Economy System

Convert digital currency into physical, tradable money items.

/withdraw <amount>

• Instantly generate a secure banknote item.
• Right-click to redeem.
• Safe player-to-player trading.
• Perfect for wagers, duels, and marketplace trades.
• Fully configurable item name, lore, and design.

This allows real in-game transactions without unsafe balance transfers.

🎨 Advanced Visual Integration

SmpEconomy doesn’t just function well — it looks premium.

• Real-time balance display in Tab list.
• Balance shown above player heads.
• Fully customizable RGB gradient formatting.
• Custom currency symbols.
• Editable messages and layout.

Designed to match modern PvP server aesthetics.

🛡 Enterprise-Level Anti-Exploit Protection

Fair gameplay is enforced automatically.

Built-in protection against:

• Alt account farming (same IP detection)
• Repeated kill farming
• Killing bankrupt players
• Abuse loops and exploit patterns

The system intelligently prevents economy manipulation without affecting legitimate gameplay.

---

⚙ Full Configuration Control

Everything is editable inside config.yml:

• Starting balance
• Kill reward amount
• Currency symbol
• Gradient colors
• Anti-farm settings
• All messages

EXAMPLE:

# ==========================================
#          SMP ECONOMY CONFIGURATION
# ==========================================

# The currency symbol used across the server (e.g., $, ₹, €, £)
currency-symbol: "$"

# The amount of money a player starts with when they first join
starting-balance: 100

# How much money does a player steal when they kill someone?
kill-reward: 20

# The format displayed in the Tab List (Player List)
# Supports MiniMessage (gradients, colors)
# Placeholders: %player%, %balance%, %symbol%
tab-format: "<white>%player% <dark_gray>[<gradient:#FFD700:#FFFACD>%balance%%symbol%</gradient><dark_gray>]"

# The format displayed above the player's head (Name Tag Suffix)
# Placeholders: %balance%, %symbol%
tag-suffix: " <dark_gray>[<gradient:#00FF7F:#00FA9A>%balance%%symbol%</gradient><dark_gray>]"

# The display name of the Bank Note item
banknote-name: "<gradient:gold:yellow><bold>Bank Note</bold></gradient>"

No hard-coded limitations.

📜 Commands

Command	Description	Permission
/baltop	Shows top 3 players by money	None
/money	Check your own balance	None
/withdraw	Turn your money into a physical note	None
/smpadmin	Admin commands	smpeconomy.admin

⚡PlaceHolders

🔤 Supported Placeholders

Placeholder	Description	Where It Works
%player%	Player's username	Tab Format
%balance%	Player's current balance	Tab Format, Name Tag
%symbol%	Configured currency symbol	Tab Format, Name Tag

---

⚙️ MiniMessage Support

The following fields support MiniMessage formatting:

Config Option	Supports Gradients	Supports Colors	Supports Bold/Style
tab-format	✅ Yes	✅ Yes	✅ Yes
tag-suffix	✅ Yes	✅ Yes	✅ Yes
banknote-name	✅ Yes	✅ Yes	✅ Yes

---

💰 Economy Settings

Setting	Description	Default Value
currency-symbol	Currency symbol used server-wide	$
starting-balance	Money given on first join	100
kill-reward	Money gained per player kill	20

🚀 Performance Optimized

• Lightweight architecture
• Minimal memory usage
• Designed for competitive PvP servers
• Clean event handling
• No unnecessary background tasks

Built for survival servers that value speed and stability.

---

Why SmpEconomy?

Because economy should reward skill — not grinding.

If your server is PvP-focused, competitive, and survival-based, SmpEconomy delivers a clean, fair, and modern financial system.

---

The configuration is split into multiple files located at plugins/SMPEconomy/:

📂 Configuration Files

📁 config.yml

# ==========================================
#          SMP ECONOMY CONFIGURATION
# ==========================================

# The currency symbol used across the server (e.g., $, ₹, €, £)
currency-symbol: "$"

# The amount of money a player starts with when they first join
starting-balance: 100

# How much money does a player steal when they kill someone?
kill-reward: 20

# The format displayed in the Tab List (Player List)
# Supports MiniMessage (gradients, colors)
# Placeholders: %player%, %balance%, %symbol%
tab-format: "<white>%player% <dark_gray>[<gradient:#FFD700:#FFFACD>%balance%%symbol%</gradient><dark_gray>]"

# The format displayed above the player's head (Name Tag Suffix)
# Placeholders: %balance%, %symbol%
tag-suffix: " <dark_gray>[<gradient:#00FF7F:#00FA9A>%balance%%symbol%</gradient><dark_gray>]"

# The display name of the Bank Note item
banknote-name: "<gradient:gold:yellow><bold>Bank Note</bold></gradient>"

---

📜 commands.yml

# ==========================================
#            SMP ECONOMY COMMANDS
# ==========================================

baltop:
  enabled: true
  description: "Shows top 3 players by money."
  permission: ""
  permission-message: "You do not have permission to use this command."

money:
  enabled: true
  description: "Check your own balance."
  permission: ""
  permission-message: "You do not have permission to use this command."

withdraw:
  enabled: true
  description: "Turn your money into a physical note."
  permission: ""
  permission-message: "You do not have permission to use this command."

smpadmin:
  enabled: true
  description: "Admin commands."
  permission: "smpeconomy.admin"
  permission-message: "You must be an admin to use this command."