Описание
## 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](https://modrinth.com/plugin/beastlib)
## ✨ 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](https://www.spigotmc.org/resources/beastwithdraw-plus-multy-withdraw.130867/)
### 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](https://www.spigotmc.org/resources/shopkeepers.80756/)** 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](https://modrinth.com/plugin/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](https://modrinth.com/plugin/beastlib)
### Free optional integrations
- Vault
- EssentialsX or another Vault-compatible economy
- [BeastTokens](https://www.spigotmc.org/resources/beasttokens-custom-currency.20806/)
### Plus optional integrations
- PlayerPoints — **Plus version feature**
- BeastLifeSteal — **Plus version feature**
- BeastMcMMORedeem — **Plus version feature**
- [Shopkeepers](https://www.spigotmc.org/resources/shopkeepers.80756/) — **Plus version feature**
## 🎮 Player Commands
### XP Bottles
- `/xpbottle [stack]` — withdraw a specific amount of XP into bottles.
- `/xpbottle all [stack]` — withdraw all available XP.
- `/xpbottle L [stack]` — withdraw XP based on levels, for example `/xpbottle 10L`.
### Cash Notes
- `/cashnote [stack]` — withdraw money into cash notes.
- `/cashnote all [stack]` — withdraw all available money.
- `/withdraw [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 [stack]`
- `/tokenswithdraw all [stack]`
- `/gemswithdraw [stack]`
- `/gemswithdraw all [stack]`
## 🛠️ Admin Commands
- `/beastwithdraw give [stack] [tax] [signer] [-s]`
- `/beastwithdraw giveAll [stack] [tax] [signer] [-s]`
- `/beastwithdraw reload`
- `/beastwithdraw version`
- `/beastwithdraw help`
- `/beastwithdraw doctor`
- `/beastwithdraw debug`
### Free note type IDs
- `XpBottle`
- `CashNote`
- ``
BeastTokens examples:
- `/beastwithdraw give MrAxeTv tokens 100`
- `/beastwithdraw give MrAxeTv gems 500`
## 🔐 Permissions
### Withdraw
- `BeastWithdraw.XpBottle.Withdraw`
- `BeastWithdraw.CashNote.Withdraw`
- `BeastWithdraw.BeastTokens..Withdraw`
### Withdraw All
- `BeastWithdraw.XpBottle.Withdraw.All`
- `BeastWithdraw.CashNote.Withdraw.All`
- `BeastWithdraw.BeastTokens..Withdraw.All`
### Redeem
- `BeastWithdraw.XpBottle.Redeem`
- `BeastWithdraw.CashNote.Redeem`
- `BeastWithdraw.BeastTokens..Redeem`
### Stacked Redeem
- `BeastWithdraw..Redeem.Stacked`
### Bypass Fee and Tax
- `BeastWithdraw..ByPass.Fee`
- `BeastWithdraw..ByPass.Tax`
### Permission Note Groups
- `BeastWithdraw..PermissionNotes.`
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](https://discord.gg/a2pdAsPS7G)