Animal Pens Paperized

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

Animal Pens Paperized позволяет организовать пространство для животных, заменяя свободный выпас в мире специализированными вольерами и аквариумами. Это решение помогает избавиться от лагов, вызванных огромными скоплениями мобов, сохраняя при этом возможность разводить, стричь, доить и собирать ресурсы с животных.

🎮 Механики работы

Для захвата животных используются специальные предметы:

• Animal Cage — для наземных существ.
• Animal Container — для водных обитателей.

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

Чтобы выпустить животное из вольера, необходимо нажать на него правой кнопкой мыши в режиме приседания (crouch click) на земле.

🎨 Особенности взаимодействий

Плагин включает ряд специфических механик:

• Водные обитатели: Рыбы едят водоросли и морскую траву, другие водные существа — рыбу.
• Лягушки: Выбрасывают Frog Lights при кормлении кубом магмы.
• Черепахи: Выбрасывают панцири (scutes) после кормления (время настройки).
• Снюхатели: Требуют чашу для выпадения семян.
• Разнообразие: При поднятии животного в клетку сохраняется его вариант; нажатие правой кнопкой мыши на животное без предметов позволяет просмотреть все сохраненные варианты.

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

Основной файл конфигурации находится по пути plugins/AnimalPenPlugin/config.json. В нем можно настроить:

• Кулдауны: Время ожидания между кормлением, стрижкой, сбором яиц и дойкой.
• Атака: Скорость, с которой игроки могут атаковать животных в вольере.
• Лимиты лута: Ограничение количества выпадающей шерсти и яиц для предотвращения переполнения.
• Система роста: Опциональная функция, при которой размер отображения вольера увеличивается в зависимости от количества животных (с регулируемым множителем).
• Статистика и достижения: Возможность отключить влияние действий в вольере на общую статистику и прогресс достижений.
• Список блокировки: Запрет захвата определенных типов мобов.

📦 Дополнительные данные и рецепты

Для расширения функционала можно использовать датапаки для изменения рецептов или добавления кастомных продуктов питания. Настройка продуктов питания выполняется в файле plugins/AnimalPenPlugin/animal_foods.json.

{
  // optional value. Defines when the food items should be loaded
  "<animal>": [
    "<mod>:<item>", // for items
    "#<mod>:<tag>"  // for tags (# at front)
  ]
}

📜 Команды управления

Модераторы сервера могут использовать следующие команды для управления плагином:

• /animal_pen reset — сброс конфигурационного файла к значениям по умолчанию
• /animal_pen reload — перезагрузка конфигурации без перезапуска сервера
• /animal_pen items — открытие креативного меню для получения кастомных предметов

❓ FAQ

🔹 Точные клики
В среде Paper взаимодействие разделено между сущностями и блоками:

• Вольеры и контейнеры взаимодействуют только при установке на плиты из гладкого камня.
• Убийство и другие взаимодействия с сущностями выполняются только при прямом клике по животному.
• Разрушение конструкций возможно только путем разрушения базовой плиты из гладкого камня.

🔹 Вода в аквариумах
В ванильном Minecraft водные существа вне воды всегда поворачиваются боком из-за жестко заданного поведения. В рамках плагина для Paper изменить это поведение невозможно, однако проблему можно нивелировать с помощью официального ресурспака проекта.