进食动画分叉版

进食动画分叉版

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

杂项

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

进食动画 Fork

一个简单的、纯客户端的 Fabric 和 NeoForge 模组，为 Minecraft 中的进食和饮用添加了流畅的三阶段精灵动画。观看你的苹果一口一口变小、面包一片一片撕开、药水瓶一口一口喝光——所有动画都会在你的手中、快捷栏和背包中呈现。

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

特性

  • 43 种原版食物与饮品已添加动画 — 游戏中每一种食物（苹果、面包、熟牛肉、金苹果、紫颂果、迷之炖菜、奶桶、蜂蜜瓶、不祥之瓶等 35 种）都有其独特的三帧进食动画。
  • 药水动画 — 所有类型的药水都会播放三帧饮用动画，并显示正确的药水颜色（饮用时保留药水染色效果，例如治疗药水保持红色、夜视药水保持蓝色等）。
  • 内置模组支持资源包 — 附带一个默认启用的内置资源包，为 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/ 文件夹即可。在原版服务器上也能使用。
  • 无性能影响 — 使用 Minecraft 原生的物品模型系统，无刻事件、无 Mixin、无逐帧渲染钩子。
  • 双加载器支持 — 同时支持 Fabric 和 NeoForge。选择与你加载器匹配的 jar 文件。

安装

Fabric

  1. 为你的 Minecraft 版本安装 Fabric Loader
  2. 为你的 Minecraft 版本下载 Fabric API 并将其放入 mods/ 文件夹
  3. 从此页面下载 Eating Animation Fork（Fabric jar）并将其放入 mods/ 文件夹
  4. 启动 Minecraft — 大功告成，无需配置

NeoForge

  1. 为你的 Minecraft 版本安装 NeoForge
  2. 从此页面下载 Eating Animation Fork（NeoForge jar）并将其放入 mods/ 文件夹
  3. 启动 Minecraft — 大功告成，无需配置

与原版模组的区别

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

主要变化：

  • 314 个物品模型 JSON 文件（assets/<命名空间>/items/<食物>.json）由原模组的旧版 override 文件生成，使用 minecraft:condition（using_item）+ minecraft:range_dispatch（use_duration 按 1/30 缩放）来驱动三阶段动画
  • 所有 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），以将原始的使用持续刻数转换为阈值所期望的 0.0–1.0+ 范围。没有这个，动画会在第一次咬下时直接跳到最后一帧
  • 双加载器支持 — Fabric jar（使用 Loom 构建）和 NeoForge jar（使用 NeoForge 的 MDK 构建）包含相同的数据驱动 JSON 资源，因此在不同加载器上的行为完全相同

已知问题 / 常见问题

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

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

问：我可以在我的整合包中使用这个模组吗？ 答：可以 — 采用 MIT 许可证，无需额外许可。只需将 jar 文件放入你的整合包中，并注明原作者（theone_ss）和此分支即可。

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

许可证与致谢

MIT 许可证 — 参见 LICENSE。

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

如果你发现任何错误，或想请求支持新模组的食物物品，请在项目仓库中提交问题。

链接