- Версия Java
-
- 25
- Ядро
-
- Paper
- Purpur
- Поддерживаемые версии
-
- 1.21.x
- 1.30.x
❖ pnClans v1.0.1
Advanced Clan Engine Framework
Продвинутая клановая система для Minecraft-серверов
────────────────────────────────────
Что нового в 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 для создания клана и управления им.
────────────────────────────────────
pnClans
Современная клановая система с живым хранилищем, казной, прокачкой и полным GUI-управлением.
Advanced Clan Engine Framework
Продвинутая клановая система для Minecraft-серверов
────────────────────────────────────
Что нового в 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 — опционально
────────────────────────────────────
Обзор pnClanspnClans — это высокопроизводительный и полностью конфигурируемый фреймворк клановой системы нового поколения для серверов 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 — глобальные настройки Код:
[HEADING=2]Модули фреймворка[/HEADING]
modules:
homes: true
treasury: true
chest: true
upgrades: true
pvp: true
[HEADING=2]Тип хранилища данных:[/HEADING]
[HEADING=2]SQLITE рекомендуется, также доступен JSON[/HEADING]
storageType: "SQLITE"
[HEADING=2]Стоимость создания клана[/HEADING]
createClanCost: 1000.0
[HEADING=2]Быстрые пресеты для казны[/HEADING]
treasuryDepositPresets: [500, 1000]
treasuryWithdrawPresets: [500, 1000]
[HEADING=2]Правила защиты при распуске клана[/HEADING]
disbandRequireEmptyChest: true
disbandRequireEmptyBank: true
disbandAutoRefundBank: false
[HEADING=2]Названия ролей[/HEADING]
roleLeader: "Лидер"
roleDeputy: "Заместитель"
roleElder: "Старейшина"
roleMember: "Участник"Параметры защиты при удалении клана:
• 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 для создания клана и управления им.
────────────────────────────────────
pnClans
Современная клановая система с живым хранилищем, казной, прокачкой и полным GUI-управлением.
