💰 SmartWithdraw

The most complete physical note economy plugin for Minecraft. Turn your balance into real, holdable, tradeable note items — signed cryptographically, taxed, expirable, world-restricted — and deposit them back with a single click.

⚠️ Requires an economy plugin. Vault alone does nothing — you also need EssentialsX (or another Vault-compatible economy plugin) installed for Money to work.

📥 Vault · EssentialsX

---

✦ What Makes SmartWithdraw Different

Every other withdraw plugin stores the note's value in plain unsigned item data. Anyone with an NBT editor can change a $1 note to $999999 and deposit it. SmartWithdraw fixes this by HMAC-cryptographically signing every note with a secret key generated on first server start. Tampered or forged notes are automatically rejected — your economy is always safe.

---

✨ Features

🔐 Tamper-Proof Notes Every note is cryptographically signed. No NBT editor, no plugin, no exploit can forge a valid note. Signature is verified on every deposit attempt.

💵 Three Independent Currency Backends

Currency	Backend	Note Item
Money	Vault / EssentialsX	Custom Skull Head
GamePoints	PlayerPoints	Custom Skull Head
Experience	Player XP/Levels	Custom Skull Head

Each currency has its own denominations, tax rules, daily limits, and world restrictions.

🏦 Beautiful Multi-Page Bank GUI /sw gui opens a redesigned multi-layer chest menu:

• Page 1 — Currency selection. Each currency shown as its custom skull head with your live balance. Click to enter.
• Page 2 — Denomination withdraw buttons using currency skull heads, deposit all, deposit held note, back and close buttons.
• Light gray glass border throughout. All empty slots filled. Clean and uniform.

📄 Fully Editable Note Lore Every line of every note tooltip is a configurable template per currency. Placeholders: %value% %server% %date% %expiry% %tax% %currency% %type%

💸 Real Tax System Percentage tax per currency — on withdraw, deposit, or both. Burns the taxed amount from the economy. Rate shown clearly in lore.

🕐 Note Expiry Notes expire after a configurable number of days. Lore shows a live countdown. Expired notes detected on deposit, on login, and during periodic scans.

📊 Daily Withdrawal Limits Rolling 24-hour cap per currency per player. Resets exactly 24 hours after first withdrawal. Persists across server restarts and crashes.

🌍 World Restrictions Restrict each currency to specific worlds. Empty list = all worlds allowed including Multiverse.

🔍 Note Inspector /sw inspect while holding a note opens a fully filled 54-slot GUI showing currency details, value, creation date, expiry countdown, tax config, and signature validity.

📦 Offline Player Give /sw give works on offline players. Notes stored in pending-notes.yml and delivered on next login.

🔊 Sounds, Action Bar & Tab Completion Configurable sounds per action. Success on action bar, errors in chat. Full tab completion everywhere.

📋 Transaction Logging Every action logged with a unique transaction ID, timestamp, player, currency, and amount. Logs survive crashes — never silently dropped.

---

⚙️ Commands

Command	Description
/withdraw <amount> [currency]	Withdraw balance as notes
/deposit	Deposit all notes in inventory
/sw gui	Open the bank menu
/sw currencies	List all configured currencies
/sw inspect	Inspect the note you are holding
/sw limit [currency]	View your daily withdrawal usage
/sw give <player> <amount> [currency]	(admin) Give notes — works offline
/sw reload	(admin) Reload config live

🖱️ Interactions

Action	Effect
Right-click a note	Deposit one note
Sneak + right-click a stack	Deposit the whole stack
Sneak + left-click a note	Split into smaller denominations

---

📦 Requirements

• Paper, Spigot, or Purpur — Minecraft 1.21+
• Vault — required
• A Vault economy plugin e.g. EssentialsX — required for Money
• PlayerPoints — optional, for GamePoints
• PlaceholderAPI — optional, for placeholders

---

Every currency, denomination, note style, lore line, sound, tax rate, world restriction, and message is fully configurable — make SmartWithdraw feel completely native to your server.