# 羽毛缓冲银行
**先令。钱包。国库。**
一个为 Paper 1.21.x 设计的现代 Vault 经济插件，引入了 **先令** 货币、玩家 **钱包** 和区域安全的 **国库** 银行——这些都结合了抛光的用户界面，拥有清晰友好的用户体验。
---
## ✨ 特点
- **Vault 经济提供程序** – 注册 **先令**，以便商店/等级插件开箱即用。
- **钱包** – 动作条拾取消息、项目化掉落、`/钱包` GUI 和 `/钱包 掉落`。
- **国库** – 与钱包分开的安全银行，拥有干净的存款/取款菜单。
- **公平的死亡惩罚** – 任何死亡时掉落 **钱包的 50%**（可配置）。
- **安全区域** – 在配置的 WorldGuard 区域内（例如，出生点）不会掉落钱包。
- **柜员方块** – 可选的区域门禁柜员访问（例如，**讲台**，**铃铛**），以实现身临其境的银行业。
- **反滥用** – 防漏斗的钱包物品；防火；安全掉落处理；GUI 点击保护。
- **起始余额** – 为新玩家设置默认余额。
- **SQLite 存储** – 零配置默认值；简单可靠。
- **管理员工具** – `/国库管理 设置|赠送|扣除|排行榜|重新加载`，具有本地化格式。
---
## ✅ 要求
- **服务器:** Paper 1.21.x (在 1.21.8 上测试)
- **依赖项:**
- **Vault**（必需）
- **WorldGuard**（可选，用于安全区域）
- **注意:** 如果您目前使用 **EssentialsX-Economy**，请删除该 jar 文件，以便 FeatherfallBank 成为活动的 Vault 提供程序。
---
## 🚀 安装
1. 安装 **Vault**（如果您想要安全区域，也请安装 **WorldGuard**）。
2. 将 `FeatherfallBank-.jar` 放入 `plugins/` 文件夹中。
3. 启动服务器以生成配置文件。
4. 运行 `/vault-info` 并确认 **FeatherfallBank** 已注册为经济提供程序。
5. 调整 `config.yml`（起始余额、死亡掉落百分比、安全区域），然后 `/国库管理 重新加载`。
---
## 🔧 快速配置
```yml
currency-name: "先令"
currency-name-singular: "先令"
starting-balance: 500
pouch:
death-drop-percent: 0.5 # 死亡时掉落钱包的 50%
respect-keep-inventory: true # 如果 keepInventory 开启，则跳过掉落
hopper-proof: true
despawn-deletes: true
safe-zones:
enabled: true
regions: [owlrun, spawn] # WorldGuard 区域，钱包不会掉落
treasury:
allow-command-open: true
teller:
enabled: true
require-region: true
regions: [owlrun]
blocks: [LECTERN, BELL] # 充当柜员的方块
storage:
type: SQLITE
messages:
pickup: "+{amount} 先令到您的钱包。"
receipt-deposit: "已将 {amount} 先令存入您的国库。"
receipt-withdraw: "已将 {amount} 先令取出到您的钱包。"
```