💰 BasicPurseCommand [no longer receives updates]

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

Minecraft version: 1.20.1+
Java version: 21+

📦 Dependencies

📜 Commands

📜 Tabcomplete

⚙️ 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

1. Download the latest .jar from Releases
2. Place it in your server's plugins/ folder
3. Make sure Vault and an economy provider (e.g. EssentialsX) are installed
4. Restart the server
5. Configure plugins/BasicPurseCommand/config.yml to your liking
6. Run /purse reload to 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.