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

[HR]
Что такое pnClans?
pnClans — полноценная клановая система, в которой основное управление происходит через удобные игровые GUI.
Плагин объединяет практически всё, что может понадобиться клановому серверу:

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

Большая часть визуального оформления, сообщений, слотов, материалов, названий предметов и описаний вынесена в конфигурацию.
Администратор может менять внешний вид плагина без необходимости редактировать исходный код.
[HR]
[HR]
Главные возможности
Кланы

• Создание собственного клана.
• Приглашение и исключение игроков.
• Управление участниками.
• Изменение настроек клана.
• Просмотр статистики.
• Топ кланов.
• Система клановых очков и уровней.

Роли и права
Лидер может создавать структуру клана и управлять разрешениями участников.
Права могут контролировать доступ к:

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

Всё управление происходит через GUI.
[HR]
Клановая казна
У каждого клана есть собственная казна.

• Внесение средств.
• Снятие средств при наличии прав.
• Быстрые суммы пополнения и снятия.
• Настраиваемые кнопки.
• История финансовых операций.
• Информация о пользователе, сумме, типе операции и времени.
• Защита операций от ошибок сохранения.

Суммы быстрых операций, позиции кнопок, таймаут ввода и слова отмены можно настроить.
[HR]
Общий склад клана
Клан получает собственное виртуальное хранилище ресурсов.

• Общий доступ участников.
• Доступ регулируется правами ролей.
• Вместимость зависит от настроек и развития клана.
• Заблокированные слоты имеют отдельные конфигурационные элементы.
• Оформление меню полностью настраивается.

[HR]
Клановые дома
Кланы могут создавать собственные точки телепортации.

• Создание дома.
• Удаление дома.
• Телепортация.
• Несколько точек.
• Управление через команды и GUI.

Примеры:
[HR]
Прокачка клана
Клан может развиваться и получать новые возможности.
Система рассчитана на постепенное развитие клана и взаимодействует с другими модулями плагина.
Меню уровней и улучшений также использует конфигурационные GUI-шаблоны.
[HR]
Клановый магазин
В pnClans присутствует полноценная система магазина.
Администратор может создавать собственные категории и товары.
Поддерживается:

• несколько категорий;
• редкости товаров;
• собственные материалы и оформление;
• несколько способов оплаты;
• Vault-экономика;
• PlayerPoints;
• собственные требования;
• связь с квестами;
• выдача предметов;
• выполнение консольных команд;
• несколько наград за одну покупку.

Для магазина используется отдельный файл:
Пример награды может одновременно выполнить команду и выдать настроенный предмет.
[HR]
Клановые квесты
Квесты имеют общий прогресс для всего клана.
Прогресс может начисляться за реальные действия участников:

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

Поддерживаются:

• зависимости между заданиями;
• prerequisites;
• ежедневное повторение;
• еженедельное повторение;
• клановые очки;
• настраиваемые награды;
• собственное GUI-оформление.

Конфигурация:
[HR]
Клановые битвы
pnClans содержит отдельную систему организованных боёв между кланами.
Один клан отправляет вызов другому, после подтверждения формируется матч.

• Боевые вызовы.
• Принятие и отклонение вызова.
• Настраиваемые арены.
• Точки появления двух команд.
• Подготовительное лобби.
• Формирование состава.
• READY-система.
• Обратный отсчёт.
• Ограничение территории боя.
• Лимит убийств.
• Ограничение по времени.
• Forfeit.
• MMR.
• Клановые очки.
• Боевые квесты.
• Защита от friendly fire между соклановцами.

MMR используется для организованных клановых сражений и не зависит от обычного случайного PvP в мире.
Настройки арен находятся в:
[HR]
PvP и friendly fire
Внутри клана можно управлять PvP-настройками.
Плагин также учитывает атаки с использованием снарядов и определяет владельца projectile, чтобы союзники не могли обходить защиту обычным луком или другими снарядами.
[HR]
Клановый чат
Для общения внутри клана можно использовать отдельный чат.
Поддерживаются разные варианты активации, например:
или отдельная команда кланового чата — в зависимости от настройки сервера.
[HR]
[HR]
Полная настройка GUI
Интерфейсы pnClans не привязаны жёстко к коду.
В menus.yml можно изменять:

• название меню;
• количество строк;
• слот предмета;
• Material;
• название предмета;
• lore;
• glow;
• действия при взаимодействии;
• звуки;
• расположение элементов.

GUI-элементы имеют стабильные ID.
Например:
Это позволяет полностью переделывать интерфейс под стиль конкретного сервера.
При обновлении плагина отсутствующие новые ключи автоматически добавляются в существующий конфиг без намеренного удаления пользовательских настроек.
[HR]
Файлы конфигурации
config.yml
— основные настройки, модули, экономика, роли, чат и другие параметры.
menus.yml
— GUI, предметы, слоты, названия и lore.
messages.yml
— сообщения, sounds, titles, action bars, particles и другие действия.
shop.yml
— магазин, товары, валюты, категории и награды.
quests.yml
— клановые задания.
battles.yml
— арены и правила организованных сражений.
[HR]
PlaceholderAPI
PlaceholderAPI поддерживается как дополнительная интеграция.
Это позволяет использовать данные pnClans в:

• TAB;
• scoreboard;
• чатах;
• holograms;
• других совместимых плагинах.

PlaceholderAPI не является обязательной зависимостью.
[HR]
Экономика
Для экономических функций поддерживается Vault.
Также магазин может использовать PlayerPoints как альтернативную валюту.
Vault требуется только в том случае, если на сервере используются связанные с экономикой возможности.
[HR]
Команды
Основная команда:
Алиасы:
Основные команды:
[HR]
Permissions
pnclans.use
— базовый доступ игроков к pnClans.
pnclans.admin
— административные возможности, управление, диагностика, reload и другие admin-функции.
Внутриклановые разрешения дополнительно контролируются собственной системой ролей pnClans.
[HR]
Система обновлений
В плагине присутствует автоматическая проверка обновлений.
Администратор выбирает канал:
STABLE — только стабильные версии.
BETA — beta + stable.
ALPHA — alpha + beta + stable.
Канал определяется по тегу GitHub:
При этом плагин не делает downgrade на более старую версию.
Для Java 21 и Java 25 автоматически выбирается соответствующий JAR.
[HR]
Хранилище данных
Поддерживается хранение данных через:

• SQLite;
• JSON.

[HR]
API и дополнения
pnClans рассчитан не только на самостоятельное использование.
Плагин имеет API и архитектуру, позволяющую подключать дополнительные модули и сторонние функции.
Это позволяет другим плагинам взаимодействовать с клановой системой без необходимости напрямую работать с её внутренним хранилищем.
[HR]
Установка
1. Скачайте JAR для своей Java.
2. Поместите файл в:
3. При необходимости установите Vault, PlaceholderAPI или PlayerPoints.
4. Перезапустите сервер.
5. pnClans автоматически создаст необходимые конфигурационные файлы.
[HR]
Совместимость
Сервер: Paper
Основная протестированная версия: Paper 1.21.11
Java:

• Java 21
• Java 25

Minecraft/Paper:
Paper 1.18+ является основным поддерживаемым диапазоном.
Paper 1.16.5–1.17.1 заявлен в режиме best effort — некоторые современные возможности могут зависеть от версии сервера.
[HR]
Текущая версия
Доступны две отдельные сборки:

• pnClans-1.2.2-beta.2-java21-all.jar
• pnClans-1.2.2-beta.2-java25-all.jar

Открыть текущий релиз
Все версии
[HR]
Обратная связь
Если вы нашли баг, неудобное место или у вас есть идея для новой функции — напишите об этом.
Особенно интересует обратная связь по:

• GUI;
• ролям и permissions;
• казне;
• складу;
• квестам;
• магазину;
• клановым битвам;
• балансу;
• производительности;
• совместимости с другими плагинами.

Даже небольшие замечания помогают улучшать pnClans.
[HR]