> Полное руководство по настройке и использованию плагина.
---
## 📑 Содержание
1. [🌟 Особенности](#-особенности)
2. [🎮 Команды для игроков](#-команды-для-игроков)
3. [🛠️ Команды администратора](#-команды-администратора)
4. [📊 PlaceholderAPI](#-placeholderapi)
5. [🔐 Внутренние права клана](#-внутренние-права-клана)
6. [⚙️ Конфигурация](#-конфигурация)
---
## 🌟 Особенности
* Динамические GUI: Полностью настраиваемые меню через
gui.yml.* Система Уровней: Прокачка клана с бонусами (слоты, права, множители).
* Экономика: Общая казна клана с интеграцией Vault.
* Квесты: Система заданий для совместного прохождения.
* Базы: Установка точек дома (
sethome) для быстрого сбора участников.---
## 🎮 Команды для игроков
Основная команда:
/clan (алиасы: /clans, /c)Базовое право:
clan.use| Команда | Описание | Подкоманда | Право |
|:--- |:--- |:--- |:--- |
|
/clan create <имя> <тег> | ➕ Создать новый клан | create | clan.create ||
/clan menu | 🖥️ Открыть панель управления (GUI) | menu | clan.use ||
/clan chat | 💬 Переключить клановый чат | chat | clan.use ||
/clan invite <игрок> | ✉️ Пригласить нового участника | invite | clan.use ||
/clan sethome | 🏠 Установить точку базы клана | sethome | clan.use ||
/clan home | 🚀 Телепортироваться на базу | home | clan.use ||
/clan bank deposit <$> | 💰 Пополнить казну клана | bank deposit | clan.use ||
/clan bank withdraw <$> | 💸 Снять деньги | bank withdraw | clan.use ||
/clan top | 🏆 Рейтинг лучших кланов | top | clan.use |---
## 🛠️ Команды администратора
Основная команда:
/clanadmin (алиасы: /cadmin, /ca)Право на использование:
clan.admin| Команда | Описание |
|:--- |:--- |
|
/clanadmin reload | 🔄 Мгновенная перезагрузка всех конфигов ||
/clanadmin disband <клан> | 🧨 Принудительное удаление клана ||
/clanadmin setlevel <клан> <ур> | 📈 Изменение уровня клана ||
/clanadmin addexp <клан> <кол-во> | ✨ Выдача опыта клану ||
/clanadmin setleader <клан> <ник> | 👑 Смена владельца клана |---
## 📊 PlaceholderAPI
Используйте эти переменные в других плагинах (Scoreboard, Chat, TAB).
Идентификатор:
%clan_...%### Статистика клана
*
%clan_name% / %clan_name_colored% — Название клана (обычное / цветное).*
%clan_tag% / %clan_tag_colored% — Тег клана (обычный / цветное).*
%clan_level% / %clan_level_full% — Уровень клана (число / оформленный).*
%clan_members% / %clan_online_members% — Кол-во участников (всего / онлайн).*
%clan_max_members% — Лимит участников для текущего уровня.*
%clan_leader% — Ник лидера клана.*
%clan_has_clan% — Состоит ли игрок в клане (true/false).*
%clan_is_leader% — Является ли игрок лидером (true/false).*
%clan_pvp_enabled% — Включен ли PvP в клане.*
%clan_has_home% — Установлена ли база клана.### Экономика
*
%clan_balance% / %clan_treasury% — Баланс казны клана.*
%clan_bank_formatted% — Отформатированный баланс (напр. 1.5k).### PvP и Прогресс
*
%clan_kills% / %clan_deaths% — Общие убийства и смерти клана.*
%clan_kdr% — Коэффициент K/D клана.*
%clan_experience% / %clan_experience_formatted% — Опыт клана.*
%clan_top_position_level% — Место в топе по уровню.*
%clan_top_position_treasury% — Место в топе по казне.*
%clan_top_position_kills% — Место в топе по убийствам.### Личная статистика (внутри клана)
*
%clan_rank% / %clan_rank_prefix% — Ранг игрока и его префикс.*
%clan_player_kills% / %clan_player_deaths% — Убийства и смерти игрока.*
%clan_player_kdr% — Личный K/D игрока.*
%clan_player_contribution% — Вклад игрока в опыт клана.### Динамические топы
*
%clan_top_<номер>_name% — Название клана на X месте.*
%clan_top_<номер>_level% — Уровень клана на X месте.*
%clan_top_<номер>_leader% — Лидер клана на X месте.---
## 🔐 Внутренние права клана (Internal Permissions)
Эти права настраиваются лидером для каждого ранга отдельно.
| Право | Описание |
|:--- |:--- |
|
CHAT | Доступ к клановому чату ||
HOME | Телепортация на базу ||
SET_HOME | Установка точки базы ||
INVITE | Приглашение новых игроков ||
KICK | Исключение участников ||
PROMOTE | Повышение ранга участников ||
DEMOTE | Понижение ранга участников ||
STORAGE_VIEW | Просмотр хранилища клана ||
STORAGE_MODIFY | Изменение содержимого хранилища ||
BANK_DEPOSIT | Внесение средств в казну ||
BANK_WITHDRAW | Снятие средств из казны ||
MANAGE_QUESTS | Управление клановыми заданиями ||
UPGRADE_STORAGE | Повышение уровня хранилища ||
CHANGE_SETTINGS | Изменение общих настроек клана ||
DISBAND | Расформирование клана |---
## ⚙️ Конфигурация
Плагин разделен на несколько файлов для удобства:
*
config.yml — Основные настройки (стоимость создания, PvP).*
messages.yml — Полная локализация всех строк.*
levels.yml — Настройка прогрессии и наград за уровни.*
gui.yml — Визуальная настройка всех меню.*
quests.yml — Редактор заданий.