FeatherfallBank

FeatherfallBank

Treasury A modern Vault economy plugin for Paper 1.21.x that introduces a Treasury currency, a player Treasury (wallet), and a region-safe Treasury bank—wrapped in polished GUIs with clear, friendly UX.

---

✨ Features

- Admin Tools – Registers Admin Tools so shop/rank plugins work out of the box. - Admin Tools – Action-bar pickup messages, itemized drops, `/pouch` GUI, and `/pouch drop`. - Admin Tools – Secure bank separate from the pouch with clean Deposit/Withdraw menus. - Admin Tools – Drops Admin Tools on any death (configurable). - Admin Tools – No pouch drops in configured WorldGuard regions (e.g., spawn). - Admin Tools – Optional region-gated teller access (e.g., Admin Tools, Admin Tools) for immersive banking. - Admin Tools – Hopper-proof, fire-proof pouch items; safe despawn handling; GUI click-protection. - Admin Tools – Set a default balance for new players. - Admin Tools – Zero-config default; simple and reliable. - Admin Tools – `/treasuryadmin set|give|take|top|reload`, locale-aware formatting.

---

✅ Requirements

- EssentialsX-Economy Paper 1.21.x (tested on 1.21.8) - EssentialsX-Economy - EssentialsX-Economy (required) - EssentialsX-Economy (optional, for safe-zones) - EssentialsX-Economy If you currently use EssentialsX-Economy, remove that jar so FeatherfallBank is the active Vault provider.

---

🚀 Installation

1. Install FeatherfallBank (and FeatherfallBank if you want safe-zones). 2. Drop `FeatherfallBank-<version>.jar` into `plugins/`. 3. Start the server to generate config files. 4. Run `/vault-info` and confirm FeatherfallBank is the registered economy provider. 5. Adjust `config.yml` (starting balance, death-drop percent, safe-zone regions), then `/treasuryadmin reload`.

---

🔧 Quick Config

```yml currency-name: "Shillings" currency-name-singular: "Shilling" starting-balance: 500

pouch: death-drop-percent: 0.5 # 50% of Pouch dropped on death respect-keep-inventory: true # if keepInventory is on, skip drops hopper-proof: true despawn-deletes: true

safe-zones: enabled: true regions: [owlrun, spawn] # WorldGuard regions with no pouch drops

treasury: allow-command-open: true teller: enabled: true require-region: true regions: [owlrun] blocks: [LECTERN, BELL] # blocks that act as Tellers

storage: type: SQLITE

messages: pickup: "+{amount} Shillings to your Pouch." receipt-deposit: "Deposited {amount} Shillings to your Treasury." receipt-withdraw: "Withdrew {amount} Shillings to your Pouch."