![hClans [1.16.X-26.X] | XSkull, PAPI, Vault и много чего ещё поддерживается](/data/resource_icons/5/5388.jpg?1776541268){kind=icon}
- Поддерживаемые версии
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20
- 1.21
- Ядра и Прокси
- Bukkit
- Spigot
- Paper
- Минимальная версия Java
- 17
hClans
Настраиваемая система кланов с ролями, уровнями, приглашениями и API для аддонов
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Настраиваемая система кланов с ролями, уровнями, приглашениями и API для аддонов
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hClans — это настраиваемая система кланов для Minecraft-серверов.
Плагин добавляет создание кланов, приглашения, управление участниками, клановые роли, систему прав, уровни, опыт, PlaceholderAPI-плейсхолдеры, SQLite/MySQL-хранилище и систему аддонов для расширения функционала.
hClans работает как основа клановой системы: основной плагин отвечает за логику кланов, базу данных, команды, роли, права, плейсхолдеры и API, а аддоны могут добавлять меню, хранилища, команды, события и дополнительные интеграции.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Основные возможности
- Создание и удаление кланов.
- Приглашения в клан с временем жизни.
- Принятие и отклонение приглашений.
- Исключение участников и выход из клана.
- Система ролей и клановых прав.
- Настраиваемые роли владельца и участника.
- Уровни и опыт клана.
- Лимиты участников по уровню клана.
- Поддержка PlaceholderAPI.
- SQLite и MySQL-хранилище.
- Настройка длины названия и regex-проверки.
- Список запрещённых названий кланов.
- Условия создания клана через PlaceholderAPI.
- GUI создания визуального названия клана.
- Настраиваемые цвета, шрифты и стили текста.
- Загрузчик аддонов для расширения системы.
- API и события для разработчиков.
- Поддержка HEX-цветов.
- Настраиваемая система actions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Управление кланом
Игроки могут создавать кланы, приглашать других игроков, принимать или отклонять приглашения, выходить из клана, исключать участников и удалять клан при наличии нужных прав.
Основные действия:
- создание клана
- приглашение игроков
- принятие и отклонение приглашений
- исключение участников
- выход из клана
- удаление клана
Названия кланов можно контролировать через:
- минимальную длину
- максимальную длину
- regex-проверку
- список запрещённых названий
- условия создания
────────────────────────────────────────
Приглашения
hClans имеет встроенную систему приглашений.
Приглашения временные и истекают через указанное время.
Стандартное время жизни приглашения:
Код:
settings:
clans:
inviteExpirationSeconds: 300Сообщения приглашений могут содержать кликабельный текст через систему actions.
────────────────────────────────────────
Подтверждение удаления
Удаление клана может требовать точного подтверждения через:
Код:
/clan delete <name>Настройка:
Код:
settings:
clans:
confirmDelete: trueЭто помогает защититься от случайного удаления клана.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Роли и права
hClans включает систему ролей и клановых прав.
Стандартные роли:
Код:
owner
memberРоль owner используется как роль владельца клана и имеет особый доступ к управлению кланом.
Роль member можно настроить через список клановых прав.
Стандартное право участника:
Код:
hclans.leaveВстроенные клановые права:
Код:
hclans.invite
hclans.kick
hclans.delete
hclans.leave
hclans.request.accept
hclans.request.deny
hclans.request.expireАддоны также могут регистрировать собственные клановые права через API hClans.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Уровни и опыт
hClans поддерживает настраиваемые уровни клана.
Для каждого уровня можно задать:
- необходимый опыт
- максимальный лимит участников
Пример:
Код:
settings:
levels:
lvl:
1:
exp: 0
maxMembers: 10
2:
exp: 300
maxMembers: 15
3:
exp: 500
maxMembers: 25Администрация может управлять уровнем и опытом клана через команды.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GUI создания клана
В hClans есть опциональное GUI для настройки визуального названия клана при создании.
Файл настройки:
Код:
plugins/hClans/clanCreator.ymlGUI поддерживает:
- выбор шрифта
- small caps стиль
- переключение жирного текста
- переключение курсива
- переключение подчёркивания
- три настраиваемые точки цвета
- предпросмотр названия
- кнопки подтверждения и отмены
- декоративные предметы
- кастомные головы через basehead материалы
Игрок может настроить внешний вид названия до создания клана.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Условия создания
Создание клана можно ограничить условиями на базе PlaceholderAPI.
Пример:
Код:
createConditions:
1:
check: '%player_level%'
type: '>='
value: 30
actions:
- '[MESSAGE] {prefix}&cВы не соответствуете условиям для создания клана.'Так можно требовать уровень, статистику, баланс или любое другое значение из PlaceholderAPI перед созданием клана.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Хранилище
hClans поддерживает два режима хранения:
- SQLite
- MySQL
SQLite используется по умолчанию и хранит данные в папке плагина.
MySQL можно включить для внешнего хранения данных.
Также есть настройка префикса таблиц, чтобы основной плагин и аддоны могли безопасно использовать одну базу.
Пример:
Код:
settings:
storage:
type: SQLITE
tablePrefix: hclans_━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Система аддонов
hClans может загружать аддоны из папки:
Код:
plugins/hClans/addons/Аддоны могут расширять систему кланов дополнительными функциями, командами, меню, хранилищами и интеграциями.
Основной плагин предоставляет системы для:
- клановых прав
- кастомных ролей
- кастомных подкоманд
- кастомных плейсхолдеров
- доступа к базе данных
- клановых событий
- утилит для голов и скинов
Загрузку аддонов можно включить или выключить в конфиге.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI
hClans регистрирует плейсхолдеры с идентификатором:
Код:
hclansДоступные плейсхолдеры:
Код:
%hclans_has_clan%
%hclans_invite_clan%
%hclans_clan%
%hclans_name%
%hclans_owner%
%hclans_owner_uuid%
%hclans_members%
%hclans_member_count%
%hclans_is_owner%
%hclans_roles%
%hclans_role_ids%
%hclans_role_count%Плагин также поддерживает кастомные плейсхолдеры, зарегистрированные через API или аддоны.
Значения для пустых и нулевых результатов настраиваются в config.yml.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Система actions
hClans использует настраиваемые actions для сообщений, команд, звуков, визуальных эффектов и экономики.
Примеры действий:
Код:
[MESSAGE]
[CONSOLE]
[PLAYER]
[BROADCAST]
[SOUND]
[TITLE]
[ACTIONBAR]
[BOSSBAR]
[PARTICLE]
[FIREWORK]
[EFFECT]
[VAULT]
[CLOSE]Actions можно использовать в сообщениях, приглашениях, условиях создания, предметах меню создания клана и обработке результатов.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Команды
Код:
/clan
/clan create <name>
/clan delete
/clan delete <name>
/clan invite <player>
/clan kick <player>
/clan accept <clan>
/clan deny <clan>
/clan leave
/hclans reload
/hclans levels <clan> <addlvl|addexp|removelvl|removeexp|setlevel|setexp> <amount>━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Права
Bukkit permissions:
Код:
hclans.use
hclans.reload
hclans.levelsКлановые права ролей:
Код:
hclans.invite
hclans.kick
hclans.delete
hclans.leave
hclans.request.accept
hclans.request.deny
hclans.request.expireАддоны могут регистрировать дополнительные клановые права.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Требования
- Java 17 или новее.
- Minecraft 1.16 или новее.
- Spigot / Paper / совместимое ядро.
- PlaceholderAPI.
Опционально:
- MySQL
- Vault-экономика для Vault actions
- аддоны hClans
Важно: PlaceholderAPI является обязательной зависимостью.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Установка
- Установите PlaceholderAPI.
- Поместите hClans.jar в папку plugins.
- Запустите или перезапустите сервер.
- Откройте plugins/hClans/config.yml.
- Настройте хранилище, роли, уровни и параметры кланов.
- Настройте clanCreator.yml, если хотите использовать визуальное меню создания.
- После изменения хранилища или важных настроек перезапустите сервер.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Примечания
- PlaceholderAPI обязателен для работы плагина.
- SQLite используется по умолчанию.
- MySQL можно включить в секции storage.
- Уровни клана могут влиять на максимальное количество участников.
- Папка addons используется для расширения системы.
- Меню создания клана настраивается через clanCreator.yml.
- Зависимости
- PlaceholderAPI (Обязательно), Vault (Опционально)
- Команды и права
- Выше всё написано
![hAntiLagMachines [1.16.X-26.X] | WG, WE и много чего ещё поддерживается](/data/resource_icons/5/5478.jpg?1778423996){kind=icon}
![hClansMenuAddon [1.16.X-26.X] | Дополнение для плагина hClans](/data/resource_icons/5/5534.jpg?1779380923){kind=icon}
