Food API

模组

· 作者 AxoLabs

一个适用于 NeoForge 的灵活食物系统 API。通过属性添加可配置的饥饿容量和消耗速度,支持多行动态食物栏渲染,并提供基于提供者的图标替换系统以实现无缝模组集成。

0 本站下载 0 关注 更新于 23 小时前

最新 1.2.0 · 26.3 · NeoForge

一键开服(送7天)

🍖 Food API

用于 NeoForge 的灵活饥饿系统库

wakatime

📖 简介

Food API 是一个面向开发者的库,它移除了 Minecraft 原版饥饿系统的硬编码限制。它将饥饿容量和消耗速度暴露为标准的实体属性,支持多行食物条渲染,并提供了一个基于提供者的简洁系统来替换食物图标——同时可选兼容流行的 HUD 模组。

✨ 特性

▶ 动态饥饿容量 — 最大饥饿值现在是一个属性,支持最多 2 行(40 点)。

▶ 可配置的消耗速度 — 通过乘数属性控制饥饿值的消耗速度。

▶ 多行食物条 — 第二行无缝渲染在第一行上方,并与原版抖动动画完全同步。

▶ 图标提供者系统 — 通过简单的注册 API,可按玩家、按行、按槽位替换任何食物图标(空、半满、满、饥饿效果、叠加层、饱和度)。

▶ 可选模组兼容 — 当存在 Overflowing Bars 和 AppleSkin 时,提供原生支持。

🖼️ 截图

原版渲染 — 单行,标准图标

搭配 Overflowing Bars — 行数计数器,叠加图标堆叠在顶部

📦 新增属性

加载 Food API 时会自动注册两个新的玩家属性:

属性 ID 默认值 范围 描述
Max Hunger food_api:max_hunger 20 1 – 40 最大饥饿容量。20 = 一行,40 = 两行。
Hunger Rate food_api:hunger_rate 1.0 0.0 – 10.0 饥饿消耗速度乘数。0 = 不消耗,2 = 两倍速。

这两个属性都会同步到客户端,可以通过命令、其他模组或直接通过代码进行修改:

// 示例:给予玩家双倍饥饿容量
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, // 优先级 — 越高越先检查(原版 = 0)
    (player, iconIndex, row, type) -> {
        // iconIndex: 0 = 最右侧图标, 9 = 最左侧图标
        // row: 0 = 底行, 1 = 顶行
        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; // 让其他提供者或原版处理剩余部分
        };
    }
);

图标类型

类型 描述
EMPTY 背景(空槽位)
HALF 半满图标
FULL 满图标
EMPTY_HUNGER 饥饿效果期间的背景
HALF_HUNGER 饥饿效果期间的半满图标
FULL_HUNGER 饥饿效果期间的满图标
HALF_OVERLAY 顶部的半满图标 (仅限 Overflowing Bars)
FULL_OVERLAY 顶部的满图标 (仅限 Overflowing Bars)
SATURATION 饱和度叠加纹理 (仅限 AppleSkin)

正确的注册时机

请在 FMLClientSetupEvent 或更早阶段调用 FoodIconRegistry.register(...):

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

🔗 可选依赖

Food API 可以独立工作。以下模组在存在时会解锁额外功能:

  • Overflowing Bars — 启用行数显示和顶行叠加图标渲染
  • AppleSkin — 启用通过 FoodIconType.SATURATION 进行饱和度叠加图标的替换

由 AxoLabs 用 🩷 制作

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源