Simple Banking

插件

· 作者 MVPFishstock

一个支持 Vault 的基于计分板驱动的银行插件

0 本站下载 0 关注 更新于 8 个月前

最新 2.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

Simple Banking

Simple Banking 是一个支持 Vault、基于计分板驱动的 Spigot 服务器银行插件。玩家将可配置的货币物品(以及可选的其方块形式)存入共享的“银行箱子”,但保持按玩家独立的余额。取款时,根据可配置的乘数将银行余额转换回物品和方块。

Features

  • 按玩家的余额存储在 config.yml 中
  • 可配置货币:物品和可选的方块及乘数(例如,1 个 DIAMOND_BLOCK = 9 个 DIAMOND)
  • 存款方式:
    • Shift+点击放入银行箱子
    • 鼠标指针点击银行箱子槽位
    • 漏斗传输并追踪每个漏斗的所有者
  • 取款时优先转换为方块(以节省背包槽位),剩余部分为物品
  • 实时计分板更新,显示在标签页列表和玩家名称下方
  • 提供 Vault Economy 接口以兼容其他插件
  • 游戏内货币管理命令,支持 minecraft:[item] 的自动补全

Requirements

  • 服务器:Bukkit/Spigot/Paper 1.21.x
  • Java:17+
  • 插件:Vault

Installation

  1. 确保已安装 Vault。
  2. 将 simplebanking-<version>.jar 复制到服务器的 plugins/ 目录。
  3. 启动服务器。插件会创建默认的 config.yml。
  4. 验证启动日志显示:
    • Registered SimpleBanking as Vault provider
    • Simple Banking enabled / account count

Configuration (src/main/resources/config.yml)

players: {}
bank-chests: []
currency:
  item: DIAMOND
  block: DIAMOND_BLOCK
  block_multiplier: 9
  name_singular: Diamond
  name_plural: Diamonds
  • currency.item: 基础物品材质 ID
  • currency.block: 可选的方块材质 ID;省略则禁用方块的存取
  • currency.block_multiplier: 每个方块对应的单位数量
  • name_singular / name_plural: 用于计分板和消息中的显示名称

使用 /currency 命令时更改会自动持久化;手动编辑后需要重启服务器或重载配置。

Commands

  • /givebankchest
    • 给予一个标记过的箱子,放置后成为银行箱子
    • 权限:diamondbank.admin
  • /withdraw <amount>
    • 从玩家的银行账户中提取 <amount> 单位
    • 先转换为方块,再使用配置的乘数转换为物品
    • 权限:diamondbank.withdraw
  • /balance
    • 显示拥有非零余额的玩家排行榜
    • 权限:diamondbank.balance
  • /currency <item> [block] [multiplier] [singular] [plural]
    • 更改货币物品、可选的方块/乘数和显示名称
    • 第一个参数自动补全为 minecraft:[item],第二个参数自动补全为 minecraft:[block]
    • 更改前要求所有玩家的余额必须为零
    • 权限:diamondbank.admin

Permissions

  • diamondbank.admin: 管理员任务,如发放银行箱子和更改货币(默认 op)
  • diamondbank.withdraw: 允许取款(默认 true)
  • diamondbank.balance: 允许查看排行榜(默认 true)

How Deposits Work

  • 银行箱子放置:放置给定的箱子物品会将该位置注册为银行箱子
  • 手动存款:
    • Shift+点击:将货币物品/方块从背包移入银行箱子会 credited 单位
    • 鼠标指针点击:将货币物品/方块放入银行箱子槽位会 credited 单位
  • 漏斗存款:
    • 漏斗通过持久化数据追踪所有者
    • 将货币物品/方块移入银行箱子会 credited 该所有者的余额
    • 如果所有者未知,则 credited 16 格范围内最近玩家的余额

Scoreboard

  • 在标签页列表和玩家名称下方显示货币复数名称(例如 "Diamonds")
  • 每次存取款及玩家加入时更新

Vault Economy

  • 实现 Vault Economy 接口以兼容其他插件;账户余额映射到银行单位
  • 无银行账户概念(仅玩家账户)。Vault 中与银行相关的方法返回 NOT_IMPLEMENTED

Troubleshooting

  • Invalid plugin.yml:
    • 确保没有非 ASCII 字符或控制字符;修复并重新构建
  • Scoreboard class errors:
    • 必须导入 org.bukkit.scoreboard.Scoreboard 和 ScoreboardManager
    • 更新插件后务必重启服务器,以避免旧类残留
  • Duplicate JARs:
    • 移除旧副本(例如同时存在 SimpleBanking.jar 和 simplebanking-<version>.jar)以防止类路径冲突
  • Currency change blocked:
    • 如果任何玩家余额 > 0,/currency 拒绝更改;请先让玩家取款并重试

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源