Withdraw & Banknotes

Supported Currencies

Each currency mints as a distinct item with its own material, colour, symbol, and denomination limits. The defaults:

Amounts below the minimum or above the maximum are refused before any balance is touched, so you can't accidentally mint a worthless note or hit a precision ceiling.

Withdrawing Currency

To mint a banknote, run /withdraw withdraw <amount> <currency>. The amount accepts plain numbers and the suffixes k, m, and b — so 10k, 1.5m, and 2.5b all work.

1. The system validates the amount is within the per-currency min/max.
2. Your balance is checked — if you don't have enough, the mint is refused (no partial withdrawal).
3. A 2-second global cooldown prevents spam-clicking mints.
4. Currency is atomically removed from your wallet.
5. A fresh serial is INSERTed into banknote_serials — if that INSERT fails, the mint aborts and your wallet is refunded.
6. The banknote item is created, signed, and added to your inventory. If your inventory is full, the mint aborts and refunds.

/withdraw withdrawall <currency> is the quick version: it withdraws your entire balance of that currency as a single note, subject to the minimum and maximum.

Banknote Anatomy

A minted banknote carries everything needed to verify and redeem it, baked into its persistent data container:

• Display name: "<Currency> Banknote" (e.g. "Denarius Banknote").
• Lore: amount (with symbol), currency, owner name, issue date, and a "RIGHT-CLICK to redeem" hint.
• Serial: a random UUID, persisted server-side as the single source of truth.
• Signature: an HMAC-SHA256 over currency|amount|owner|serial, keyed by the server's signature_salt.

The lore is human-readable; the serial and signature are what the plugin actually trusts. Even if someone edits the lore to claim a fake amount, the signature won't match and the redeem is refused.

Redeeming Banknotes

There are three ways to redeem:

• Right-click the note in your hand — instant redeem of that single note.
• /withdraw hand — same thing, for the note in your main hand.
• /withdraw redeem <currency> — bulk-redeem every banknote of that currency in your inventory at once.

The redeem flow is deliberately credit-first: your wallet is credited and verified, then the serial is burned, then the item is destroyed. If anything fails mid-flow — a DB hiccup, a race with another redeemer — the credit is reversed and the note is left intact in your inventory. You never lose money to a transient failure.

Security: Serials, Signatures, and Anti-Dupe

Banknotes are a prime dupe target, so the system is layered. Each layer closes a specific historical exploit:

Inspecting Your Banknotes

Before redeeming, you can audit what you're carrying:

• /withdraw check <currency> — total value, note count, average per note, and inventory slots used.
• /withdraw view <currency> — a richer breakdown showing each denomination and how many of each you hold.

Both commands only count notes whose serial and signature are valid — corrupted or tampered notes are silently excluded from the totals so the figures you see are redeemable.

Lifespan and Storage

Banknotes are plain items, so they follow normal item rules: they can be stored in chests, ender chests, the player vault, cells, the auction house, or traded face-to-face. The configured banknote_lifespan_days (default 365) caps how long a serial stays valid in the database; a hard cap of max_banknotes_per_inventory (default 2304, i.e. 64 stacks) prevents runaway minting from swamping the table.

The signature_salt is generated once (random UUID + long) when the server first starts and stored in withdraw.yml. Rotating it invalidates every existing note, so treat it as a permanent secret.

Permissions

• imperiummc.withdraw.create — required to mint banknotes (default: true).
• imperiummc.withdraw.redeem — required to redeem banknotes (default: true).

Both are on by default for players. Servers that want to restrict minting (e.g. to a donor perk) can flip imperiummc.withdraw.create off without affecting redemption.

Command Reference

Tab-completion offers common amounts (1000, 10k, 100k, …) and the four currency names. Aliases are extensive: w, wa, r, h, c, v for the most-used subcommands.

Tips

1. Use banknotes for big trades. Handing over a 100M Denarius note is faster and safer than /pay in chunks.
2. Right-click to redeem. It's the fastest path — no command needed.
3. Check before you redeem. /withdraw check denarius confirms the total you're about to fold in.
4. Store value in the vault. A banknote in your vault survives a death — keep a reserve there.
5. Don't stack notes. A stack of > 1 is refused at redeem (anti-dupe). Keep them as single items.
6. Bulk redeem by currency. /withdraw redeem denarius sweeps every Denarius note in one shot.