BeastWithdraw

Advanced XP, Money & BeastTokens Withdrawal Plugin

BeastWithdraw is a powerful and customizable withdrawal system that lets players convert server balances into physical note items.

Players can withdraw XP, money, and BeastTokens currencies into redeemable bottles or notes, all stored safely using NBT data.

Perfect for Survival, Prison, RPG, and Economy servers that need a simple, safe, and lightweight withdrawal plugin.

⚠️ Required Dependency

BeastWithdraw requires BeastLib 1.6.23 or newer to run.

Download BeastLib: BeastLib on Modrinth

✨ Free Version Features

• Withdraw XP into XP Bottles
• Withdraw money into Cash Notes
• Withdraw BeastTokens currencies into notes
• Redeem single notes or entire stacks by sneaking
• Configurable minimum and maximum withdrawal limits
• Permission-based withdrawal limits and note groups
• Optional redeem tax
• Optional withdrawal fee
• Formatted values in item names, lore, and messages
• Custom note material, name, lore, glow, flags, and enchants
• Admin-created notes with an optional signer, stack size, and tax
• Safe NBT storage for note values and note types
• Protection against crafting, grindstone use, villager trading, and unsafe note usage
• Configurable withdrawal and redemption sounds
• Drop XP bottles on player death
• Transaction logging to the console, combined files, and per-type log files
• Config doctor command for invalid materials, invalid limits, and common configuration issues
• Update notifications
• Readable, documented YAML configuration files

More features are actively being added. Suggestions are always welcome!

🚀 Upgrade to BeastWithdraw Plus

Want the complete premium system with GUIs, extra integrations, and resource-pack visuals?

Get BeastWithdraw Plus: BeastWithdraw Plus on Spigot

Plus version features

• Withdraw GUI
• Deposit GUI
• PlayerPoints notes
• BeastLifeSteal heart notes
• BeastMcMMORedeem credit notes
• mcMMO skill-bound notes
• Custom model data on XP, Cash, BeastTokens, and all note types
• Amount-based item overrides for resource-pack note tiers
• Skull texture note items
• Required base items before creating notes
• GUI opening animations
• GUI click and opening sounds
• Shopkeepers integration for trading signed withdrawal items
• Priority support and faster updates

⚖️ Free vs Plus Feature Comparison

Compare the features included with free BeastWithdraw and BeastWithdraw Plus.

📦 Installation

1. Download BeastWithdraw.jar.
2. Place it in your server's plugins folder.
3. Install BeastLib.
4. Install any optional supported plugins you want to use.
5. Restart your server.

The plugin will generate its configuration files automatically.

🔌 Supported Plugins

Required

• BeastLib

Free optional integrations

• Vault
• EssentialsX or another Vault-compatible economy
• BeastTokens

Plus optional integrations

• PlayerPoints — Plus version feature
• BeastLifeSteal — Plus version feature
• BeastMcMMORedeem — Plus version feature
• Shopkeepers — Plus version feature

🎮 Player Commands

XP Bottles

• /xpbottle <xp> [stack] — withdraw a specific amount of XP into bottles.
• /xpbottle all [stack] — withdraw all available XP.
• /xpbottle <levels>L [stack] — withdraw XP based on levels, for example /xpbottle 10L.

Cash Notes

• /cashnote <amount> [stack] — withdraw money into cash notes.
• /cashnote all [stack] — withdraw all available money.
• /withdraw <amount> [stack] — cash note command alias.
• /withdraw all [stack] — withdraw all available money using the alias.

BeastTokens Currency Notes

BeastWithdraw creates one withdrawal command for each BeastTokens currency.

Examples:

• /tokenswithdraw <amount> [stack]
• /tokenswithdraw all [stack]
• /gemswithdraw <amount> [stack]
• /gemswithdraw all [stack]

🛠️ Admin Commands

• /beastwithdraw give <player> <type> <amount> [stack] [tax] [signer] [-s]
• /beastwithdraw giveAll <type> <amount> [stack] [tax] [signer] [-s]
• /beastwithdraw reload
• /beastwithdraw version
• /beastwithdraw help
• /beastwithdraw doctor
• /beastwithdraw debug

Free note type IDs

• XpBottle
• CashNote
• <beasttokens_currency_id>

BeastTokens examples:

• /beastwithdraw give MrAxeTv tokens 100
• /beastwithdraw give MrAxeTv gems 500

🔐 Permissions

Withdraw

• BeastWithdraw.XpBottle.Withdraw
• BeastWithdraw.CashNote.Withdraw
• BeastWithdraw.BeastTokens.<currency_id>.Withdraw

Withdraw All

• BeastWithdraw.XpBottle.Withdraw.All
• BeastWithdraw.CashNote.Withdraw.All
• BeastWithdraw.BeastTokens.<currency_id>.Withdraw.All

Redeem

• BeastWithdraw.XpBottle.Redeem
• BeastWithdraw.CashNote.Redeem
• BeastWithdraw.BeastTokens.<currency_id>.Redeem

Stacked Redeem

• BeastWithdraw.<type>.Redeem.Stacked

Bypass Fee and Tax

• BeastWithdraw.<type>.ByPass.Fee
• BeastWithdraw.<type>.ByPass.Tax

Permission Note Groups

• BeastWithdraw.<type>.PermissionNotes.<group>

Permission note groups provide permission-based minimum, maximum, and tax settings.

Admin and Utility

• BeastWithdraw.Admin
• BeastWithdraw.admin.debug
• BeastWithdraw.admin.doctor

XP Death Drops

• BeastWithdraw.XpBottle.Drop

⚙️ Customization

Every free note type has its own configuration file:

• plugins/BeastWithdraw/Withdraws/XpBottle/Withdraw.yml
• plugins/BeastWithdraw/Withdraws/CashNote/Withdraw.yml
• plugins/BeastWithdraw/Withdraws/BeastTokens/Withdraw.yml

Free version customization

• Item material
• Display name
• Lore
• Glow
• Item flags
• Enchants
• Dropped item name
• NBT keys
• Minimum and maximum amounts
• Stack limits
• Tax
• Fees
• Sounds
• Messages

Plus-only customization

• Custom model data
• Amount-based item overrides
• Skull texture note items
• Required base items
• Withdraw and deposit GUIs

🛡️ Logging and Safety

• Console transaction logs
• Combined log file
• Separate per-type log files
• Log rotation
• Crafting protection
• Villager trade protection
• Grindstone protection
• NBT-based note validation
• Vault transaction verification for cash notes
• BigDecimal-safe cash note storage

❤️ Support and Community

Need help, found a bug, or have a suggestion?

Join the Beast community on Discord