Плагин MultiClans — современная система кланов 1.0.0

MultiClans — современная система кланов​

MultiClans — полноценный плагин кланов для Minecraft-серверов с GUI, уровнями кланов, квестами, казной, клановыми домами, хранилищем, рангами, PvP и публичным API.

Плагин рассчитан на серверы, которым нужна не просто базовая система /clan, а полноценная клановая система, которую можно глубоко настроить под свой проект.

Возможности​

Кланы​

• Создание и удаление кланов
• Приглашения и вступление игроков
• Выход и исключение участников
• Ограничение количества участников
• Настраиваемая стоимость создания клана
• Клановый чат
• Информация о клане
• Смена лидера
• Ранги участников
• Настраиваемые права рангов

Казна клана​

• Общий баланс клана
• Внесение средств
• Вывод средств
• Ограничение максимального вывода
• Ограничение вместимости казны
• Настройка прав на вывод средств
• Поддержка экономики через Vault

Уровни клана​

• Система опыта клана
• Получение XP за действия участников
• Уровни клана
• Перки и разблокировки
• Настройка уровней через levels.yml
• Ограничение функций в зависимости от уровня

Клановые квесты​

• Ежедневные квесты
• Еженедельные квесты
• Автоматическая ротация квестов
• Настраиваемое время сброса
• Часовой пояс
• Настраиваемое количество доступных квестов
• Награды
• GUI для просмотра прогресса

Клановые дома​

• Несколько домов одного клана
• Названия домов
• Задержка телепортации
• BossBar во время телепортации
• Отмена телепортации при движении
• Отмена телепортации при получении урона
• Запрет установки домов в определённых мирах
• Поддержка ограничений через WorldGuard

Клановое хранилище​

• GUI-хранилище клана
• До 54 слотов
• Постепенная разблокировка слотов
• Покупка слотов за деньги
• Оплата из казны клана или личного баланса
• Запрещённые предметы
• Ограничение шалкеров
• Возможность ограничить покупку слотов только лидеру

PvP​

• Отдельный PvP для каждого клана
• Возможность разрешать/запрещать урон между участниками
• Force-PvP миры
• Интеграция с общей логикой кланового PvP

GUI​

Плагин использует интерфейсы для основных систем:

• Главное меню клана
• Список участников
• Настройки
• Уровни клана
• Квесты
• Магазин
• Хранилище
• Glow-эффекты

Glow​

Встроенная система визуального выделения участников клана.

PlaceholderAPI​

MultiClans поддерживает PlaceholderAPI и может использоваться другими плагинами для отображения информации о кланах.

Публичный API​

Для разработчиков предусмотрен полноценный API без необходимости обращаться к внутренним классам плагина.

API позволяет:

• получать информацию о клане;
• проверять членство игрока;
• получать ранг и права;
• проверять отношение между игроками;
• работать с клановой экономикой;
• получать информацию о домах;
• выполнять основные операции с кланами;
• использовать публичные Bukkit Events.

Документация API находится в API.md.

Настройка​

Практически все основные параметры вынесены в конфигурацию.

Основные файлы:

config.yml
levels.yml
quests.yml
blocking-name.yml

Можно настроить:

• стоимость создания клана;
• лимиты участников;
• казну;
• дома;
• хранилище;
• мировые ограничения;
• PvP;
• уровни;
• XP;
• квесты;
• сообщения;
• права;
• автоматические сбросы;
• визуальные элементы.

​

Зависимости​

Обязательные зависимости:

• PlaceholderAPI
• Vault
• ProtocolLib

Опциональная интеграция:

• WorldGuard

Для экономики требуется совместимый Vault Economy provider.

PlaceholderAPI

%multiclans_name% - название клана игрока
%multiclans_balance% - баланс клана
%multiclans_level% - уровень клана
%multiclans_xp% - текущий XP клана
%multiclans_xp_next% - XP для следующего уровня
%multiclans_xp_needed% - оставшийся XP до следующего уровня
%multiclans_points% - личные очки игрока

Топ кланов по балансу:

%multiclans_money_top_1%
%multiclans_money_top_2%
%multiclans_money_top_3%
%multiclans_money_top_4%
%multiclans_money_top_5%
%multiclans_money_top_6%
%multiclans_money_top_7%
%multiclans_money_top_8%
%multiclans_money_top_9%
%multiclans_money_top_10%

Названия кланов в топе по балансу:

%multiclans_money_name_top_1%
%multiclans_money_name_top_2%
%multiclans_money_name_top_3%
%multiclans_money_name_top_4%
%multiclans_money_name_top_5%
%multiclans_money_name_top_6%
%multiclans_money_name_top_7%
%multiclans_money_name_top_8%
%multiclans_money_name_top_9%
%multiclans_money_name_top_10%

Топ кланов по убийствам:

%multiclans_kills_top_1%
%multiclans_kills_top_2%
%multiclans_kills_top_3%
%multiclans_kills_top_4%
%multiclans_kills_top_5%
%multiclans_kills_top_6%
%multiclans_kills_top_7%
%multiclans_kills_top_8%
%multiclans_kills_top_9%
%multiclans_kills_top_10%

Названия кланов в топе по убийствам:

%multiclans_kills_name_top_1%
%multiclans_kills_name_top_2%
%multiclans_kills_name_top_3%
%multiclans_kills_name_top_4%
%multiclans_kills_name_top_5%
%multiclans_kills_name_top_6%
%multiclans_kills_name_top_7%
%multiclans_kills_name_top_8%
%multiclans_kills_name_top_9%
%multiclans_kills_name_top_10%

Производительность​

Плагин старается не выполнять тяжёлые операции в основном игровом потоке, а данные хранятся отдельно от игровых объектов.

Для разработчиков​

MultiClans предоставляет публичный API:

ua.kingus.multiclans.api
ua.kingus.multiclans.api.events

Внутренние пакеты плагина не являются частью API-контракта.

Документация:

API.md

Совместимость​

Плагин использует:

• Vault
• PlaceholderAPI
• ProtocolLib
• WorldGuard

Установка​

1. Установите необходимые зависимости.
2. Поместите MultiClans.jar в папку plugins.
3. Запустите сервер.
4. Настройте config.yml, levels.yml, quests.yml и blocking-name.yml.
5. Перезапустите сервер либо выполните reload конфигурации, если это предусмотрено текущей версией.