PotionLimiter

PotionLimiter - это легковесный плагин для серверов на Paper 1.21.1+, который решает извечную проблему администраторов: как контролировать варку зелий, не ломая игровой процесс. В ванильном Minecraft зелья могут быть слишком сильными для PvP, нарушать баланс или просто не вписываться в концепцию сервера. PotionLimiter даёт гибкие инструменты: от бана отдельных типов зелий до настройки по мирам и красивых уведомлений.

Плагин написан на Java 21 с использованием Paper API и Kyori Adventure (MiniMessage), так что он лёгкий, быстрый и совместим с будущими обновлениями. Никакого NMS - просто перезагрузил конфиг и работаешь.

Основные возможности

Точный контроль над зельями

• Блокируй конкретные типы зелий (например, STRENGTH, LONG_STRENGTH, STRONG_STRENGTH)
• Поддержка всех зелий Minecraft 1.21, включая новые: Wind Charged, Weaving, Oozing, Infested
• Встроенный справочник всех доступных зелий в конфиге

Управление по мирам

• Режим чёрного списка: плагин отключён в указанных мирах (например, креатив, лобби)
• Режим белого списка: плагин работает только в указанных мирах (например, только в выживании)
• Гибкая настройка под любой тип сервера

Уведомления игроков

• Настраиваемый радиус оповещения
• Красивое форматирование через MiniMessage: градиенты, цвета, жирный текст
• Можно отключить уведомления (тихий режим)
• Индивидуальные сообщения для каждого зелья

Сохранение ингредиентов

• Если варка заблокирована, ингредиенты не тратятся - остаются в стойке
• Никакой лишней потери ресурсов

Удобство для админа

• Команда /plimit reload - перезагрузка конфига без перезапуска сервера
• /plimit list - показывает все заблокированные зелья и ограничения по мирам
• Tab-дополнение для всех команд
• Понятные логи в консоли

Установка

1. Требования:

   • Minecraft Server 1.21.1 - 1.21.11
   • Paper (или форки: Purpur, Pufferfish)
   • Java 21+

2. Шаги:

   Скачайте PotionLimiter-1.0.0.jar
   Поместите в папку plugins/ вашего сервера
   Запустите/перезапустите сервер
   Отредактируйте plugins/PotionLimiter/config.yml
   Выполните /plimit reload в игре
   

Примеры использования

Пример 1: Заблокировать зелья силы во всех мирах

Идеально для PvP-серверов, где зелья силы слишком имбалансны.

blacklisted-potions:
  - STRENGTH
  - LONG_STRENGTH
  - STRONG_STRENGTH

Результат: игроки не смогут сварить ни одно зелье силы. Стойка не завершит процесс.

Пример 2: Отключить плагин в креативном мире

Разрешить варку без ограничений в творческом мире, но оставить в выживании.

world-settings:
  blacklist-mode: true   # режим чёрного списка
  blacklisted-worlds:
    - world_creative
    - lobby
    - skyblock_spawn

Результат: плагин отключён в world_creative, lobby и skyblock_spawn. Там можно варить всё. В остальных мирах ограничения действуют.

Пример 3: Работает только в мире выживания (белый список)

Включить плагин только в главном мире выживания, игнорируя остальные.

world-settings:
  blacklist-mode: false   # режим белого списка
  blacklisted-worlds:
    - world   # только здесь активен

Результат: плагин активен только в мире world. Во всех остальных - варка без ограничений.

Пример 4: Заблокировать все вредные зелья

Отлично подходит для мирных/ролеплей серверов.

blacklisted-potions:
  - HARMING
  - STRONG_HARMING
  - POISON
  - LONG_POISON
  - STRONG_POISON
  - WEAKNESS
  - LONG_WEAKNESS

Пример 5: Запретить невидимость для честного PvP

Предотвратить использование зелий невидимости на PvP-аренах.

blacklisted-potions:
  - INVISIBILITY
  - LONG_INVISIBILITY

Пример 6: Заблокировать новые зелья 1.21

Отключить экспериментальные зелья, добавленные в 1.21.

blacklisted-potions:
  - WIND_CHARGED
  - WEAVING
  - OOZING
  - INFESTED

Пример 7: Настройка уведомлений

Настроить, как игроки узнают о блокировке варки.

brewing-settings:
  notify-players: true
  notify-radius: 10   # 10 блоков
  blocked-message: "<gradient:ff0000:ff6666>⚠ Вы не можете сварить <potion> на этом сервере!</gradient>"

Результат: игроки в радиусе 10 блоков от стойки увидят градиентное красное сообщение.

Пример 8: Тихий режим (без уведомлений)

Блокировать варку без оповещения игроков.

brewing-settings:
  notify-players: false

Результат: варка блокируется молча. Только в консоли будет запись.

Типичные сценарии использования

1. PvP-серверы

# Блокируем слишком сильные зелья для баланса
blacklisted-potions:
  - STRONG_STRENGTH
  - STRONG_HEALING
  - LONG_INVISIBILITY
  - TURTLE_MASTER
  - STRONG_TURTLE_MASTER

2. Серверы выживания с кастомными механиками

# Заставляем игроков добывать зелья через магазины или квесты
blacklisted-potions:
  - REGENERATION
  - LONG_REGENERATION
  - STRONG_REGENERATION
  - HEALING
  - STRONG_HEALING

3. Минигейм-серверы

# Отключаем плагин в мирах минигеймов, оставляем в лобби
world-settings:
  blacklist-mode: true
  blacklisted-worlds:
    - bedwars
    - skywars
    - parkour

4. Ролеплей / мирные серверы

# Блокируем все боевые и вредные зелья
blacklisted-potions:
  - HARMING
  - STRONG_HARMING
  - POISON
  - LONG_POISON
  - STRONG_POISON
  - STRENGTH
  - LONG_STRENGTH
  - STRONG_STRENGTH

5. Экономические серверы

# Блокируем дорогие зелья для стабильности экономики
blacklisted-potions:
  - STRONG_HEALING
  - STRONG_REGENERATION
  - LONG_NIGHT_VISION
  - LONG_WATER_BREATHING

Команды

Команда	Описание	Право
/plimit reload	Перезагрузить конфиг без перезапуска	potionlimiter.admin
/plimit list	Показать все заблокированные зелья и миры	potionlimiter.admin
/plimit help	Вывести справку	potionlimiter.admin

Алиасы: /potionlimiter, /pl

Права доступа

Право	Описание	По умолчанию
potionlimiter.admin	Доступ ко всем командам	OP

Справочник по конфигурации

brewing-settings

brewing-settings:
  return-ingredients: true       # Сохранять ингредиенты при блокировке (всегда true на Paper)
  notify-players: true           # Отправлять сообщения игрокам рядом
  notify-radius: 5               # Радиус уведомления в блоках
  blocked-message: "<red>⚗ Варка <potion> отключена!</red>"

world-settings

world-settings:
  blacklist-mode: true           # true = отключить в перечисленных мирах, false = только в перечисленных
  blacklisted-worlds:
    - world_creative
    - lobby

blacklisted-potions

blacklisted-potions:
  - STRENGTH                     # Названия PotionType
  - LONG_STRENGTH
  - STRONG_STRENGTH

messages

messages:
  prefix: "<gradient:00ffff:0080ff>[PotionLimiter]</gradient> "
  reload-success: "<green>Конфигурация успешно перезагружена!</green>"
  reload-error: "<red>Ошибка перезагрузки! Проверьте консоль.</red>"
  no-permission: "<red>У вас нет прав на эту команду.</red>"
  list-header: "<gradient:ff0000:ff6666>===== Заблокированные зелья =====</gradient>"
  list-item: "<red>- <potion></red>"
  list-empty: "<yellow>Сейчас нет заблокированных зелий.</yellow>"
  list-footer: "<gray>Всего: <count> зелье(й) заблокировано</gray>"

Все доступные типы зелий (1.21)

Нажмите, чтобы развернуть полный список

Базовые зелья

• WATER - Бутылка воды
• MUNDANE - Заурядное зелье
• THICK - Густое зелье
• AWKWARD - Странное зелье

Скорость

• SWIFTNESS - Скорость I (3:00) ⚠️ Новое название (было SPEED)
• LONG_SWIFTNESS - Скорость I (8:00)
• STRONG_SWIFTNESS - Скорость II (1:30)

Замедление

• SLOWNESS - Замедление I (1:30)
• LONG_SLOWNESS - Замедление I (4:00)
• STRONG_SLOWNESS - Замедление IV (0:20)

Сила

• STRENGTH - Сила I (3:00)
• LONG_STRENGTH - Сила I (8:00)
• STRONG_STRENGTH - Сила II (1:30)

Исцеление

• HEALING - Мгновенное здоровье I ⚠️ Новое название (было INSTANT_HEAL)
• STRONG_HEALING - Мгновенное здоровье II

Урон

• HARMING - Мгновенный урон I ⚠️ Новое название (было INSTANT_DAMAGE)
• STRONG_HARMING - Мгновенный урон II

Прыгучесть

• LEAPING - Прыгучесть I (3:00) ⚠️ Новое название (было JUMP_BOOST)
• LONG_LEAPING - Прыгучесть I (8:00)
• STRONG_LEAPING - Прыгучесть II (1:30)

Регенерация

• REGENERATION - Регенерация I (0:45)
• LONG_REGENERATION - Регенерация I (1:30)
• STRONG_REGENERATION - Регенерация II (0:22)

Огнестойкость

• FIRE_RESISTANCE - Огнестойкость (3:00)
• LONG_FIRE_RESISTANCE - Огнестойкость (8:00)

Подводное дыхание

• WATER_BREATHING - Подводное дыхание (3:00)
• LONG_WATER_BREATHING - Подводное дыхание (8:00)

Невидимость

• INVISIBILITY - Невидимость (3:00)
• LONG_INVISIBILITY - Невидимость (8:00)

Ночное зрение

• NIGHT_VISION - Ночное зрение (3:00)
• LONG_NIGHT_VISION - Ночное зрение (8:00)

Слабость

• WEAKNESS - Слабость (1:30)
• LONG_WEAKNESS - Слабость (4:00)

Отравление

• POISON - Отравление I (0:45)
• LONG_POISON - Отравление I (1:30)
• STRONG_POISON - Отравление II (0:21)

Черепашья сила

• TURTLE_MASTER - Черепашья сила I (0:40)
• LONG_TURTLE_MASTER - Черепашья сила I (1:20)
• STRONG_TURTLE_MASTER - Черепашья сила II (0:20)

Медленное падение

• SLOW_FALLING - Медленное падение (1:30)
• LONG_SLOW_FALLING - Медленное падение (4:00)

Новые зелья 1.21

• WIND_CHARGED - Заряженный ветром (3:00) 🆕
• WEAVING - Плетение (3:00) 🆕
• OOZING - Сочащийся (3:00) 🆕
• INFESTED - Заражённый (3:00) 🆕

Примеры форматирования MiniMessage

PotionLimiter использует MiniMessage для красивых сообщений. Всё настраивается в config.yml.

Градиент

blocked-message: "<gradient:ff0000:ffff00>⚠ Это зелье запрещено!</gradient>"

Радуга

blocked-message: "<✨>Вы не можете сварить <potion>!</✨>"

Жирный/курсив/подчёркивание

blocked-message: "<bold><red>ВАРКА ЗАБЛОКИРОВАНА:</red></bold> <italic><potion></italic>"

Текст при наведении

blocked-message: "<hover:show_text:'Свяжитесь с админом'><red>Варка отключена!</red></hover>"

Комбинированный эффект

blocked-message: "<gradient:ff0000:ff6666><bold>⚠ ЗАБЛОКИРОВАНО</bold></gradient> <gray>-</gray> <yellow><potion></yellow>"

Возможные проблемы

Зелья всё ещё варятся

1. Проверьте /plimit list - убедитесь, что зелья в чёрном списке
2. Используйте названия зелий для 1.21 (например, SWIFTNESS вместо SPEED)
3. Выполните /plimit reload после изменений конфига
4. Проверьте консоль на предупреждения "Invalid PotionType"
5. Убедитесь, что мир не в белом/чёрном списке

Предупреждения "Invalid PotionType" в консоли Значит, вы используете старые названия из 1.20. Обновите конфиг:

• ❌ SPEED → ✅ SWIFTNESS
• ❌ INSTANT_HEAL → ✅ HEALING
• ❌ JUMP_BOOST → ✅ LEAPING
• ❌ INSTANT_DAMAGE → ✅ HARMING

Плагин не работает в мире

1. Проверьте world-settings.blacklist-mode
2. Название мира должно совпадать точно (регистр важен)
3. Используйте имя папки мира, а не отображаемое имя

Игроки не получают уведомления

1. Убедитесь, что notify-players: true в конфиге
2. Увеличьте notify-radius
3. Проверьте синтаксис MiniMessage

Производительность

• Обработка событий: оптимизированное предсказание рецептов варки
• Память: обычно <5 MB
• Нагрузка на CPU: минимальная (<0.1% на современном железе)
• Без NMS: совместимость с будущими обновлениями

PotionLimiter - это must-have для любого сервера, где нужно тонко настроить варку зелий. Скачайте плагин PotionLimiter и возьмите под контроль баланс зельеварения на своём сервере Майнкрафт!