Vault

Source: https://www.spigotmc.org/resources/vault.34315/

Source Code:

https://github.com/milkbowl/Vault

Contributors:

Sleaker, Cerea1, Mung3r, Kainzo

Languages Supported:

English

Donation Link:

https://paypal.me/sleaker

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: Herochat, mChat, iChat, bPermissions, PEX, P3, DroxPerms
• Other economies/permissions systems may have built-in support for Vault, check with them to be sure.

• JavaDocs: http://milkbowl.github.io/VaultAPI
• GitHub (SourceCode): https://github.com/MilkBowl/Vault/
• GitHub (SourceCode): https://github.com/MilkBowl/VaultAPI/

This plugin utilizes bstats 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: https://github.com/MilkBowl/VaultAPI

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

Code (Text):

public static Permission permission = null;
public static Economy economy = null;
public static Chat chat = null;private boolean setupPermissions()
{
RegisteredServiceProvider<Permission> permissionProvider = getServer().getServicesManager().getRegistration(net.milkbowl.vault.permission.Permission.class);
if (permissionProvider != null) {
permission = permissionProvider.getProvider();
}
return (permission != null);
}private boolean setupChat()
{
RegisteredServiceProvider<Chat> chatProvider = getServer().getServicesManager().getRegistration(net.milkbowl.vault.chat.Chat.class);
if (chatProvider != null) {
chat = chatProvider.getProvider();
}return (chat != null);
}

private boolean setupEconomy()
{
RegisteredServiceProvider<Economy> economyProvider = getServer().getServicesManager().getRegistration(net.milkbowl.vault.economy.Economy.class);
if (economyProvider != null) {
economy = economyProvider.getProvider();
}

return (economy != null);
}

Code (Text):

Repository Information for Maven Projects
<repository>
<id>vault-repo</id>
<url>http://nexus.hc.to/content/repositories/pub_releases</url>
</repository>

Help support development of Vault: Donate
Want an amazing RPG plugin? Check out Heroes Premium
Want the best chat plugin? Check out Herochat 6!