二次开发 开源 前置/API Vault · Folia 兼容版

这是什么​

Vault 是 Minecraft 服务端的经济/权限/聊天桥接插件。很多插件（拍卖行、充值、称号商店）都通过它访问经济系统。

问题：官方 Vault 1.7.3 在 Folia 上直接启动失败，报错：

代码块

java.lang.UnsupportedOperationException
at org.bukkit.craftbukkit.scheduler.CraftScheduler.handle(CraftScheduler.java:517)
at net.milkbowl.vault.Vault.onEnable(Vault.java:146)
原因：Folia 移除/禁用了传统的 BukkitScheduler，Vault 在 onEnable 里调用了 getScheduler().runTaskTimer(...)，直接抛异常。

这个版本：用字节码补丁把这两处调用替换成 Folia 安全的实现，让 Vault 能正常加载。

效果​

打补丁后：

代码块

[Vault] Enabling Vault v1.7.3-b131
[Vault] [Permission] SuperPermissions loaded as backup permission system.
[Vault] Enabled Version 1.7.3-b131
[EssentialsC] Successfully hooked into Vault.
[zAuctionHouse] Economy 'vault' loaded successfully!
/vault-info 输出：

代码块

[Vault] Vault v1.7.3-b131 Information
[Vault] Economy: EssentialsCEconomy [EssentialsCEconomy]
[Vault] Permission: LuckPerms [LuckPerms, SuperPerms]
[Vault] Chat: LuckPerms [LuckPerms]
经济、权限、聊天三个接口全部正常注册。

---

怎么用​

1. 下载​

Vault-1.7.3-folia-patched.jar（约 268 KB）

2. 替换​

把服务器 plugins/ 目录里的原版 Vault.jar 替换掉（建议先备份原文件）。

3. 重启服务器​

重启 → 看日志有没有 "Enabled Version 1.7.3-b131"

4. 验证​

游戏里执行：

/vault-info
三项（Economy / Permission / Chat）都显示具体插件名，就是成功了。

只测过 1.7.3-b131​

补丁是针对 Vault 1.7.3-b131 的字节码写的。

如果以后有别的 Vault 版本（不太可能，官方 2019 年后没更新），需要重新打补丁。

---

兼容性​