**Please prioritize downloading the latest version, as older versions have unfixed bugs~
请优先下载最新版本,旧版本有未被修复的bug存在~**
Credits
v3.0.2 was primarily developed by community contributor QF, including the bonus mode system, Cloth Config integration, whitelist/blacklist system, command expansions, and config sync features.
v3.0.3 — Kaleidoscope Tavern compatibility by QF. Special thanks!
鸣谢
v3.0.2 版本由社区贡献者 QF 主导开发,包括新增增益模式系统、Cloth Config 集成、指令扩展及配置同步等核心功能。
v3.0.3 — 森罗物语:酒馆兼容由 QF 贡献。特此致谢!
When the player eats a food they have not consumed before, and the accumulated hunger value reaches the threshold, the player will receive a permanent bonus of +1 Health, +1 Armor, and +1 Attack Damage. This bonus does not disappear upon exiting the game or dying.
This mod supports three bonus modes (switchable in the config file): Saturation Threshold — bonus triggers when accumulated saturation reaches the threshold; Per Unique Food — bonus triggers for every new allowed food eaten; Per N Unique Foods — bonus triggers after every N new allowed foods eaten.
This mod also supports food whitelists and blacklists. When the whitelist is empty, all foods are allowed; when non-empty, only whitelisted foods can trigger bonuses. The blacklist takes priority over the whitelist.
The hunger value required to trigger the bonus, the increment of the threshold after each trigger, the initial health, the increases in health, armor, and attack damage, the bonus mode, and the food lists can all be modified in the configuration file located in the config folder. With Cloth Config API installed, you can also adjust settings via an in-game GUI from the Mods menu.
Guide
A new item, the Food Book, has been added and can be found in the Creative Mode inventory under Tools & Utilities. It allows players to view: the current bonus mode, the number of times the bonus has been triggered, the number of foods recorded, the current bonus stats (with caps), mode-specific progress (saturation progress / unique food count), foods that have been eaten and those that have not (with quick navigation buttons for "Eaten" and "Not Eaten").
Crafting Recipe:
If Just Enough Items (JEI) is installed, players can right-click on a food item shown in the book to view its recipe.
Commands
The following mod-related commands are available (permission required):
/foodstats info — View player stats (including bonus mode and attribute progress) /foodstats reset — Reset stats and remove all bonuses /foodstats mode — View current bonus mode /foodstats mode saturation / unique / count — Switch bonus mode (Chinese aliases available) /foodstats whitelist addheld / removeheld / clear / list — Manage food whitelist /foodstats blacklist addheld / removeheld / clear / list — Manage food blacklist /foodstats reload — Reload config and sync to all clients
当玩家吃下没有吃过的食物,所累积的饥饿值到达阈值时,为玩家提供生命值 +1,护甲值 +1,攻击力 +1 的永久加成,不会因为退出游戏或死亡消失。
本模组支持三种增益触发模式(可在配置文件中切换):饱食度累计——累计饱食度达到阈值触发加成;每种新食物一次——每食用一种新的允许食物触发一次加成;每 N 种新食物一次——每食用 N 种新的允许食物触发一次加成。
本模组同时支持食物白名单和黑名单。白名单为空时不限制食物;白名单非空时仅白名单内食物可触发增益。黑名单优先级高于白名单。
其中触发加成所需的饥饿值、每次触发加成后阈值增加的值、初始血量、增加的生命值、护甲值、攻击力、增益模式以及食物名单均可在 config 文件夹中的配置文件中更改。安装 Cloth Config API 后,还可通过 Mod 菜单的图形界面在游戏内调整。
指南
加入了食物手册这一物品,位于创造模式物品栏:工具与实用物品。可以查看:当前增益模式、触发加成的次数、已记录食物数量、当前的加成数值(含上限)、各模式的进度(饱食度进度 / 新食物计数)、已经吃过的食物和未吃过的食物(并可通过"已食用"和"未食用"两个按钮快速跳转)。
合成配方:
在安装了 JEI 物品管理器的情况下,可以右键书中显示的食物来查看该食物的配方。
命令
有关模组的指令如下(需要权限):
/foodstats info — 查看玩家统计数据(含增益模式、各属性进度) /foodstats reset — 重置统计数据并移除属性加成 /foodstats mode — 查看当前增益模式 /foodstats mode saturation / unique / count — 切换增益模式(中文别名:饱食度 / 每种 / 累计) /foodstats whitelist addheld / removeheld / clear / list — 管理食物白名单 /foodstats blacklist addheld / removeheld / clear / list — 管理食物黑名单 /foodstats reload — 刷新配置并同步到所有客户端
All Versions
+ Add VersionRequires Minecraft 1.20.1 + Forge 47.1.0 or newer
Optional: Cloth Config (in-game config screen), JEI (recipe lookup)
Added
- In-game config screen: settings are now editable from the mod list
bonuses, messages.
- Block foods are now tracked: dishes from Kaleidoscope Cookery and the
Dish nutrition follows the quality tier stored on the block:
Superb x1.2, Excellent x0.9, Standard x0.6, Poor x0.3, ungraded x1.0.
- The food guide and item tooltips recognize block foods.
- New config option custom_block_foods for modpacks,
Fixed
- Right-clicking a block food with a full hunger bar no longer counts
- Sneaking while holding an item no longer counts as eaten.
Compatibility
- A food counts as one guide entry whether eaten as a block or as an item.
- Both ways of eating accumulate saturation once each.
- Existing saves work as-is; previously eaten block foods are not
Other
- Removed unused network code.
食物增强 3.1.0(Forge / Minecraft 1.20.1)
适用:Minecraft 1.20.1 + Forge 47.1.0 以上
可选依赖:Cloth Config(游戏内配置界面)、JEI(配方查看),不装也能正常游戏
【新增】游戏内配置界面
- 终于可以在模组列表点「配置」直接改设置了,不用再敲指令
- 四个分组:基础设置、食物名单、属性加成、消息设置
- 连服务器时不再显示可编辑界面,改为提示由管理员用指令修改
- 未安装 Cloth Config 时给出提示,不会崩溃,指令照常可用
【新增】方块食物支持
- 放置后右键食用的食物现在会被正确记录,包括「森罗物语:厨房」的全部菜肴与
- 菜肴按方块上的品质档位折算实际营养:极佳 1.2 倍、优秀 0.9 倍、普通 0.6 倍、
- 食物手册与物品提示都会识别方块食物
【新增】配置项 custom_block_foods
- 整合包可自行声明方块食物,格式为 方块ID=每次咬口的饥饿值
- 例:kaleidoscope_cookery:dongpo_pork=7
【修复】
- 饱食度已满时右键方块食物,不再被误记为已食用
- 潜行并手持物品时右键方块食物,不再被误记
【兼容】
- 同一种食物无论直接吃还是方块吃,图鉴只算 1 种
- 两种吃法各累计一次饱食度
- 旧存档可直接使用,缺失字段自动按空处理
- 旧存档中此前吃过的方块食物不会追溯补记
【优化】
- 移除无用的网络包,减小体积
Added
- Block foods are now tracked: dishes from Kaleidoscope Cookery and the vanilla
- Dish nutrition now follows the quality tier stored on the block:
- The food guide and item tooltips recognize block foods.
Added
- New config option custom_block_foods for modpacks, format: block_id=hunger_per_bite
Fixed
- Right-clicking a block food with a full hunger bar no longer counts as eaten.
- Sneaking while holding an item no longer counts as eaten.
- Superb / Excellent dishes are no longer recorded at their base value.
Compatibility
- A food counts as one entry in the guide whether eaten as a block or as an item.
- Both ways of eating accumulate saturation once each.
- Existing saves load normally; missing fields default to empty.
Other
- Removed dead code.
食物增强 3.1.0(NeoForge / Minecraft 1.21.1)
【新增】方块食物支持
- 放置后右键食用的食物现在会被正确记录,包括「森罗物语:厨房」的全部菜肴与
- 菜肴按方块上的品质档位折算实际营养:极佳 1.2 倍、优秀 0.9 倍、普通 0.6 倍、
- 食物手册与物品提示都会识别方块食物
【新增】配置项 custom_block_foods
- 整合包可自行声明方块食物,格式为 方块ID=每次咬口的饥饿值
- 例:kaleidoscope_cookery:dongpo_pork=7
【修复】
- 饱食度已满时右键方块食物,不再被误记为已食用
- 潜行并手持物品时右键方块食物,不再被误记
- 极佳、优秀品质的菜肴不再按基础值记账
【兼容】
- 同一种食物无论直接吃还是方块吃,图鉴只算 1 种
- 两种吃法各累计一次饱食度
- 旧存档可直接使用,缺失字段自动按空处理
【优化】
- 清理无用代码,减小体积
### 🔧 修复
- 修复「饱食度累计」模式在阈值设置较小时(如 threshold=1),吃一个食物只触发一次加成的问题
- 现在恢复为按饱食度累计连续触发:例如牛排营养值 8、阈值 1,应正确触发 8 次加成
- 与 2.x 版本行为一致,同时保留之前的属性暴涨修复
### 📝 说明
- 本次修复不影响「每种新食物一次」和「每 N 种新食物一次」两种模式
- 若从 3.0.0 升级,无需删除存档或配置文件
### 🔧 Fixed
- Fixed "Saturation Threshold" mode only triggering once per food when the threshold is set low (e.g. threshold=1)
- Now correctly triggers multiple times based on accumulated saturation: a steak (nutrition 8) with threshold 1 will trigger 8 times
- Matches the 2.x behavior while keeping the previous attribute-inflation fix
### 📝 Note
- This fix does not affect "Per Unique Food" or "Per N Unique Foods" modes
- No need to delete saves or config when upgrading from 3.0.0
### ✨ 新增功能
- 三种增益模式:饱食度累计 / 每种新食物一次 / 每 N 种新食物一次
- 食物白名单系统(黑名单优先级高于白名单)
- 完整指令系统:/foodstats mode | whitelist | blacklist | reload
- 服务器配置实时同步到所有客户端
- 森罗物语:酒馆兼容(瓶装酒类可被记录并触发增益)
### 🔧 修复
- 修复高饱食度累积下属性加成异常暴涨的问题
- 补全 max_buff_count 数值上限配置项的实际生效
- 修复食物手册中右键查看 JEI 配方不工作的问题
### ⚠️ 注意
- 配置文件新增 bonus_mode、unique_foods_per_bonus、food_whitelist 三个选项
- 若装有森罗物语:酒馆,瓶装酒类现在会被记录并计入增益
## v3.0.0 - Bonus Mode Update
### ✨ New Features
- Three bonus modes: Saturation Threshold / Per Unique Food / Per N Unique Foods
- Food whitelist system (blacklist takes priority over whitelist)
- Full command system: /foodstats mode | whitelist | blacklist | reload
- Server config syncs to all clients in real time
- Kaleidoscope Tavern compatibility (bottled drinks can be recorded and trigger bonuses)
### 🔧 Fixes
- Fixed abnormal attribute bonus inflation when saturation accumulates too high
- Made the max_buff_count cap option actually take effect
- Fixed right-click JEI recipe lookup in the Food Book not working
### ⚠️ Note
- Three new config options added: bonus_mode, unique_foods_per_bonus, food_whitelist
### 🔧 Fixed
- Fixed negative saturation progress when switching bonus modes
- After switching from "Per Unique Food" or "Per N Unique Foods" mode
are no longer incorrectly counted as saturation consumption
- Each mode now tracks its progress independently
### 📝 Technical
- Added a dedicated saturation-mode trigger counter (saturationBuffCount),
## v3.0.4 - Bug 修复
### 🔧 修复
- 修复切换增益模式后饱食度进度显示为负数的问题
- 从「每种新食物」或「每N种新食物」模式切换到「饱食度累计」模式后,
- 现在各模式的进度独立计算,互不干扰
### 📝 技术说明
- 新增独立的饱食度模式触发计数器(saturationBuffCount),
### 🆕 新增
- 森罗物语:酒馆(Kaleidoscope Tavern)兼容
- 瓶装酒类可被识别为可记录食物,计入图鉴并显示食用状态
- 在「每种新食物」和「每N种新食物」模式下可正常触发增益
- 兼容通过反射实现,未安装酒馆时无任何影响
### 📝 贡献者
- 酒馆兼容:QF
🎉 特别鸣谢
本版本由贡献者** QF** 主导开发,包括全新的增益模式系统、Cloth Config 集成、
指令增强、配置同步等核心功能。感谢 **QF **的卓越贡献!
✨ 新增功能
三种增益模式:饱食度累计 / 每种新食物一次 / 每N种新食物一次
游戏内 Cloth Config 配置界面(支持中文)
食物白名单/黑名单系统(游戏内可管理)
新增指令:/foodstats mode | whitelist | blacklist | reload
服务器配置实时同步到所有客户端
🔧 修复
修复 JEI 和 Cloth Config 强制依赖问题
优化客户端/服务端代码分离
📦 依赖
可选:JEI(右键查看食物配方)
可选:Cloth Config(游戏内配置界面)
v3.0.2 - Multi-Bonus Update
🎉 Special Thanks
This version was primarily developed by contributor QF, including the new bonus mode system, Cloth Config integration, command enhancements, config sync, and other core features. Huge thanks to QF for this outstanding contribution!
✨ New Features
Three bonus modes: Saturation Threshold / Per Unique Food / Per N Unique Foods
In-game Cloth Config menu (supports Chinese)
Food whitelist / blacklist system (manageable in-game)
New commands: /foodstats mode | whitelist | blacklist | reload
Server config syncs to all clients in real time
🔧 Fixes
Fixed JEI and Cloth Config being incorrectly marked as required dependencies
Improved client/server code separation
📦 Dependencies
Optional: JEI (right-click to view recipes)
Optional: Cloth Config (in-game config menu)
修复每次退出游戏重进后,血量重新从基础血量开始累计的问题
- 有关模组2.3.0版本的相关修改内容如下:**
在config文件中添加了“是否开局给予食物手册”的选项
修复了食物手册显示不全的问题
修复了上限加成的问题
修复了跨纬度和突然回血的bug
修复了JEI未安装时导致崩溃的问题
- The relevant modification contents of the mod version 2.3.0 are as follows:**
Added an option in the config file for "whether to give the food guide at the start".
Fixed the issue of incomplete display of the food guide.
Fixed the problem with the upper limit bonus.
Fixed bugs related to cross-dimension and sudden health regeneration.
Fixed the issue of crashes when JEI is not installed.
2.增加了初始血量的配置可在config文件中配置
3.修改了食物手册的食物显示界面,增加了每一页可以显示的食物
4.对食物手册物品的材质进行了修改,使其更加贴合原版材质
5.修改了食物手册UI界面的部分布局,避免了遮挡
1.Added configuration options for maximum limits, which can be configured in the config file.
2.Added configuration for initial health, which can be configured in the config file.
3.Modified the food display interface of the Food Manual and increased the number of foods that can be displayed per page.
4.Modified the item textures in the Food Manual to make them more consistent with vanilla textures.
5.Adjusted part of the layout in the Food Manual's UI interface to avoid obstruction.