VO: Better Bats

🦇 Better Bats

«Из бесполезной пещерной помехи — в незаменимых экологических спутников.»

[!NOTE] Политика «1 JAR — 1 версия»: я собираю отдельный JAR для каждой версии Minecraft (например, MC 26.2, MC 26.3). Скачивайте именно ту сборку, которая соответствует вашей установке Minecraft.

Требования к зависимостям: для современных релизов Minecraft 26.x (26.1.2, 26.2, 26.3+) этому моду нужны и Fabric API, и Dasik Library (v1.8.15+). Старые сборки (1.20.1, 1.21.x) самодостаточны и требуют только Fabric API.

В ванильном Minecraft летучие мыши — чисто косметические, хаотичные ambient-сущности без какой-либо механики или интерактивной ценности. Они бесцельно влетают в лавовые озёра, спавнятся в кромешной тьме, не дропают ни предметов, ни опыта и пищат надоедливыми циклами, прежде чем раствориться в воздухе.

Better Bats превращает летучих мышей в живую, разумную и симбиотическую пещерную фауну. Используя настоящий алгоритм стайного полёта Boids, мыши организуются в плавные безлидерные воздушные стаи. Они спят вверх ногами на dripstone, цепях и фонарях, роняют натуральное гуано-удобрение на посевы внизу, охотятся на надоедливых насекомых-вредителей (чешуйниц, эндермитов) смертоносными пикирующими атаками, ориентируются в кромешной тьме пещер с помощью звуковых импульсов эхолокации, ночью слетаются к фонарям, как мотыльки, и динамично паникуют от громких взрывов или подкрадывающихся кошачьих хищников.

Часть Vanilla Outsider Collection — модов, которые дорабатывают ванильные механики по современным инженерным стандартам.

✨ Возможности

🐝 Мурмурация: стайный полёт по алгоритму Boids

Летучие мыши больше не летают хаотичными одиночными зигзагами:

• Безлидерные стаи: организованы настоящим трёхмерным алгоритмом стайного полёта Boids (сплочённость, выравнивание и разделение). Каждая мышь динамически корректирует полёт по соседям по стае.
• Настраиваемые лимиты стаи: набор в стаю чётко ограничен параметром bat_swarm_size (по умолчанию: 5 участников), что не даёт скоплениям разрастаться, сохраняя живую мурмурацию.
• Сумеречная воронка: в сумерках (12 000–14 000 тиков) и на рассвете (22 000–24 000 тиков) сплочённость и выравнивание усиливаются в 2,5 раза, а разделение сжимается — стаи эффектно стягиваются в воронку, покидая пещеры или залетая в них.

💩 Плодородие гуано и возобновляемая костная мука

Летучие мыши активно обогащают подземные фермы и наземные посевы:

• Накопление гуано на насесте: отдыхающие мыши, вися вверх ногами, тихо накапливают гуано. Когда порог достигнут (bat_guano_threshold, по умолчанию 12 000 тиков / ~10 минут), мышь запускает цикл удобрения гуано.
• Глубокое обогащение посевов: мышь сканирует до 20 блоков строго вниз. Если обнаружена грядка с посевами, она вызывает всплеск роста от костной муки, сопровождаемый ярко-зелёными частицами Happy Villager и падающими подсказками мицелия.
• Физический сбор гуано: включите better-bats:bat_drop_guano_item true, чтобы сидящие на насесте мыши роняли физические сущности предмета «Костная мука», когда отдыхают над блоками, не являющимися грядкой, или когда посевы внизу уже полностью созрели.

🦟 Симбиотическая борьба с вредителями (защита от Silverfish и Endermite)

Летучие мыши становятся ценными союзниками против подземных нашествий:

• Агрессивное пикирование: когда мыши обнаруживают Silverfish или Endermite в радиусе 10 блоков, они разрывают строй и совершают высокоскоростные атаки пикированием.
• Смертельные удары: мыши наносят масштабируемый урон (от 1.0 до 4.0), наследуемый через генетические признаки, быстро истребляя ползучих каменных вредителей, пока те не набросились на игрока.

🦇 Эхолокация в кромешной тьме пещер

Глубоко под землёй, где уровень освещения падает до абсолютного нуля, мыши используют биологический сонар:

• Акустические импульсы: при полёте в кромешной тьме (небесный свет 0, свет блоков < 4) мыши периодически издают высокочастотные эхолокационные щелчки.
• Частицы звуковых колец: каждый щелчок испускает едва заметные частицы Sculk Soul, давая исследователям видимую подсказку о потолках пещер и местах отдыха мышей высоко наверху.

🪔 Фототаксис: эффект мотылька

В ночное время мыши проявляют естественное влечение к яркому искусственному освещению:

• Кружение у фонарей: мыши отделяются от стай, чтобы исследовать источники света с яркостью > 8 (факелы, фонари, костры).
• Плавный полёт с креном: приближаются к фонарям плавным изогнутым манёвром с креном и кружат с мягким вертикальным покачиванием по синусоиде.
• Затухание после перерыва: после 10-30 секунд питания окружающими насекомыми у источника света мыши разлетаются и возвращаются к обычному стайному поведению.

😱 Акустическая паника и избегание хищников

Живые существа с чутким слухом и природными инстинктами выживания:

• Акустическое нарушение: громкие звуковые помехи (бегущие игроки, добыча блоков, взрывы) в пределах 16 блоков мгновенно будят отдыхающих мышей, вызывая панический высокоскоростной разлёт и сбрасывая таймеры гуано.
• Избегание кошачьих и фантомов: мыши постоянно сканируют естественных хищников (Cats, Ocelots, Phantoms) в радиусе 10 блоков. Отдыхающие мыши просыпаются мгновенно, а летящие получают мощные направленные векторы бегства, отталкивающие их от опасности.

🏠 Универсальные насесты

Теперь мыши могут висеть вверх ногами на реалистичных природных насестах:

• Pointed Dripstone: сталактиты, свисающие с потолков пещер.
• Iron Chains и висящие фонари: промышленные и подземельные крепления.
• Заборы, каменные стены и листва деревьев: поверхностные насесты в лесах и деревнях.
• Плиты и ступени: любая твёрдая нижняя поверхность.

🧬 Интеграция с Dasik Animal Genetics

Работает на базе API DasikLibrary Animal Genetics:

• Размах крыльев / масштаб: естественная физическая вариация от 0.75x до 1.30x масштаба.
• Скорость передвижения: скорость полёта варьируется от -4% до +8% в зависимости от генетического броска.
• Сила атаки: урон от пикирования на вредителей органично масштабируется от 1.0 до 4.0.

🧩 Совместимость и интеграция с HUD

• 100% совместимость на стороне сервера: работает полностью на сервере. Ванильные клиенты могут подключаться к модифицированным серверам без локальной загрузки чего-либо.
• Экран ModMenu + YACL: полноценный клиентский экран конфигурации в одиночной игре для визуальной настройки размеров стай и частоты гуано.
• Ноль загрязнения NBT: аксессоры состояния безопасно работают в памяти с бесшовными обновлениями сохранений мира.

📊 Краткий справочник и матрица механик

🚀 Внутриигровые команды и быстрый старт

Better Bats добавляет полноценный набор команд Brigadier, доступный через /betterbats или короткий алиас /bb:

⚙️ Конфигурация (нативные GameRules)

[!IMPORTANT] 💡 Конфиг или внутриигровые GameRules: Глобальный файл конфигурации (config/better-bats.json) задаёт значения по умолчанию только для новых миров. В уже существующих мирах меняй настройки прямо в игре через экран Edit Game Rules, команду /betterbats set или команду /gamerule.

📖 Подробное руководство и план действий

1. Как обустроить естественные насесты для летучих мышей в оранжереях

• Построй подземную оранжерею с высокими потолками (8–15 блоков в высоту).
• Подвесь остроконечный капельник, железные цепи или фонари к потолку над грядками.
• Летучие мыши, забредшие в оранжерею, сами выберут эти насесты для сна. Пока они отдыхают, они удобряют посевы на расстоянии до 20 блоков вниз примерно каждые 10 минут.

2. Как построить автоматическую башню возобновляемой костной муки

1. Включи выпадение физических предметов гуано через /bb set bat_drop_guano_item true.
2. Построй закрытую тёмную камеру с цепями, свисающими с потолка.
3. Поставь пол из воронок прямо под точками отдыха (в пределах 20 блоков вниз).
4. Когда летучие мыши отдыхают над воронками, их гуано выпадает в виде физических предметов-костной муки и попадает прямо в сундуки для хранения — и при этом не нужно убивать ни одного моба!

3. Защита от чешуйниц и нашествия в крепостях

• Во время рейдов по горным биомам или исследования подземных крепостей летучие мыши работают как система раннего предупреждения.
• Если каменные яйца монстров разобьются, nearby летучие мыши сразу пикируют на чешуйниц, принимая агрессию на себя и уничтожая их до того, как те размножатся.

4. Отгон стай летучих мышей с помощью кошачьих

• Если стаи летучих мышей собираются в месте, где вы хотите тишины, поставьте в комнате приручённую Кошку или Оцелота.
• Летучие мыши почуют хищника-кошачьего в радиусе 10 блоков, покинут свои насесты и улетят в более тёмные коридоры без хищников.

5. Ночное освещение крыльца и фототаксис

• Развесьте фонари вдоль дорожек или на внешних крыльцах. Ночью летучие мыши с поверхности будут лететь по изогнутым дугам к фонарю, грациозно кружа вокруг него 10-30 секунд, а затем улетая обратно в ночное небо.

🧩 Рекомендуемые родственные моды

Если вам нравится Better Bats, эти companion-моды из Vanilla Outsider Collection подключаются бесшовно:

• 🌾 Agrarian Reform: Офлайн-симуляция роста культур, умная защита от вытаптывания и глубокая ирригация, которые вознаграждают удобрение гуано летучих мышей.
• 🛏️ True Sleep: Ускорение ночи в реальном времени, при котором стаи летучих мышей пробуждаются и охотятся, пока вы отдыхаете.
• 🐕 Better Dogs: Глубокое поведение собак-компаньонов, режимы патрулирования сторожевых постов, генетические черты и езда на транспорте.

🌟 Изучите полную Vanilla Outsider Collection, чтобы найти больше улучшений ванильной игры.

💬 Присоединяйтесь к сообществу и получайте поддержку

☕ Поддержка

Если вам нравится Better Bats и Vanilla Outsider Collection, подумайте о том, чтобы поддержать будущие обновления!

[!NOTE] 🇮🇩 Индонезийские пользователи: SocioBuzz и Saweria поддерживают местные способы оплаты (Gopay, OVO, Dana и т.д.), если вы хотите поддержать меня без использования PayPal/Ko-fi!

📜 Благодарности и разрешения для модпаков

[!IMPORTANT] 📦 Разрешения для модпаков и распространение:
Вы полностью можете включать этот мод в любой модпак на любой платформе! Однако файл мода должен скачиваться напрямую через официальные каналы распространения (Modrinth или CurseForge). Повторная загрузка, зеркалирование или распространение оригинального JAR-файла мода на сторонних зеркалах, порталах-скраперах или несанкционированных лаунчерах строго запрещены.

⚖️ Лицензия и правила форков (без повторных загрузок без изменений):
Этот проект является открытым исходным кодом под GNU GPLv3. Вы полностью можете изучать код, учиться на нём и форкать репозиторий для создания настоящих модификаций, существенных расширений функций или портов сообщества — при условии, что ваш проект остаётся открытым под GPLv3 с надлежащей атрибуцией.
Однако прямые повторные загрузки 1:1, клон-форки без значимых функциональных изменений или повторная публикация идентичных сборок под другими названиями проектов (например, для накрутки загрузок или наград) строго запрещены.