💰 BasicPurseCommand
A lightweight, fully configurable gold purse economy plugin for Minecraft servers — powered by Vault.
✨ Features
- 🪙 Withdraw & deposit: gold ingots between your purse and inventory
- 🔒 Per-subcommand permissions: full control over who can do what
- ⚙️ Fully configurable: subcommand names, messages, limits, tab-complete, all from
config.yml - 🔄 In-game reload: no restarts needed
- 🗂️ Smart tab-complete: suggests amounts based on your inventory and balance
- 🛡️ Inventory full protection: optionally prevent withdrawals that would overflow
🧩 Compatibility
| Server Software | Support |
|---|---|
| Paper | ✅ Full |
| Purpur | ✅ Full |
| Spigot | ✅ Full |
| Bukkit | ⚠️ Partial |
| Folia | ⚠️ Partial |
Minecraft version: 1.20.1+
Java version: 21+
📦 Dependencies
| Dependency | Required |
|---|---|
| Vault | ✅ Yes |
📜 Commands
| Command | Description | Permission |
|---|---|---|
/purse withdraw <amount> |
Withdraw gold from your purse | purse.withdraw |
/purse deposit <amount> |
Deposit gold into your purse | purse.deposit |
/purse balance |
Check your purse balance | purse.balance |
/purse reload |
Reload the configuration | purse.reload |
📜 Tabcomplete
| Command | Sequence |
|---|---|
/purse withdraw |
Amount of gold can fit in inventory / Max withdraw amount |
/purse deposit |
Amount of gold in inventory / Max deposit amount |
/purse balance |
No tabcomplete sequence |
/purse reload |
No tabcomplete sequence |
⚙️ Configuration
purse:
max-withdraw-amount: 256
max-deposit-amount: 2304
prevent-withdrawal-when-inventory-full: true
subcommands:
withdraw: "withdraw"
deposit: "deposit"
balance: "balance"
reload: "reload"
permissions:
withdraw: "purse.withdraw"
deposit: "purse.deposit"
balance: "purse.balance"
reload: "purse.reload"
[...]
All messages, subcommand names, permissions, and limits are fully configurable via config.yml.
🚀 Installation
- Download the latest
.jarfrom Releases - Place it in your server's
plugins/folder - Make sure Vault and an economy provider (e.g. EssentialsX) are installed
- Restart the server
- Configure
plugins/BasicPurseCommand/config.ymlto your liking - Run
/purse reloadto apply changes without restarting
🔨 Building from Source
git clone https://github.com/puckypucky0/PurseCommand.git
cd BasicPurseCommand
mvn clean package
Output jar will be in target/.
📄 License
This project is licensed under the MIT License.
