Vault 2.0 经济插件

Vault 2.0 economy plugins
一款注册与 Vault API 兼容的 Bukkit Economy 服务的内置经济系统插件，让商店、称号等其他插件无需依赖原版 Vault.jar 即可使用金钱功能。包含交互菜单、Pay/Charge 支付流程、贷款系统与安全的配置重载。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Vault 2.0 economy plugins（Vault2.0） |
| 开发者 | Aerials（Modrinth） / shalom25（SpigotMC、GitHub 源码维护者） |
| 最新版本 | v1.7.0 |
| 许可协议 | ARR（All Rights Reserved，保留所有权利） |
| 兼容版本 | Minecraft: Java Edition 1.8.x – 26.2 |
| 运行平台 | Bukkit / BungeeCord / Paper / Purpur / Spigot |
| 项目地址 | https://modrinth.com/plugin/vault-2.0-economy-plugins |
| 官方文档 | 见插件内 config.yml 注释与 messages_.yml 语言文件；源码 https://github.com/shalom25/Vault2.0 |
简介

Vault2.0 是一款内置经济系统插件，它通过 Bukkit ServicesManager 注册一个与 Vault API 兼容的 Economy 服务，使商店、称号、任务等其他插件可以直接调用金钱接口，而无需再安装原版 Vault.jar。

除作为经济 API 提供者外，它本身也是一套完整、开箱即用的经济系统：内置文件持久化存储（可选 MySQL）、带 GUI 的 /pay 支付流程（含 pay / charge / view balance / loans 子菜单）、带向导的贷款系统、主菜单 /vault，以及不会覆盖自定义值的安全重载机制。无需外部经济插件即可独立运行。
核心特性
现代化内置经济系统
自带经济核心与持久化存储，默认写入 plugins/Vault 2.0/balances.yml，可选切换 MySQL。其他插件通过标准 Vault Economy API 调用，对上层插件完全透明，取代原版 Vault.jar 的 Economy 部分（不含权限、聊天，需另配 LuckPerms 等）。
交互式支付菜单（/pay）
/pay 打开服务器在线玩家头像列表，点击目标玩家头像进入按玩家分类的子菜单，提供 3 个选项：
pay — 向该玩家转账
balance — 查看该玩家的金钱
charge — 向该玩家发送带指定金额的交互消息，对方点击消息即可自动付款，无需输入命令

金额输入支持 Quick Pay 快捷金额（1k – 1M）与 Custom Amount 自定义；取消操作为 /pay cancel，配置项 pay.prompt.cancel_words 可按语言自定义取消关键词。
贷款系统（/loan、/prestamo）
带 GUI 向导的贷款流程（金额仅通过聊天输入）：玩家可申请贷款、管理还款、查看财务状态。申请后资金立即到账并记录为 "active"；系统自动分期扣款（余额充足时直接扣除）；违约时可配置惩罚效果（slowness、fatigue 等）。菜单 Status 显示未偿还余额与下次付款日期。
主菜单与安全管理
/vault 打开主菜单，包含 Pay / Loan / Settings / Reload / Update 五项。其中 /vault reload 会更新 config.yml 与 messages_.yml，自动补齐缺失段落且不覆盖你已修改的值，无需重启。
多语言
内置 en、es、fr、de、nl、pt、ru、zh_TW、hi 等语言文件，v1.6.5 起新增简体中文 messages_zh_CN.yml。货币符号、位置（前缀/后缀）、空格等通过 currency. 全局配置，自动作用于余额、支付、排行等所有格式化输出。
多存储后端
默认文件存储（balances.yml）；可切换 MySQL，v1.7.0 起余额变更异步写入，不再阻塞主线程——内存即时更新、后台落库，高并发交易减少卡顿，关闭服务端时还会做最终保存防止待写数据丢失。
分世界独立经济（v1.7.0+）
在 config.yml 的 world_balances.separate_worlds 中指定世界即可启用分世界余额，/balance、/pay、支付菜单、/eco 与占位符均按当前世界正确显示；未列出的世界仍共用全局余额，向后兼容。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Bukkit / Spigot / Paper / Purpur / BungeeCord（1.8.x – 26.2） |
| Java | 17 及以上（早期版本 1.2.x 以前要求 Java 8） |
| 依赖 | 无硬依赖；可选 LuckPerms 用于权限管理，可选 PlaceholderAPI 用于余额占位符 |
重要：切勿将此插件与原版 Vault.jar 同时运行——二者插件名相同会冲突。启动前请先移除原版 Vault.jar。

部分插件会硬编码检测名为 "Vault" 的插件；若需兼容此类插件，可将插件名改回 Vault、仅把版本号设为 2.0.0。
安装方法
下载 Vault 2.0-v1.7.0.jar
放入服务器的 plugins 文件夹（先移除原版 Vault.jar）
重启服务器，自动生成 plugins/Vault 2.0/config.yml 与语言文件
按需编辑配置后，执行 /vault reload 生效
升级提醒（v1.2 / v1.6.5 等涉及存储变更版本）：升级前请先备份 balances.yml。涉及存储目录结构调整时，官方建议：① 复制 balances.yml；② 删除服务器上的 vault 文件夹；③ 启动后放回 balances.yml，以免玩家资金丢失。建议在维护窗口内操作。

从源码构建：mvn -B -U package，产物位于 target/vault-2.0-v1.7.0.jar。
命令与权限

| 命令 | 说明 | 权限 | 默认 |
| --- | --- | --- | --- |
| /balance | 查看自己的余额 | vault.balance | OP |
| /pay | 打开玩家列表 GUI / 支付 | vault.pay | OP |
| /pay cancel | 取消当前支付流程 | vault.pay | OP |
| /loan、/prestamo | 打开贷款 GUI | vault.loan | OP |
| /eco give/take | 管理员增减余额 | vault.eco | OP |
| /vault | 打开主菜单（Pay/Loan/Settings/Reload/Update） | — | OP |
| /vault reload | 重载配置与语言文件（不覆盖自定义值） | OP 专用，不走权限节点 | OP |
| /vault update | 检查更新 | — | OP |
| /vault resetbalances (confirm) | 清空全部余额 | — | OP |
支付额度限制可通过权限豁免：vault.pay.bypass_min（绕过最小金额）、vault.pay.bypass_max（绕过最大金额）。

权限默认均授予 OP；使用 LuckPerms 授权示例：
lp group default permission set vault.balance true
lp group vip permission set vault.pay true
lp group vip permission set vault.pay.bypass_min true
配置示意
存储方式: false = 文件(balances.yml), true = MySQL
storage:
use_mysql: false
离线模式 UUID 回退 (online-mode=true 时忽略)
offline-uuid-fallback: true
全局货币配置 (v1.5.6+)
currency:
symbol: "$"
position: prefix # prefix / suffix
space: true
交易时立即保存 (v1.3+)
storage:
save_on_transaction: true
分世界独立经济 (v1.7.0+)
world_balances:
separate_worlds:
- "world_economy_1"
- "world_economy_2"
MySQL 设置 (use_mysql: true 时生效, v1.7.0 起异步保存)
mysql:
host: 127.0.0.1
port: 3306
database: vault2
username: root
password: ""

语言文件（如 messages_zh_CN.yml）可自由编辑，支持 %vault_balance%、%vault_balance_formatted%、%player%、%amount_formatted% 等占位符；/vault reload 会自动补齐缺失段落。
支付与贷款机制
支付流程：/pay → 点击目标玩家头像 → 在子菜单选择 pay / charge / view balance / loans
Charge 收款：向对方发送可点击的交互消息，对方点消息即付款，全程无需命令
贷款流程：/loan → Request → 输入金额（含分期则输入每期金额）→ 放款（立即到账，状态 "active"）→ 自动分期扣款 → Status 查看未偿还余额与下次付款日
违约惩罚：余额不足未按时还款时，可触发配置的负面效果（slowness、fatigue 等）
近期更新
v1.7.0（2026-07-25）：MySQL 异步保存，余额变更不再阻塞主线程，关闭时最终保存防丢数据；新增分世界独立经济（world_balances.separate_worlds），全局调用向后兼容
v1.6.5（2026-07-09）：修复 Charge 可点击文本的颜色/RGB 保留问题；新增简体中文 messages_zh_CN.yml；Pay 菜单新增 Quick Pay 快捷金额子菜单（1k–1M）+ Custom Amount；新增 Back 返回按钮；取消逻辑统一（/pay cancel、/vault cancel）
v1.5.6（约 2026-03）：新增 currency.symbol / position / space 全局货币配置；消息可定制并支持 %cancel%；Top 排行对无名玩家不再显示 UUID
v1.3（2025-11）：新增 storage.save_on_transaction: true，每笔存取即时落盘
v1.2（2025-11）：优化存储目录结构，新增更新通知，支持按语言切换消息
作者与相关链接
Aerials — Modrinth 发布者
shalom25 — SpigotMC 发布者 / GitHub 源码维护者
Modrinth 主页：https://modrinth.com/plugin/vault-2.0-economy-plugins
源码仓库：https://github.com/shalom25/Vault2.0
SpigotMC 资源页：https://www.spigotmc.org/resources/vault-2-0-economy-plugins.129605/
许可

ARR（All Rights Reserved），保留所有权利。未经作者许可，不得用于商业化用途或再分发。