VaultUnlocked - 2.9.02026-09-18 05:05:17
Bukkit
Folia
Paper
Purpur
Spigot运行环境/下载方式
客户端站外下载
2.9.0
API 变更
- 增加了最低 Vault Unlocked 支持标准。符合这些标准的项目可以申请审核，以使用与其所使用的 API 类型（如 economy 等）相关的徽章。在此申请审核。
- 增加了与旧版 getBalance 方法格式相同的余额方法。
已弃用
- 已弃用 getBalance 方法，这些方法将在 3 个版本后移除。请改用 balance 方法。
- 已弃用不包含 nonPlayer 参数的 createAccount 方法。请使用包含 nonPlayer 参数的方法。
VaultUnlocked - 2.14.02026-09-18 05:05:17
运行环境/下载方式
客户端站外下载
2.14
- 新增了一些用于获取特定账户有权访问的账户的方法。
/**
* 检索由指定账户 ID 拥有的账户 ID 列表。
*
* @param pluginName 插件名称
* @param accountID 账户的唯一标识符
* @return 由指定账户 ID 拥有的账户名称列表
*
* @since 2.14
*/
List<String> accountsOwnedBy(@NotNull final String pluginName, @NotNull final UUID accountID)
/**
* 检索指定账户所属的账户 ID 列表。
*
* @param pluginName 插件名称
* @param accountID 要检查成员资格的账户的 UUID
* @return 表示该账户所属账户的字符串值列表
*
* @since 2.14
*/
List<String> accountsMemberOf(@NotNull final String pluginName, @NotNull final UUID accountID)
/**
* 检索指定账户具有指定权限的账户 ID 列表。
*
* @param pluginName 插件名称
* @param accountID 要检查访问权限的账户的 UUID
* @param permissions 要检查的可变数量权限
* @return 该账户具有指定权限的账户列表
*
* @since 2.14
*/
List<String> accountsAccessTo(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final AccountPermission... permissions)
📘 VaultUnlocked PlaceholderAPI 占位符（基于 UUID）
注意：仅当您的经济插件支持 VaultUnlocked 的现代 API 时，这些占位符才有效。
💰 个人余额（需要玩家）
| 占位符 | 描述 |
|---|---|
%vaultunlocked_balance% | 玩家在默认世界中的余额 |
%vaultunlocked_balance_<world>% | 玩家在特定世界中的余额 |
%vaultunlocked_balance_currency_<currency>% | 特定货币中的余额（默认世界） |
%vaultunlocked_balance_currency_<currency>_world_<world>% | 特定货币和世界中的余额 |
%vaultunlocked_balanceformatted% | 格式化后的余额（例如：$1,234.56） |
%vaultunlocked_balanceformatted_currency_<currency>% | 特定货币中格式化后的余额 |
%vaultunlocked_balanceformatted_currency_<currency>_world_<world>% | 特定货币和世界中格式化后的余额 |
🏦 共享账户余额（需要账户 UUID）
| 占位符 | 描述 |
|---|---|
%vaultunlocked_account_<uuid>% | 共享账户余额（默认货币/世界） |
%vaultunlocked_account_<uuid>_status% | 玩家是否有权访问该共享账户 |
%vaultunlocked_account_<uuid>_currency_<currency>% | 特定货币中的共享账户余额 |
%vaultunlocked_account_<uuid>_currency_<currency>_world_<world>% | 特定货币和世界中的共享账户余额 |
%vaultunlocked_account_<uuid>_currency_<currency>_formatted% | 特定货币中格式化后的余额 |
%vaultunlocked_account_<uuid>_currency_<currency>_world_<world>_formatted% | 特定货币和世界中格式化后的余额 |
✅ 能力检查（需要玩家和账户 UUID）
请注意：响应为 yes 或 no，分别对应 true 或 false。
| 占位符 | 描述 |
|---|---|
%vaultunlocked_can_deposit_<uuid>% | 玩家是否可以存入资金到具有该 UUID 的账户。 |
%vaultunlocked_can_withdraw_<uuid>% | 玩家是否可以从具有该 UUID 的账户取款。 |
%vaultunlocked_can_balance_<uuid>% | 玩家是否可以查看该账户的余额。 |
%vaultunlocked_can_transfer_<uuid>% | 玩家是否可以转移该账户的所有权。 |
%vaultunlocked_can_invite_<uuid>% | 玩家是否可以邀请成员加入该账户。 |
%vaultunlocked_can_remove_<uuid>% | 玩家是否可以从该账户移除成员。 |
%vaultunlocked_can_modify_<uuid>% | 玩家是否可以修改成员权限。 |
%vaultunlocked_can_delete_<uuid>% | 玩家是否可以删除该账户。 |
📂 账户列表/信息（需要玩家）
| 占位符 | 描述 |
|---|---|
%vaultunlocked_accounts% | 可访问的共享账户 UUID 列表 |
%vaultunlocked_accounts_count% | 可访问的共享账户数量 |
💱 货币元数据（不需要玩家）
| 占位符 | 描述 |
|---|---|
%vaultunlocked_currency% | 默认货币的单数形式 |
%vaultunlocked_currencyplural% | 默认货币的复数形式 |
🔡 货币名称的编码说明
如果货币名称包含空格或符号，请对其进行编码：
| 字符 | 使用 % 编码 |
|---|---|
| 空格 | %20 |
$ | %24 |
+ | %2B |
& | %26 |
/ | %2F |
= | %3D |
VaultUnlocked - 2.11.02026-09-18 05:05:17
VaultUnlocked - 2.10.02026-09-18 05:05:17
运行环境/下载方式
客户端站外下载
2.10.0
API 变更
- 实现了 set API 方法，可用于设置账户余额。
EconomyResponse set(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final BigDecimal amount);
EconomyResponse set(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final String worldName, @NotNull final BigDecimal amount);
EconomyResponse set(@NotNull final String pluginName, @NotNull final UUID accountID, @NotNull final String worldName, @NotNull final String currency, @NotNull final BigDecimal amount);