Food API

🍖 Food API

Гибкая библиотека системы голода для NeoForge

📖 О моде

Food API — библиотека для разработчиков, которая убирает жёстко зашитые ограничения ванильной системы голода в Minecraft. Она выносит вместимость голода и скорость его убывания в полноценные атрибуты сущности, добавляет отрисовку полосы еды в несколько рядов и предоставляет чистую систему провайдеров для замены иконок еды — всё это с опциональной совместимостью с популярными модами на HUD.

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

▶ Динамическая вместимость голода — максимальный голод теперь атрибут, поддерживает до 2 рядов (40 единиц).

▶ Настраиваемая скорость убывания — управляйте тем, как быстро убывает голод, через атрибут-множитель.

▶ Полоса еды в несколько рядов — второй ряд бесшовно отрисовывается над первым, полностью синхронизирован с ванильной анимацией тряски.

▶ Система провайдеров иконок — заменяйте любую иконку еды (пустая, половина, полная, голод, оверлей, насыщение) для игрока, ряда и слота через простой API регистрации.

▶ Опциональная совместимость с модами — нативная поддержка Overflowing Bars и AppleSkin при их наличии.

🖼️ Скриншоты

Ванильная отрисовка — один ряд, стандартные иконки

С Overflowing Bars — счётчик рядов, иконки оверлея поверх

📦 Новые атрибуты

Два новых атрибута игрока регистрируются автоматически при загрузке Food API:

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

// Пример: дать игроку двойную вместимость голода
player.getAttribute(AttributeRegistries.MAX_HUNGER)
      .setBaseValue(40);

// Пример: замедлить убывание голода вдвое
player.getAttribute(AttributeRegistries.HUNGER_RATE)
      .setBaseValue(0.5);

🔧 Использование API

Замена иконок еды

Зарегистрируй провайдера с ID и приоритетом. Чем выше приоритет, тем раньше он проверяется. Верни null, чтобы передать обработку следующему провайдеру.

FoodIconRegistry.register(
    ResourceLocation.fromNamespaceAndPath("mymod", "my_provider"),
    10, // priority — higher = checked first (vanilla = 0)
    (player, iconIndex, row, type) -> {
        // iconIndex: 0 = rightmost icon, 9 = leftmost
        // row: 0 = bottom row, 1 = top row
        return switch (type) {
            case FULL  -> ResourceLocation.fromNamespaceAndPath("mymod", "hud/my_food_full");
            case HALF  -> ResourceLocation.fromNamespaceAndPath("mymod", "hud/my_food_half");
            case EMPTY -> ResourceLocation.fromNamespaceAndPath("mymod", "hud/my_food_empty");
            default    -> null; // let other providers or vanilla handle the rest
        };
    }
);

Типы иконок

Регистрация в нужный момент

Вызывай FoodIconRegistry.register(...) во время FMLClientSetupEvent или раньше:

@SubscribeEvent
public static void onClientSetup(FMLClientSetupEvent event) {
    FoodIconRegistry.register(...);
}

🔗 Необязательные зависимости

Food API работает самостоятельно. Эти моды открывают дополнительные возможности при наличии:

• Overflowing Bars — включает отображение счётчика рядов и отрисовку оверлейных иконок в верхнем ряду
• AppleSkin — включает замену иконки оверлея насыщения через FoodIconType.SATURATION