Shield Stuns

Shield Stuns - лёгкий плагин для серверов на Paper, который автоматически включает настройку skip-vanilla-damage-tick-when-shield-blocked. Без него блокирование щитом в Майнкрафт часто работает с багами: урон проходит не в тот момент, анимация сбивается, а в PvP это критично. Плагин решает проблему раз и навсегда - просто киньте .jar в папку plugins и перезапустите сервер.

Что делает ShieldStuns

Настройка, которую активирует плагин, меняет тайминг получения урона при блоке щитом. В результате:

• Щит работает более отзывчиво - блокировка происходит точно в момент удара.
• Атакующий получает небольшое оглушение (стан), если его удар пришёлся по щиту.
• PvP становится честнее и динамичнее, особенно на серверах с активными сражениями.

Плагин не добавляет новых команд, GUI или разрешений. Он делает всё сам при запуске сервера.

Особенности

• Автонастройка - при первом запуске ShieldStuns сам правит paper-global.yml.
• Нулевая конфигурация - ничего не нужно вводить, просто положите файл в plugins.
• Умное обнаружение - при повторных запусках плагин проверяет, не изменилась ли настройка, и не трогает лишнего.
• Безопасность - создаёт корректный YAML, не ломает конфиг.
• Логирование - в консоли чётко видно, что сделал плагин и нужно ли перезагружать сервер.
• Устойчивость к ошибкам - если какого-то раздела в конфиге нет, плагин создаст его.

Требования

• Paper версии 1.19 и выше (Spigot/Bukkit не поддерживаются).
• Java 17+.
• Перезапуск сервера после первой установки.

Установка

1. Скачайте файл ShieldStuns.jar.
2. Поместите его в папку plugins/ вашего сервера.
3. Запустите сервер.
4. После того как в консоли появятся сообщения об успешной настройке, перезапустите сервер ещё раз (это нужно, чтобы Paper применил изменения).
5. Готово - плагин больше не потребует вмешательства.

Что вы увидите в консоли

При первом запуске:

[ShieldStuns] ShieldStuns plugin is enabling...
[ShieldStuns] Modified paper-global.yml successfully!
[ShieldStuns] Successfully enabled skip-vanilla-damage-tick-when-shield-blocked!
[ShieldStuns] Server restart required for changes to take effect!
[ShieldStuns] ShieldStuns plugin enabled successfully!

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

Важно знать

• Плагин работает только на Paper. На Spigot или Bukkit он не сможет изменить конфиг.
• После установки нужен перезапуск, чтобы изменения вступили в силу.
• После того как настройка применена, плагин можно удалить - она останется в paper-global.yml. Но лучше оставить, чтобы при обновлениях Paper настройка не сбросилась.

Технические детали

• Автор: PoggerCity
• Версия: 1.0.0
• API-версия: 1.21+
• Фаза загрузки: STARTUP (загружается рано, чтобы изменить конфиг до других плагинов)
• Зависимости: нет

Устранение неполадок

Сообщение "paper-global.yml not found"

• Убедитесь, что используется Paper, а не Spigot/Bukkit.
• Запустите сервер хотя бы раз, чтобы сгенерировались файлы конфигурации.

Изменения не применяются

• Перезапустите сервер после первого запуска плагина.
• Проверьте консоль на наличие ошибок.

Ошибки прав доступа

• Убедитесь, что у серверного процесса есть права на запись в папку config/.

ShieldStuns - это простой и незаметный инструмент для владельцев серверов, которые хотят, чтобы щиты в Майнкрафт работали так, как задумано разработчиками и как привыкли игроки в PvP. Скачайте плагин Shield Stuns и забудьте о ручной правке конфигов.