FullBelly

FullBelly — комплексная система расхода голода за действия

Введение

FullBelly — это мод для Minecraft на NeoForge (1.21.1), который добавляет комплексную систему расхода голода за действия. Мод отслеживает различные действия игрока и автоматически списывает соответствующий голод, делая режим выживания сложнее и реалистичнее.

Возможности

• Полный охват действий: отслеживает 26 различных типов поведения игрока
• Совместимость с ваниллой: основан на ванильном механизме истощения, полностью совместим с родными механиками игры
• Отладочный интерфейс: HUD в реальном времени показывает уровень еды, процент истощения и последние действия (только в режиме отладки)
• Запись действий: визуальная обратная связь с эмодзи-иконками и определением комбо для связанных действий
• Обработка на стороне сервера: все вычисления выполняются на сервере, что гарантирует отсутствие влияния на производительность клиента
• Настраиваемость: переключение режима отладки через игровые команды или файл конфигурации

Типы действий и значения расхода

Передвижение (9 типов)

Мгновенные действия (3 типа)

Действия с инструментами (4 типа)

Боевые действия (9 типов)

Прочее (1 тип)

Руководство по использованию

Установка

1. Убедитесь, что установлен NeoForge 21.1.227+ (Minecraft 1.21.1)
2. Поместите fullbelly-1.0.3.jar в папку .minecraft/mods
3. Запустите игру

Режим отладки

Мод включает встроенный режим отладки, который отображает HUD в реальном времени с подробной информацией.

Игровые команды:

/fullbelly debug          - Проверить текущий статус режима отладки
/fullbelly debug true     - Включить режим отладки
/fullbelly debug false    - Выключить режим отладки

Отладочный HUD: Когда он включён, вы увидите оверлей с:

• 🍗 Уровень еды: текущие очки голода (0-20)
• ⚡ Истощение: текущее истощение в процентах (0-100%)
• Последние действия: последние 5 действий с эмодзи-иконками и значениями истощения
• Общее истощение: суммарное истощение с момента включения режима отладки

Определение комбо действий: Связанные действия, выполненные подряд, группируются вместе:

• Зелёный фон: самое свежее комбо действий
• Красный фон: предыдущее комбо действий
• Действия постепенно исчезают со временем

Файл конфигурации: Также можно отредактировать .minecraft/config/fullbelly-common.toml:

debug_mode = true

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

Настройка сложности

Измените базовые значения в FatigueProcessor.java:

• Меньшие значения = Лёгкий режим
• Большие значения = Сложный режим

Техническая реализация

Основные компоненты

• ActionType: Enum, определяющий 24 типа действий
• FatigueProcessor: Основной обработчик, применяет истощение к FoodData
• MovementHandler: Определяет движение игрока через отслеживание позиции
• ExhaustionHandler: Перехватывает события разрушения/установки блоков
• PlayerMixin: Определяет различные поведения через Mixin-инъекции

Как это работает

1. Определение поведения игрока через Mixin и систему событий
2. Вызов FatigueProcessor.dispatch() для обработки расхода
3. Применение расхода через ванильный метод FoodData.addExhaustion()
4. Когда истощение накапливается до 4.0, автоматически вычитается 1 единица еды

Совместимость

• ✅ NeoForge 21.1.229
• ✅ Minecraft 1.21.1
• ✅ Работает как на сервере, так и на клиенте
• ✅ Нет конфликтов с другими модами

Лицензия

Этот проект распространяется с открытым исходным кодом под лицензией MIT.

Версия: 1.0.3
Minecraft: 1.21.1
NeoForge: 21.1.227+
Последнее обновление: 2026-05-13

Список изменений

v1.0.3 (2026-05-13)

• ✨ Все базовые значения расхода снижены на 50% для лучшего баланса
• ✨ Все эмодзи-иконки заменены на однобуквенные варианты для лучшего отображения
• ✨ Добавлен HUD-оверлей в реальном времени для режима отладки (заменяет сообщения в чате)
• ✨ Реализовано определение комбо действий с визуальной группировкой
• ✨ Добавлено отображение процента истощения (0-100%)
• ✨ Оптимизирован режим отладки: запись действий не ведётся, когда он отключён (предотвращает утечку памяти)
• 🐛 Исправлено определение добычи, теперь включает все типы блоков (не только добываемые инструментом)
• 🐛 Исправлено затухание прозрачности фона комбо вместе с текстом

v1.0.2 (Предыдущая)

• Первый выпуск с подробным отслеживанием действий
• Поддерживается 24 типа действий
• Обработка истощения на стороне сервера
• Режим отладки с выводом в чат

Подробную историю версий см. в CHANGELOG.md.