Плагин 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 и может использоваться другими плагинами для отображения информации о кланах.

%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%

### Публичный API

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

API позволяет:

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

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

## Команды

Основная команда:


Доступные функции включают:


Административная команда:


Используется для управления плагином, кланами, уровнями, квестами, логами и конфигурацией.

## Настройка

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

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


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

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

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

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

• PlaceholderAPI
• Vault
• ProtocolLib

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

* WorldGuard

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

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

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

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

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


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

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


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

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

• Vault
• PlaceholderAPI
• ProtocolLib
• WorldGuard

и предназначен в первую очередь для Paper-серверов.

## Установка

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