🍖 Food API

A flexible hunger system library for NeoForge

📖 About

Food API is a developer-focused library that removes the hardcoded limitations of Minecraft's vanilla hunger system. It exposes hunger capacity and drain speed as proper entity attributes, adds multi-row food bar rendering, and provides a clean provider-based system for replacing food icons — all with optional compatibility for popular HUD mods.

✨ Features

▶ Dynamic hunger capacity — max hunger is now an attribute, supports up to 2 rows (40 units).

▶ Configurable drain speed — control how fast hunger depletes via a multiplier attribute.

▶ Multi-row food bar — second row renders seamlessly above the first, fully synced with vanilla shake animation.

▶ Icon provider system — replace any food icon (empty, half, full, hunger, overlay, saturation) per-player, per-row, per-slot with a simple registration API.

▶ Optional mod compat — native support for Overflowing Bars and AppleSkin when present.

🖼️ Screenshots

Vanilla rendering — single row, standard icons

With Overflowing Bars — row counter, overlay icons stacked on top

📦 New Attributes

Two new player attributes are registered automatically when Food API is loaded:

Attribute ID Default Range Description Max Hunger food_api:max_hunger 20 1 – 40 Maximum hunger capacity. 20 = one row, 40 = two rows. Hunger Rate food_api:hunger_rate 1.0 0.0 – 10.0 Hunger drain speed multiplier. 0 = no drain, 2 = twice as fast.

Both attributes are synced to the client and can be modified via commands, other mods, or directly in code:

// Example: give a player double hunger capacity player.getAttribute(AttributeRegistries.MAX_HUNGER) .setBaseValue(40); // Example: slow hunger drain to half speed player.getAttribute(AttributeRegistries.HUNGER_RATE) .setBaseValue(0.5);

🔧 API Usage

Replacing food icons

Register a provider with an ID and priority. Higher priority wins. Return null to fall through to the next provider.

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 }; } );

Icon types

Type Description EMPTY Background (empty slot) HALF Half-filled icon FULL Fully filled icon EMPTY_HUNGER Background during Hunger effect HALF_HUNGER Half icon during Hunger effect FULL_HUNGER Full icon during Hunger effect HALF_OVERLAY Half icon on top row (Overflowing Bars only) FULL_OVERLAY Full icon on top row (Overflowing Bars only) SATURATION Saturation overlay texture (AppleSkin only)

Registering at the right time

Call FoodIconRegistry.register(...) during FMLClientSetupEvent or earlier:

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

🔗 Optional Dependencies

Food API works standalone. These mods unlock extra features when present:

• Overflowing Bars — enables row counter display and overlay icon rendering on the top row
• AppleSkin — enables saturation overlay icon replacement via FoodIconType.SATURATION

Made with 🩷 by ArimoV2