Vault 是一个权限、聊天与经济 API,旨在让插件能够轻松接入这些系统,而无需自行挂钩或依赖各个独立的插件。Vault 的诞生源于对 Register 和当前 Permissions API 运行方式的不满,以及它们功能缺失或实现过于复杂的问题。Vault 试图通过直观的设计并为插件提供支持他们可能使用的任何系统来解决这些问题。
配置:
权限:
- vault.admin
- 允许访问 Vault 信息和转换命令
- 默认分配给 OP(管理员)
- vault.update
- 拥有此权限的用户将在 Vault 过时收到通知
- 默认分配给 OP(管理员)
- 在 permissions.yml 中将其设置为 false 将禁用控制台的版本检查消息
Vault 目前支持:
- 权限系统 (Perms): Permissions 3, bPermissions, PEX, GroupManager, PermissionsBukkit, zPermission, SimplyPerms, Privileges, DroxPerms, xPerms
- 经济系统 (Econ): iConomy 4,5,6, BOSEconomy 6 & 7, EssentialsEcon, 3Co, MultiCurrency, MineConomy, eWallet, EconXP, CurrencyCore, CraftConomy, AEco, Gringotts
- CraftConomy、CurrencyCore、BOSE 和 iCo6 仅支持银行功能
- iCo6/CurrencyCore 使用合并的玩家/银行账户。建议使用 BOSE 以获得功能完整的银行服务。
- iCo6 平面文件存在严重错误,请自行承担风险使用
- 聊天系统 (Chat): mChat, iChat, bPermissions, PEX, P3, DroxPerms
- 其他经济/权限系统可能内置了对 Vault 的支持,请咨询相关开发者以确认。
- JavaDocs:
- GitHub (源代码):
- GitHub (源代码):
本插件使用了 Hidendra 的插件指标系统。除非选择退出,否则以下信息会被收集并发送至 bstats.org:
- 唯一标识符
- 服务器的 Java 版本
- 服务器处于离线模式还是在线模式
- 插件版本
- 服务器版本
- 操作系统版本/名称及架构
- CPU 核心数
- 在线玩家数量
- 指标 (Metrics) 版本
- 正在使用的聊天、经济和权限挂钩类型。
可以通过编辑 plugins/bstats/config.yml 并将 opt-out 更改为 true 来退出此服务。
链接 Vault
Vault GitHub 页面上有一个稍长/更详细的示例,展示了如何在插件中链接到 Vault。参见:
可以使用以下 3 种方法配合 3 个变量从 Vault 加载权限、经济聊天系统。请务必在 plugin.yml 中添加 depend: [Vault]!如果您不需要,不必在插件中使用全部 3 个!如果只需要其中一两个 API,请使用您所需的那些即可!
注意:Vault 会自动记录它发现并挂钩的插件,因此您的插件中无需显示此信息。
注意:别忘了在 plugin.yml 中添加 softdepend: [Vault] 或 depend: [Vault]
public static Permission permission = null;
public static Economy economy = null;
public static Chat chat = null;
<span>private</span> <span>boolean</span> <span>setupPermissions</span><span>()</span>
<span>{</span>
RegisteredServiceProvider<Permission> permissionProvider = getServer().getServicesManager().getRegistration(net.milkbowl.vault.permission.Permission.class);
if (permissionProvider != null) {
permission = permissionProvider.getProvider();
}
return (permission != null);
}
<span>private</span> <span>boolean</span> <span>setupChat</span><span>()</span>
<span>{</span>
<span>RegisteredServiceProvider</span><span><</span><span>Chat</span><span>></span> <span>chatProvider</span> <span>=</span> <span>getServer</span><span>()</span><span>.</span><span>getServicesManager</span><span>()</span><span>.</span><span>getRegistration</span><span>(</span><span>net.milkbowl.vault.chat.Chat.class</span><span>);</span>
<span>if</span> <span>(</span><span>chatProvider</span> <span>!=</span> <span>null</span><span>)</span> <span>{</span>
<span>chat</span> <span>=</span> <span>chatProvider.getProvider</span><span>();</span>
<span>}</span>
<span>return</span> <span>(</span><span>chat</span> <span>!=</span> <span>null</span><span>);</span>
<span>}</span>
<span>private</span> <span>boolean</span> <span>setupEconomy</span><span>()</span>
<span>{</span>
<span>RegisteredServiceProvider</span><span><</span><span>Economy</span><span>></span> <span>economyProvider</span> <span>=</span> <span>getServer</span><span>()</span><span>.</span><span>getServicesManager</span><span>()</span><span>.</span><span>getRegistration</span><span>(</span><span>net.milkbowl.vault.economy.Economy.class</span><span>);</span>
<span>if</span> <span>(</span><span>economyProvider</span> <span>!=</span> <span>null</span><span>)</span> <span>{</span>
<span>economy</span> <span>=</span> <span>economyProvider.getProvider</span><span>();</span>
<span>}</span>
<span>return</span> <span>(</span><span>economy</span> <span>!=</span> <span>null</span><span>);</span>
<span>}</span>
Maven 项目的仓库信息
<repository>
<id>vault-repo</id>
<url></url>
</repository>
Vault is a Permissions, Chat, & Economy API to give plugins easy hooks into these systems without needing to hook or depend on each individual plugin themselves. It was born out of a distaste for how both Register and the current Permissions API are run, and their lack of features or over-complicated implementations. Vault attempts to solve these issues by being intuitive and providing plugins with support for any system that they may use.
Config:
- update-check
- turns the update checker on/off
Permissions:
- vault.admin
- allows access to vault info and conversion commands
- defaults to OP
- vault.update
- Anyone with this permission will be notified when Vault is out-dated
- defaults to OP
- setting to false in permissions.yml will disable version check messages for console
Vault currently Supports:
- Perms: Permissions 3, bPermissions, PEX, GroupManager, PermissionsBukkit, zPermission, SimplyPerms, Privileges, DroxPerms, xPerms
- Econ: iConomy 4,5,6, BOSEconomy 6 & 7, EssentialsEcon, 3Co, MultiCurrency, MineConomy, eWallet, EconXP, CurrencyCore, CraftConomy, AEco, Gringotts
- Bank support in CraftConomy, CurrencyCore, BOSE & iCo6 only
- iCo6/CurrencyCore use merged player/bank accounts. It's suggested to use BOSE for full featured banks.
- iCo6 flatfile has SEVERE bugs, USE AT YOUR OWN RISK
- Chat: mChat, iChat, bPermissions, PEX, P3, DroxPerms
- Other economies/permissions systems may have built-in support for Vault, check with them to be sure.
- JavaDocs:
- GitHub (SourceCode):
- GitHub (SourceCode):
This plugin utilizes Hidendra's plugin metrics system. the following information is collected and sent to bstats.org unless opted out:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- Plugin's version
- Server's version
- OS version/name and architecture
- core count for the CPU
- number of players online
- Metrics version
- Which Chat, Economy, and Permission hook is in use.
Opting out of this service can be done by editing plugins/bstats/config.yml and changing opt-out to true.
Linking Vault
There's a slightly longer/more detailed example on the Vault github page on how you might link to vault in a plugin. See:
The following 3 methods can be used along with the 3 variables to load both the permission, economy, and chat systems from Vault. Make sure to add depend: [Vault] to your plugin.yml - You don't need to use all 3 if you don't want to in your plugin! If you only want one or two of the three APIs only use those ones you need!
NOTICE: Vault automatically logs what Plugins it found and hooks to, there is no need to display this information in your plugin.
NOTICE: Don't Forget To add softdepend: [Vault] or depend: [Vault] to your plugin.yml
public static Permission permission = null;
public static Economy economy = null;
public static Chat chat = null;
<span>private</span> <span>boolean</span> <span>setupPermissions</span><span>()</span>
<span>{</span>
<span>RegisteredServiceProvider</span><span><</span><span>Permission</span><span>></span> <span>permissionProvider</span> <span>=</span> <span>getServer</span><span>()</span><span>.</span><span>getServicesManager</span><span>()</span><span>.</span><span>getRegistration</span><span>(</span><span>net.milkbowl.vault.permission.Permission.class</span><span>);</span>
<span>if</span> <span>(</span><span>permissionProvider</span> <span>!=</span> <span>null</span><span>)</span> <span>{</span>
<span>permission</span> <span>=</span> <span>permissionProvider.getProvider</span><span>();</span>
<span>}</span>
<span>return</span> <span>(</span><span>permission</span> <span>!=</span> <span>null</span><span>);</span>
<span>}</span>
<span>private</span> <span>boolean</span> <span>setupChat</span><span>()</span>
<span>{</span>
<span>RegisteredServiceProvider</span><span><</span><span>Chat</span><span>></span> <span>chatProvider</span> <span>=</span> <span>getServer</span><span>()</span><span>.</span><span>getServicesManager</span><span>()</span><span>.</span><span>getRegistration</span><span>(</span><span>net.milkbowl.vault.chat.Chat.class</span><span>);</span>
<span>if</span> <span>(</span><span>chatProvider</span> <span>!=</span> <span>null</span><span>)</span> <span>{</span>
<span>chat</span> <span>=</span> <span>chatProvider.getProvider</span><span>();</span>
<span>}</span>
<span>return</span> <span>(</span><span>chat</span> <span>!=</span> <span>null</span><span>);</span>
<span>}</span>
<span>private</span> <span>boolean</span> <span>setupEconomy</span><span>()</span>
<span>{</span>
<span>RegisteredServiceProvider</span><span><</span><span>Economy</span><span>></span> <span>economyProvider</span> <span>=</span> <span>getServer</span><span>()</span><span>.</span><span>getServicesManager</span><span>()</span><span>.</span><span>getRegistration</span><span>(</span><span>net.milkbowl.vault.economy.Economy.class</span><span>);</span>
<span>if</span> <span>(</span><span>economyProvider</span> <span>!=</span> <span>null</span><span>)</span> <span>{</span>
<span>economy</span> <span>=</span> <span>economyProvider.getProvider</span><span>();</span>
<span>}</span>
<span>return</span> <span>(</span><span>economy</span> <span>!=</span> <span>null</span><span>);</span>
<span>}</span>
Repository Information for Maven Projects
<repository>
<id>vault-repo</id>
<url></url>
</repository>
评论 0
登录后参与评分
还没有评论,来抢沙发吧