Плагин ShulkerKing v2.0.1

[Djstim]

ShulkerKing v2.0.3
Современный плагин для Minecraft Spigot/Paper для открытия шалкер-боксов прямо из руки



Основные возможности
Базовый функционал

• Открытие шалкер-боксов правым кликом из главной или второй руки
• Размещение шалкер-боксов с сохранением содержимого через Shift+ПКМ
• Многоязычная поддержка (русский, английский и другие языки)
• Звуковые эффекты для всех действий
• Визуальные кулдауны с отображением на предмете

️ 6-уровневая защита от дюпа багов

1. Контроль предметов в руке - отслеживание изменений предмета
2. Защита от вложенности - запрет помещения шалкер-боксов в шалкер-боксы
3. Система кулдаунов - персональные и групповые ограничения
4. PvP блокировка - запрет использования во время боя
5. Защита от автоматизации - блокировка хопперов и внешних воздействий
6. Черные списки - ограничения по предметам и мирам

⚙️ Расширенные настройки

• Система прав доступа с детальной настройкой
• Черный список предметов с настраиваемыми действиями
• Черный список миров для ограничения использования
• Настраиваемые звуки для всех событий
• Визуальные эффекты и уведомления

Требования

• Minecraft: 1.16.2 - 1.21+
• Сервер: Spigot, Paper, Purpur или совместимые
• Java: 8 или выше
• ОЗУ: Минимум 512 МБ свободной памяти

Установка

1. Скачайте последнюю версию плагина
2. Поместите файл ShulkerKing-2.0.3.jar в папку plugins/
3. Перезапустите сервер
4. Настройте конфигурацию в файле plugins/ShulkerKing/config.yml
5. Перезагрузите плагин командой /shulkerking reload

Использование
Основные действия

• ПКМ по воздуху или блоку с шалкер-боксом в руке - открыть инвентарь
• Shift + ПКМ - разместить шалкер-бокс с сохранением содержимого
• Перетаскивание предметов в открытом инвентаре шалкер-бокса

Команды

• /shulkerking - основная команда плагина
• /shulkerking reload - перезагрузить конфигурацию
• /shulkerking info - информация о плагине
• /shulkerking debug - переключить режим отладки

Права доступа
# Основные права
shulkerking.open # Открытие шалкер-боксов
shulkerking.place # Размещение шалкер-боксов
shulkerking.offhand # Использование второй руки
shulkerking.admin # Административные команды

# Права для кулдаунов
shulkerking.cooldown.vip # Уменьшенный кулдаун для VIP
shulkerking.cooldown.premium # Минимальный кулдаун для Premium
shulkerking.cooldown.bypass # Полное отключение кулдауна

Многоязычность
Плагин поддерживает множество языков. Файлы локализации находятся в папке languages/:

• en_us.yml - Английский (по умолчанию)
• ru_ru.yml - Русский
• de_de.yml - Немецкий
• fr_fr.yml - Французский
• es_es.yml - Испанский

Добавление нового языка

1. Скопируйте файл en_us.yml
2. Переименуйте в код нужного языка (например, it_it.yml)
3. Переведите все сообщения
4. Перезагрузите плагин

Отладка и диагностика
Включение режима отладки
settings:
debug: true
Или командой:

/shulkerking debug

Логи отладки
Плагин выводит подробные логи в консоль:

[ShulkerKing] [DEBUG] Opening shulker inventory for Player (main hand: true)
[ShulkerKing] [SAVE] Starting to save shulker contents for Player
[ShulkerKing] [PLACE] Copying 5 items to placed shulker

Проверка состояния менеджеров
/shulkerking info

Производительность
Оптимизации

• Асинхронные задачи для очистки данных
• Кэширование конфигурации для быстрого доступа
• Throttling сохранений (максимум раз в 100мс)
• Автоматическая очистка истекших данных

Рекомендации

• Используйте Paper для лучшей производительности
• Настройте кулдауны в зависимости от нагрузки сервера
• Регулярно очищайте логи при включенной отладке

Безопасность
Защита от эксплойтов

• ✅ Защита от дублирования предметов
• ✅ Защита от вложенности шалкер-боксов
• ✅ Защита от внешних воздействий (хопперы)
• ✅ Защита от изменения предметов в руке
• ✅ Защита от использования во время PvP
• ✅ Система кулдаунов против спама

Проверенные сценарии

• Быстрая смена предметов в руке
• Выбрасывание шалкер-бокса во время использования
• Попытки поместить шалкер-бокс в себя
• Взаимодействие с хопперами
• Использование во время боя
• Перезагрузка сервера с открытыми инвентарями

Поддержка
Сообщение об ошибках

1. Включите режим отладки
2. Воспроизведите ошибку
3. Скопируйте логи из консоли
4. Создайте issue с подробным описанием

Запрос новых функций

• Опишите желаемую функцию
• Укажите случаи использования
• Приложите примеры конфигурации

Changelog
v2.0.3 (2025-08-23)

• Исправлен критический баг потери предметов при размещении шалкер-боксов
• ⚡ Улучшена система размещения с отложенными задачами
• Добавлено подробное логирование для диагностики
• Оптимизирована обработка блочных состояний

v2.0.2

• ️ Усилена защита от дублирования предметов
• Улучшена система звуков
• Расширена поддержка языков
• ⚙️ Добавлены новые настройки конфигурации

v2.0.1

• Добавлена защита от хопперов
• Улучшена производительность
• Исправлены мелкие баги

v2.0.0

• Полная переработка архитектуры
• ️ 6-уровневая система защиты от дюпов
• Визуальные кулдауны
• Многоязычная поддержка
• ⚡ Значительное улучшение производительности