pnClans - Плагин на кланы 1.0.2

────────────────────────────────────

Что нового в v1.0.1

Автоматическое фоновое обновление — Auto-Updater

Плагин автоматически проверяет наличие новых версий на GitHub и скачивает обновление в папку plugins/update/.

Умная очистка — Automatic Cleanup

При запуске новой версии плагин автоматически находит и удаляет устаревшие версионные .jar-файлы из папки plugins/, поддерживая порядок на сервере.

────────────────────────────────────

Основная информация

Движок: Paper 1.20.4–1.26.2+
Язык: Kotlin 2.0+ / Java 21+
Хранилище: SQLite — рекомендуется / JSON
Зависимости: Vault — обязательно для экономики, PlaceholderAPI — опционально

────────────────────────────────────

Обзор pnClans

pnClans — это высокопроизводительный и полностью конфигурируемый фреймворк клановой системы нового поколения для серверов Minecraft на Paper и Spigot.

Плагин построен на современной архитектуре без использования устаревших NMS-костылей. Он обеспечивает полное управление через GUI, живую мультиплеерную синхронизацию кланового хранилища и многоуровневую защиту ресурсов.

────────────────────────────────────

Ключевые возможности

1. Живое мультиплеерное хранилище

Сеть слотов от 9 до 45

Количество доступных слотов автоматически увеличивается вместе с уровнем клана:

• 1 уровень — 9 слотов
• 2 уровень — 18 слотов
• Максимальный размер — 45 слотов на 5 уровне

Живая синхронизация — Real-time Shared View

Если несколько соклановцев одновременно открывают клановый сундук, они подключаются к единой сессии. Предмет, положенный одним игроком, мгновенно появляется у остальных без задержек.

Динамическая аналитика склада

Книга аналитики в слоте 45 в реальном времени отображает:

• Количество занятых слотов
• Процент заполнения хранилища
• Динамическую полосу прогресса: ■■■■■□□□□□

Информация обновляется при каждом взаимодействии с хранилищем.

Защита от потери предметов

Заблокированные слоты подсвечиваются красным стеклом и показывают необходимый уровень клана. Плагин не позволит распустить клан, пока в хранилище остаются предметы.

────────────────────────────────────

2. Финансовая казна и банк

Интеграция с Vault

Поддерживаются основные экономические плагины, работающие через Vault.

Быстрые транзакции без закрытия меню

Кнопки быстрых операций позволяют мгновенно пополнять или снимать средства:

• Пополнение: +500 и +1000
• Снятие: -500 и -1000

Баланс на центральном золотом блоке обновляется без закрытия и повторного открытия GUI.

Интерактивный ввод суммы через чат

Игрок может указать произвольную сумму, например 2500 или 100000. Во время ввода отображается боссбар, а отменить операцию можно командой cancel.

Постраничная история операций

Система сохраняет все:

• Пополнения казны
• Снятия средств
• Затраты на улучшение клана
• Дату и точное время операции
• Имя игрока, выполнившего операцию

История поддерживает удобную постраничную навигацию без визуальных артефактов.

────────────────────────────────────

3. Клановые дома и телепортация

Масштабируемые точки дома

Количество доступных клановых домов зависит от текущего уровня клана.

Безопасная асинхронная телепортация

Телепортация автоматически отменяется, если игрок:

• Начал двигаться
• Получил урон

────────────────────────────────────

4. Иерархия, состав и прокачка

Настраиваемые роли

По умолчанию доступны следующие роли:

• Лидер
• Заместитель
• Старейшина
• Участник

Названия, иерархию и иконки ролей можно настроить.

Управление участниками в один клик

• ЛКМ — повысить игрока
• ПКМ — понизить игрока
• Shift + ПКМ — исключить игрока
• Shift + ЛКМ — передать лидерство

Эволюция клана

Средства из казны можно использовать для повышения уровня клана. Вместе с уровнем увеличиваются:

• Максимальное количество участников
• Размер кланового хранилища
• Количество доступных точек дома

────────────────────────────────────

5. Модульность и приветственное меню

Интерфейс для игроков без клана — NoClanUX

Если игрок без клана использует команду /clan, ему открывается интерактивное меню с:

• Презентацией возможностей кланов
• Рейтингом существующих кланов
• Кнопкой быстрого создания собственного клана

Независимое управление модулями

В файле config.yml можно отключить любой модуль:

• homes
• treasury
• chest
• upgrades
• pvp

Отключённые модули автоматически скрываются из GUI. Связанные с ними подкоманды также блокируются.

────────────────────────────────────

6. Discord-аналитика и отчёты об ошибках

Автономный движок ErrorReporter

Система отчётов написана на чистом Java Stdlib HTTP API и не требует дополнительных сторонних библиотек.

Multipart-вебхук в Discord

При возникновении критической ошибки плагин автоматически отправляет в Discord подробный Embed-отчёт, содержащий:

• Использование оперативной памяти
• Текущий онлайн сервера
• Версию Java
• Информацию об операционной системе
• Полный стектрейс ошибки

К сообщению также прикрепляются диагностические файлы:

• stacktrace_full.txt
• config.yml
• menus.yml
• messages.yml

────────────────────────────────────

🛠 Настройка и конфигурация

config.yml — глобальные настройки


Параметры защиты при удалении клана:

• disbandRequireEmptyChest: true — запрещает распуск клана, если в хранилище остаются предметы
• disbandRequireEmptyBank: true — требует вручную вывести средства из казны перед удалением
• disbandAutoRefundBank: false — управляет автоматическим возвратом остатка казны лидеру

────────────────────────────────────

menus.yml — GUI и оформление

Файл отвечает за:

• Расположение слотов
• Названия кнопок
• Иконки элементов
• Цвета стеклянных панелей
• Внешний вид интерфейсов

По умолчанию используется оформление в стиле HotWorld с оранжево-чёрным стеклянным витражом.

────────────────────────────────────

Установка и первый запуск

Шаг 1. Загрузите файл pnClans-1.0.0-all.jar из раздела Assets текущего релиза.

Шаг 2. Переместите загруженный файл в папку /plugins/ вашего сервера Paper или Spigot.

Шаг 3. Убедитесь, что на сервере установлена экономика. Например:

• Vault
• EssentialsX

Шаг 4. Запустите или полностью перезапустите сервер.

Шаг 5. После запуска игроки смогут использовать команду /clan для создания клана и управления им.

────────────────────────────────────