Mebahel's API - библиотека для модов Mebahel

Mebahel's API - это техническая библиотека (core dependency), которая предоставляет общие системы, утилиты и игровые механики для всех модов экосистемы Mebahel. Сама по себе она не добавляет контента в игру, но без неё не заработают другие моды этого автора.

Если вы устанавливаете любой мод из серии Mebahel (например, про дварфов, подземелья или новых мобов), этот API потребуется как обязательная зависимость. Он работает в фоне - вы его не увидите, но он обеспечивает корректную работу анимаций, сундуков с персональной добычей, генерации структур и боевого ИИ.

Поддерживаемые версии

• Minecraft 1.20.1 - Fabric
• Minecraft 1.21.1 - Fabric

Что делает этот API в игре

Обычный игрок напрямую с ним не взаимодействует. Но если какой-то мод использует возможности Mebahel's API, вы можете заметить:

Генерация структур без воды

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

Продвинутые сундуки с анимацией

Некоторые моды Mebahel используют особые сундуки на базе этого API:

• Анимированное открытие/закрытие (с помощью GeckoLib)
• Инвентарь, безопасный для мультиплеера
• Режим персональной добычи - каждый игрок получает свой лут из одного сундука (без дублирования)
• Обычный режим общего инвентаря
• Свои звуки и интерфейс

Улучшенное поведение мобов

Определённые существа могут использовать продвинутые движения:

• Стрейф во время боя
• Тактическое отступление при близкой дистанции
• Более естественное позиционирование
• Меньше шансов застрять в блоках

Нужен ли вам этот мод?

• Да, если другой мод указывает его как зависимость.
• Безопасен для одиночной игры и сервера.
• Должен быть установлен и на клиенте, и на сервере.
• Удаление сломает все моды, которые от него зависят.

Для разработчиков модов

Mebahel's API предоставляет готовые системы для упрощения разработки сложных Fabric-модов.

Система удаления воды из структур

Автоматически убирает воду и водянистые блоки после генерации структуры. Работает с шаблонными структурами, не вызывает лагов (tick-budget safe).

Как использовать: добавить процессор mebahelsapi:water_removal_processor в конфигурацию структуры.

Фреймворк анимированных сундуков (BaseChest)

Полная основа для создания кастомных контейнеров с мультиплеерной логикой:

• Анимации открытия/закрытия через GeckoLib
• Встроенная синхронизация звуков
• Кастомный GUI
• Сервер-авторитетное поведение
• Режим персонального лута (каждый игрок получает свою добычу) или общий инвентарь

Пример создания своего сундука - расширить BaseChestBlock и BaseChestBlockEntity, настроить название, звуки и мультиплеер.

Готовый GUI и ScreenHandler

Ускоряет разработку контейнерных блоков: предварительно настроенный ScreenHandler с интеграцией инвентаря игрока и клиентский GUI - минимум шаблонного кода.

Утилиты движения сущностей (MovementUtil)

Вспомогательные методы для продвинутого боевого ИИ:

• Стрейф вокруг цели
• Тактическое отступление
• Поворот лицом к цели
• Помощь при прыжках
• Антизастревание

Идеально подходит для боссов, дальних мобов, конструктов.

Почему стоит использовать Mebahel's API?

• Сокращает дублирование кода между несколькими модами
• Оптимизирован для производительности сервера
• Мультиплеер-безопасные системы
• Готовые к использованию реализации
• Активно применяется в реальных выпущенных модах

Установка для разработчиков (Fabric)

Добавьте зависимость в ваш проект:

Maven репозиторий:

repositories {
  maven {
    name = "GitLab-Mebahel"
    url = uri("https://gitlab.com/api/v4/projects/77311613/packages/maven")
  }
}

Зависимость:

dependencies {
    modImplementation "net.mebahelsapi:mebahels-api:<version>"
}

fabric.mod.json:

{
  "depends": {
    "mebahels-api": "*"
  }
}

Требуемые зависимости

• Fabric Loader
• Fabric API
• GeckoLib (для анимированных блоков и сущностей)

Версии должны соответствовать вашей версии Minecraft.

Кем используется?

Все моды экосистемы Mebahel зависят от этого API как от общей библиотеки.

Важно знать

• Это библиотека, а не самостоятельный мод с контентом.
• Удаление приведёт к ошибкам загрузки зависимых модов.
• Безопасна как для одиночной игры, так и для выделенного сервера.
• Не добавляет никакого игрового контента сама по себе.

Скачайте Mebahel's API, если планируете использовать любой мод из этой серии - без него они просто не запустятся.