Vault — это плагин, предоставляющий универсальный API для интеграции с различными системами экономики, прав и чата в Minecraft, освобождая другие плагины от необходимости напрямую взаимодействовать с каждым из них.
Настройка
- update-check: включение или отключение проверки обновлений плагина.
Права доступа
- vault.admin: позволяет пользоваться командами Vault для получения информации и конвертации; по умолчанию доступно операторам (OP).
- vault.update: уведомляет о доступности обновлений Vault; по умолчанию доступно операторам. В файле permissions.yml можно отключить сообщения о версиях для консоли.
Права
- Permissions 3, bPermissions, PEX, GroupManager, PermissionsBukkit, zPermission, SimplyPerms, Privileges, DroxPerms, xPerms.
Экономика
- iConomy (версии 4, 5, 6), BOSEconomy (версии 6 и 7), EssentialsEcon, 3Co, MultiCurrency, MineConomy, eWallet, EconXP, CurrencyCore, CraftConomy, AEco, Gringotts.
- Поддержка банков реализована в CraftConomy, CurrencyCore, BOSEconomy и iConomy 6.
- В системах iConomy 6 и CurrencyCore аккаунты игроков и банков объединены, для полнофункциональных банков рекомендуется BOSEconomy.
- Файловая версия iConomy 6 содержит серьёзные ошибки, использование на ваш страх и риск.
Чат
- mChat, iChat, bPermissions, PEX, P3, DroxPerms.
Некоторые другие системы экономики и прав могут иметь встроенную поддержку Vault.
Интеграция с Vault в вашем плагине
Для использования API Vault необходимо добавить в plugin.yml вашего плагина строку depend: [Vault] или softdepend: [Vault].
Пример подключения трёх систем (прав, экономики и чата):
public static Permission permission = null;
public static Economy economy = null;
public static Chat chat = null; private boolean setupPermissions() { RegisteredServiceProvider<Permission> permissionProvider = getServer().getServicesManager().getRegistration(Permission.class); if (permissionProvider != null) { permission = permissionProvider.getProvider(); } return (permission != null);
} private boolean setupChat() { RegisteredServiceProvider<Chat> chatProvider = getServer().getServicesManager().getRegistration(Chat.class); if (chatProvider != null) { chat = chatProvider.getProvider(); } return (chat != null);
} private boolean setupEconomy() { RegisteredServiceProvider<Economy> economyProvider = getServer().getServicesManager().getRegistration(Economy.class); if (economyProvider != null) { economy = economyProvider.getProvider(); } return (economy != null);
}Vault автоматически регистрирует информацию о подключённых плагинах, дополнительный вывод в вашем плагине не требуется.
Сбор статистики
Vault использует систему метрик Hidendra, которая собирает и отправляет анонимные данные на bstats.org. Сбор включает уникальный идентификатор, версию Java, режим сервера (онлайн/оффлайн), версии плагина и сервера, информацию об ОС и процессоре, количество игроков и используемые хуки чата, экономики и прав.
Отключить сбор статистики можно, изменив параметр opt-out в файле plugins/bstats/config.yml на true.
Репозиторий для Maven
<repository> <id>vault-repo</id> <url></url>
</repository>
