FrozenPAY

💸 FrozenPay

A fast, secure player-to-player payment and balance plugin for Vault economies. Download it if you want a dedicated /pay and /bal system with shorthand amounts (1k, 1m, 1b), cooldowns, transaction limits, and logging, instead of relying on whatever payment command your economy plugin happens to ship with.

👤 Author Info

• Author: DrFrozenXD

✅ Versions / Compatibility / Software Support

• Server software: Paper and forks
• Soft dependencies (optional):
• Vault — required for actual money transfers (with an economy plugin behind it, e.g. EssentialsX)
• PlaceholderAPI — enables placeholders below

🔐 Permissions

Permission · Default · Purpose
frozenpay.pay · true · Use /pay
frozenpay.balance · true · Use /bal to check your own balance
frozenpay.balance.others · true · View other players' balances via /bal
frozenpay.admin · op · Admin access

All permission nodes are also remappable in config.yml if you want different nodes.

⌨️ Commands

Command · Aliases · Usage · Description
/pay · — · /pay · Pay another player
/bal · /balance · /bal [player] · View your own balance, or another player's with permission

🎯 Uses

• 💰 Simple, dedicated /pay and /bal commands backed by Vault.
• 🔤 Shorthand amount parsing — type 1k, 2.5m, 1b, etc. instead of the full number.
• ⏳ Configurable per-player cooldown between payments.
• 🚧 Configurable minimum and maximum transaction limits.
• 🚫 Prevents self-payment by default (configurable).
• 📜 Transaction logging to console and/or a dedicated log file for auditing.
• 🔔 Action bar confirmations for sender and receiver, with configurable duration.
• 🔊 Separate sound effects for payment errors, successful sends, and successful receives.
• 🎨 Fully customizable messages with hex color support, including a formatted balance display.
• ⚙️ Per-player "payments enabled" toggle so players can opt out of receiving payments.

🧩 PlaceholderAPI Placeholders

Placeholder · Returns
%frozenpay_balance% · The player's current balance, formatted
%frozenpay_payments_enabled% · Whether the player currently accepts payments (true/false)
%frozenpay_last_payment% · The amount of the player's most recent payment, formatted
%frozenpay_total_sent% · The total amount the player has sent, formatted

⚙️ Key Config Areas (config.yml)

• economy.provider — economy backend (Vault)
• formatting.* — comma/shorthand display, locale, currency symbol, decimal places
• shorthand-parsing.* — enable/disable and define suffixes (k/m/b/t) for typing amounts
• tab-complete-amounts — preset amounts suggested in tab completion for /pay
• cooldowns.pay — seconds between payments per player
• limits.min-amount / max-amount — transaction size limits
• security.* — prevent self-pay, transaction logging (console and/or file)
• permissions.* — remap each permission node to a custom string
• messages.* — every user-facing message for /pay and /bal
• sounds.* — sound effects for errors, successful sends, and successful receives
• action-bar.* — enable/disable and duration for action bar confirmations