The Piggy Bank - Piggy Bank - 简易自定义物品经济插件

Piggy Bank 是一款基于物品的简易经济插件，兼容 Vault，适用于 Spigot 服务器。它将玩家的余额分为银行账户和随身携带的实体货币两种形式，并允许通过配置文件完全自定义货币物品。

💡核心特性

• 双轨经济系统：余额由银行账户和随身携带的实体货币共同构成。
• 高度自定义货币：支持自定义物品的显示名称、描述、附魔、耐久、自定义模型数据等。
• 便捷操作：玩家可随时存取、兑换、转账货币。
• 广泛兼容性：原生兼容 Vault，支持 Towny、Factions 等插件。
• 数据持久化：银行余额直接存储在玩家数据中，稳定可靠。
• 丰富的扩展：集成 PlaceholderAPI，提供多种占位符。

🎮命令列表

玩家命令

• /bank 或 /bank balance - 查看自己的余额
• /bank deposit - 存入手中的货币
• /bank deposit all - 存入背包中所有货币
• /bank exchange - 兑换手中的货币（合并为高面值）
• /bank withdraw <金额> - 从银行取出指定金额的货币
• /bank withdraw all - 取出所有余额对应的货币
• /bank transfer <玩家> <金额> - 向指定玩家转账
• /balance <玩家> - 查看指定玩家的余额
• /baltop - 查看财富排行榜
• /deposit - 同 /bank deposit
• /deposit all - 同 /bank deposit all
• /exchange - 同 /bank exchange
• /pay <玩家> <金额> - 向玩家支付金额（需随身携带货币）
• /withdraw <金额> - 同 /bank withdraw <金额>
• /withdraw all - 同 /bank withdraw all

管理员命令

• /bank add <玩家> <金额> - 为玩家增加银行余额
• /bank remove <玩家> <金额> - 扣除玩家的银行余额
• /bank set <玩家> <金额> - 设置玩家的银行余额
• /bank baltop - 查看财富排行榜
• /bank balance <玩家> - 查看指定玩家的余额
• /piggybank reload - 重载插件配置文件

✨权限节点

• piggybank.balance - 使用余额查询命令（默认：true）
• piggybank.deposit - 使用存款命令（默认：true）
• piggybank.exchange - 使用货币兑换命令（默认：true）
• piggybank.withdraw - 使用取款命令（默认：true）
• piggybank.transfer - 使用银行转账命令（默认：true）
• piggybank.pay - 使用 /pay 命令（默认：true）
• piggybank.add - 使用余额增加命令（默认：op）
• piggybank.remove - 使用余额扣除命令（默认：op）
• piggybank.set - 使用余额设置命令（默认：op）
• piggybank.baltop - 使用财富榜命令（默认：op）
• piggybank.balance.others - 查看他人余额（默认：op）
• piggybank.reload - 重载插件配置（默认：op）

🔧配置说明

主要配置文件选项如下

• locale: en_us - 语言区域设置
• decimal_format: '#,##0' - 余额显示格式（若使用小数货币可改为 #,##0.00）
• allow_item_use: false - 是否允许直接使用货币物品
• balance_maximum: 0 - 余额上限（0 为无限制）
• withdraw_maximum: 186624 - 单次最大取款数量
• fake_accounts: true - 是否为离线玩家创建虚拟账户
• resource_pack: true - 是否启用自定义资源包功能

货币定义示例

在 currency: 部分，你可以定义多种货币物品，例如：

stone_coin:
  item: minecraft:dead_bush
  name: '&7Stone Coin'
  lore:
    - '&r&fThis coin is worth &e1x &fthe base currency'
  custom_model_data: 1
  value: 1.0

每个货币可独立设置物品类型、名称、描述、附魔、自定义模型数据及其对应的基础货币价值。

❓注意事项与已知问题

资源包

• 默认配置会在插件文件夹内安装示例资源包（CoinPack, RubyPack），用于自定义货币贴图。
• 若要让客户端自动下载，需将资源包托管至网站，并在 server.properties 中配置 resource-pack 等相关参数。

已知问题

• 当银行余额极大时，执行 /withdraw all 可能会因生成大量物品而导致服务器卡顿。

服务条款与支持

• 本插件按“原样”提供，不提供任何担保。
• 当前仅支持 Minecraft 1.20.4 版本。
• 开发维护需要大量投入，如果你喜欢这个插件，请考虑捐赠支持开发者。