进食动画分叉版

进食动画分叉版

一个为可食用和可饮用物品添加精灵动画的模组。分叉自Eating Animation。

食物

进食动画分叉版预览查看大图

食用动画分支版

一款简单的、仅客户端的 Fabric 和 NeoForge 模组，为 Minecraft 中的食用食物和饮用药水添加了流畅的 3 阶段精灵动画。看着你的苹果一口一口变小、面包一块块撕开、药水瓶一口口减少——这一切都在你的手中、快捷栏和物品栏中呈现。

这是备受喜爱的 食用动画 模组（作者：theone_ss）的 非官方分支版，已移植至 Fabric 和 NeoForge，并使用新的 1.21.4+ 物品模型定义系统适配现代 Minecraft 版本。原模组采用 MIT 许可证；此分支版同样采用 MIT 许可证。完全归功于原作者。

特性

  • 43 种原版食物和饮品已添加动画 — 游戏中的每个食物物品（苹果、面包、熟牛排、金苹果、紫颂果、可疑炖菜、牛奶桶、蜂蜜瓶、不祥之瓶等 35 种）都拥有其自定义的 3 帧食用动画。
  • 药水动画 — 所有类型的药水在饮用时都会播放带有正确液体颜色的 3 帧动画（药水色调在饮用时得以保留，因此治疗药水保持红色，夜视药水保持蓝色等）。
  • 内置模组支持资源包 — 附带一个内置且默认启用的资源包，为 15 个流行模组 的 271 种食物物品 添加食用动画：
    • Adorn（4 个物品）— 热巧克力、发光浆果茶、甜浆果汁、下界疣咖啡
    • Additional Additions（4 个物品）— 浆果派、鸡块、煎蛋、蜜渍苹果
    • BetterEnd（14 个物品）
    • BetterNether（7 个物品）
    • Botania（2 个物品）
    • Create（5 个物品）
    • Duckling（1 个物品）
    • Expanded Delight（33 个物品）
    • Farmer's Delight（75 个物品）
    • Food Plus ID（93 个物品）
    • Hybrid-Aquatic（12 个物品）
    • Naturalist（11 个物品）
    • Snow Pig（2 个物品）
    • The Bumblezone（5 个物品）
    • Winterly（3 个物品）
  • 无处不在 — 在你的手中、快捷栏、物品栏、物品展示框和其他玩家身上。任何渲染物品的地方，动画都会播放。
  • 纯客户端 — 无需安装服务器端。将 jar 文件丢入你的 mods/ 文件夹即可。在 vanilla 服务器上也能工作。
  • 无性能影响 — 使用 Minecraft 原生的物品模型系统，无 tick 事件、无 mixin、无逐帧渲染钩子。
  • 双加载器支持 — 同时适用于 Fabric 和 NeoForge。选择与你加载器匹配的 jar 文件。

安装

Fabric

  1. 根据你的 Minecraft 版本安装 Fabric Loader
  2. 下载对应你 Minecraft 版本的 Fabric API 并将其放入你的 mods/ 文件夹
  3. 从此页面下载 食用动画分支版（Fabric jar 文件）并将其放入你的 mods/ 文件夹
  4. 启动 Minecraft — 即可，无需配置

NeoForge

  1. 根据你的 Minecraft 版本安装 NeoForge
  2. 从此页面下载 食用动画分支版（NeoForge jar 文件）并将其放入你的 mods/ 文件夹
  3. 启动 Minecraft — 即可，无需配置

与原版模组的区别

此分支版完全重写了渲染管道，以使用 Minecraft 1.21.4 新的 数据驱动物品模型定义 系统（原模组使用 ModelPredicateProviderRegistry + JSON "overrides" 块，而 Mojang 在 1.21.4 中移除了后者）。

主要变化：

  • 314 个物品模型 JSON 文件（assets/<namespace>/items/<food>.json）从原模组的旧版 override 文件生成，使用 minecraft:condition（using_item）+ minecraft:range_dispatch（use_duration 缩放 1/30）来驱动 3 阶段动画
  • 所有 939 个原始的逐阶段帧模型（apple_eating_0.json、apple_eating_1.json、apple_eating_2.json 等）保持不变 — 与原模组的艺术品相同
  • 所有 957 个原始纹理 保持不变
  • 零 Java 渲染代码 — 该模组唯一的 Java 类仅用于注册捆绑的资源包。所有动画逻辑都存在于 JSON 文件中，这意味着更好的性能、更易于维护，并且没有会在 Minecraft 更新时损坏的 mixin
  • 药水渲染已修复 — 药水现在使用正确的原版模型（minecraft:item/potion）和正确的打包整数色调（default: -13083194），并且该色调应用于所有 3 个饮用帧，以便在饮用动画期间液体颜色保持正确
  • 动画时序已修复 — 每个 range_dispatch 块都有 "scale": 0.033333（1/30）以将原始使用持续时间 tick 转换为阈值期望的 0.0–1.0+ 范围。如果没有此设置，动画会在第一次咬下的瞬间直接跳到最后一帧
  • 双加载器支持 — Fabric jar 文件（使用 Loom 构建）和 NeoForge jar 文件（使用 NeoForge 的 MDK 构建）提供相同的数据驱动 JSON 资源，因此不同加载器上的行为是一致的

已知问题 / 常见问题

问：模组无法加载 / 在 MultiMC / Prism Launcher 中显示不兼容。 答：请确保你下载的 jar 文件与你使用的加载器（Fabric 或 NeoForge）以及 Minecraft 版本相匹配。Fabric 和 NeoForge 的 jar 文件不可互换 — 请在安装前检查文件名。

问：这能在服务器上工作吗？ 答：可以 — 它是纯客户端的。你可以加入任何 vanilla 服务器，动画都会生效。服务器无需安装此模组。

问：我可以在我的整合包里使用它吗？ 答：可以 — 采用 MIT 许可证，无需许可。只需将 jar 文件包含在你的整合包中，并注明原作者（theone_ss）和此分支版即可。

问：会移植到 Forge / Quilt 吗？ 答：我不会进行移植。该模组采用 MIT 许可证，欢迎任何人进行移植。

许可证与致谢

MIT 许可证 — 参见 LICENSE。

  • 原版模组：食用动画 作者：theone_ss、spusik_、PinkGoosik、DoctorNight1 — MIT 许可证
  • 此分支版：由 Fring 维护（github.com/Fring-BS），使用新的物品模型定义系统移植至 Fabric 和 NeoForge，适配现代 Minecraft 版本
  • 所有艺术品（食物/饮品精灵、模组图标）均来自原版模组，在 MIT 许可证下使用

如果你发现 Bug 或希望支持新模组的食物物品，请在项目仓库中提交 issue。

链接