hClans (Эйч кланс)

Плагин для серверов Майнкрафт добавляет систему кланов с ролями, приглашениями, уровнями и опытом. Игроки создают кланы, управляют составом и получают лимит участников, зависящий от уровня клана.

Возможности

• Создание и удаление кланов, приглашение игроков, принятие или отклонение приглашений, выход из клана и исключение участников.
• Приглашения действуют ограниченное время; срок задаётся ключом settings.clans.inviteExpirationSeconds.
• Роли владельца и участника настраиваются, а права клана определяют, кто может приглашать, исключать игроков и удалять клан.
• Для каждого уровня задаются нужный опыт и максимальное число участников.
• Проверки перед созданием клана можно настроить через условия PlaceholderAPI: например, потребовать определённый уровень игрока.
• Визуальный редактор имени клана позволяет выбрать шрифт, цвета, начертание, подчёркивание и посмотреть результат перед подтверждением.
• Поддерживаются SQLite и MySQL, а также дополнения из папки plugins/hClans/addons/.
• Плейсхолдеры PlaceholderAPI с идентификатором hclans выводят данные о клане, владельце, участниках, ролях и приглашении.

Команды

• /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> <action> <amount> — изменить уровень или опыт клана. Доступные действия: addlvl, addexp, removelvl, removeexp, setlevel, setexp.

Права

Права Bukkit:

• hclans.use
• hclans.reload
• hclans.levels

Права ролей клана:

• hclans.invite
• hclans.kick
• hclans.delete
• hclans.leave
• hclans.request.accept
• hclans.request.deny
• hclans.request.expire

Настройка

Основные параметры, роли, уровни, ограничения имени и хранилище находятся в plugins/hClans/config.yml; MySQL включается в этом файле, а SQLite используется по умолчанию. Редактор внешнего вида названия клана настраивается в plugins/hClans/clanCreator.yml.

Можно задать минимальную и максимальную длину названия, проверку по регулярному выражению, список запрещённых названий и условия создания. Для сообщений и событий доступны действия вроде [MESSAGE], [SOUND], [TITLE], [BROADCAST], [VAULT] и другие.

Требования

Нужны Java 21 или новее, сервер на Spigot, Paper либо совместимом ядре и PlaceholderAPI. Для действий с экономикой требуется совместимая с Vault экономика; MySQL и дополнения hClans подключаются при необходимости.