Farmer’s Delight: Meal Mastery

农夫乐事：Meal Mastery

Meal Mastery 是 农夫乐事 的附属模组，让烹饪也成为成长进程的一部分。你准备的每道菜都有独立的熟练度进度，烹制的食物会记录在烹饪日志中；熟练掌握一道菜谱后，烹饪和食用它时的效果也会发生可量化的变化。

它不添加食物、物品、方块、游戏内纹理、模型或音效。它显示的所有内容均由原版 GUI 精灵图和其他模组已注册的物品构成。它唯一自带的图片是模组列表图标。

| | |
|—|—|
| 需要 | 农夫乐事、Fabric API（仅 Fabric 版本） |
| Minecraft | 1.20.1（Fabric、Forge）- 1.21.1（Fabric、NeoForge） |
| 运行端 | 客户端和服务器端，双方都需要安装 |
| 新增内容 | 无 |
| 许可证 | MIT |

熟练度

每道菜谱都有独立的熟练度进度，从 陌生 到 精通，通过烹制对应菜品提升。默认情况下，单道菜达到最高等级需要烹制 300 次（各等级门槛见 [2, 20, 60, 150, 300]）。

熟练度会带来实际效果，且默认启用。以下数值均为默认值，且都可以配置：

• 烹饪速度 – 熟练度满级时，烹饪锅、煎锅、炉灶以及原版烟熏炉的速度最高可提升至两倍。
• 星级 – 烹制的食物会获得一至五星级标记，并显示在食物名称下方。
• 额外效果 – 熟练度满级时，食用菜品有 25% 的概率获得持续 20 秒的生命恢复、速度或急迫效果。
• 饱和度 – 每颗星增加 0.2 点饱和度，不会改变饥饿值。
• 完美菜品 – 熟练度满级时，有 8% 的概率做出完美菜品：额外增加一颗星，并获得更强的效果。
• 额外份量 – 有 12% 的概率让同样的食材做出更多份。
• 刀具耐久 – 在切菜板上准备食材时，有 25% 的概率返还 1 点耐久度。
• 招牌菜 – 对已精通的菜谱按鼠标中键，即可将其设为招牌菜；之后烹制的这道菜都会额外增加一颗星。

所有概率都会从陌生时的零开始线性提升，因此首次尝试不会触发任何效果。菜品提示框会在按住修饰键时显示实际概率，让调整过的整合包能直接展示自己的数值，不必让玩家猜测。

烹制的食物会带有印记，记录厨师的星级、这次烹饪是否完美，以及是谁烹制的。因此，厨师做的食物对食用者更有益，而且即使由别人吃下，厨师也能获得熟练度。这是此模组唯一会写入物品数据的地方。没有印记的食物堆叠与原版食物逐字节完全相同；带印记的食物也不会与没有印记的食物堆叠，避免好批次被差批次混在一起。

如果服务器希望只记录统计数据，可将 mastery.bonuses.enabled 设为 false，这样上述所有实际效果都会消失。

烹饪日志

按键盘快捷键（默认 J）或 /mealmastery open打开，无需任何物品。

日志会追踪菜谱、食材、烹饪方式、类别和收藏集——所有内容都通过烹饪发现，而不是打开菜谱查看器来解锁。每个至少包含一道菜品的模组都会自动生成专属收藏集。客户端可以分别设置未知条目的显示方式：隐藏、显示剪影、仅显示名称、显示食材提示，或完整显示。

烹饪等级与经验

烹饪经验的设计有意鼓励广泛尝试，而非反复烹制同一道菜。发现一道新菜可获得 75 点经验；重复烹制已掌握的菜品则获得 6 点。除此之外，每道菜每天都会应用反刷经验的递减机制：第一次烹制按全额计算，接下来的四次按 75% 计算，再接下来的十次按 50% 计算，之后的烹制按 20% 的下限计算。下限不是零：重复烹制的收益应该更低，而不是毫无价值。

把一道便宜菜肴烹饪一万次，显然不是好策略。

挑战、收藏与里程碑

每日挑战会根据实际安装的食物生成，因此目标绝不会无法完成。整合包和数据包作者也可以添加自己的挑战：

data/<namespace>/mealmastery/challenges/<name>.json
data/<namespace>/mealmastery/collections/<name>.json
data/<namespace>/mealmastery/milestones/<name>.json

共有十四种目标类型（烹饪一道菜谱、烹饪某个类别或特定模组中的菜肴、使用某种食材或食材标签、使用某种烹饪方式、精通一道菜谱、供应份量、达到某个等级等）。奖励仅限于游戏中已有的内容——物品、进度、经验值和装饰性日志徽章。不会凭空创造自定义奖励物品。命令奖励也存在，但需要服务器设置启用，该设置默认关闭。

模组自带的所有内容本身都以数据包文件编写，因此整合包只需使用相同的 ID，即可覆盖其中任意内容。

也兼容它从未听说过的食物附属模组

Meal Mastery 在编译时不依赖 Farmer’s Delight。它会从原版注册表中读取配方类型、配方、食材、食物属性和标签，因此 Nether’s Delight 的烹饪配方与 Farmer’s Delight 的烹饪配方会走完全相同的代码路径。没有任何内容绑定到模组 ID。

实际效果是：安装其他食物附属模组后，下次启动时日志就会自动扩充。无需兼容包、硬编码物品列表或针对每个附属模组编写代码——包括本模组发布之后推出的任何附属模组。只要这些模组注册的是普通配方，且产出普通食物，即使它们根本不是 Farmer’s Delight 的附属模组，也同样适用。

安装并运行 Meal Mastery 仍然需要 Farmer’s Delight。

默认情况下，原版配方也会计入。面包、烤马铃薯以及烟熏炉制作的任何食物，都能像 Farmer’s Delight 的炖菜一样获得精通进度，日志也会将它们列出。如果整合包希望日志只收录其食物附属模组中的内容，只需将 compatibility.trackVanillaRecipes 设置为 false，即可一次性关闭整个 minecraft 命名空间，同时不影响其他模组。

/mealmastery debug会显示模组对你手中物品的判断，这是最快了解某个附属模组的食物为何会或不会出现在日志中的方法。/mealmastery compat会列出所有被检测到有菜肴贡献的模组。

多人游戏

只有真实且身份明确的玩家才能获得烹饪记录。漏斗、自动合成器或模组自动化产出的食物默认不会让任何人获得进度；系统绝不会猜测归属。服务器可以通过 automation.credit 设置放宽此限制。

排行榜默认关闭，而且每位玩家还需单独选择加入——玩家添加 mealmastery_leaderboard 计分板标签即可加入。

进度由服务器权威管理。客户端无法更改进度；服务器会下发自身使用的进度曲线，因此即使客户端与服务器不匹配，也无法错误显示进度条。

配置

配置目录中有两个带注释的 TOML 文件：

config/mealmastery-server.toml    world behaviour, server-authoritative
config/mealmastery-client.toml    presentation only

文件中为每项设置都添加了注释，包括其取值范围和可接受的值。两个文件都可以通过 /mealmastery reload 重新加载。超出范围的值会被限制在有效范围内并记录日志，而不会直接拒绝——配置拼写错误绝不能让任何人失去自己的世界。完全无法解析的文件会被重命名为 *.invalid，并用默认配置替换，因此原文件仍可恢复。较早 JSON 版本中的配置会自动迁移，原文件会保留为 *.json.bak。

五种预设（Vanilla+、Cozy、Completionist、Server、Cosmetic）可供选择作为起点。它们绝不会自动应用，应用预设只会改写配置，不会触及玩家档案。

命令

/mealmastery，别名为 /mealmasters 和 /mm。

| | |
|—|—|
| open、stats、recipe <item> | 你自己的档案 |
| challenges、collections、titles、today | 目标 |
| leaderboard、compat、export | 服务器与诊断 |
| audit、debug、reload | 注册表检测到了什么，以及原因 |
| admin inspect / addxp / setlevel / discover / mastery / reset / purgeorphans | 管理员 |

面向模组开发者

我们提供了一个小型公共 API（MealMasteryApi），用于处理通用检测无法覆盖的两种情况：注册既不会打开菜单也不会掉落产物的工作站，以及直接授予烹饪经验。大多数模组都不需要使用它——添加普通食谱的食物附属模组已获得完整支持，无需编写任何集成代码。

Meal Mastery 不是厨房框架，也不会成为必需的前置模组。API 无法用于注册食物、食谱、工作站菜单或烹饪机制；这些内容属于农夫乐事及其附属模组。

它不会做什么

• 它不会添加任何食物、物品、方块、游戏内纹理、模型或音效。
• 它不会修改农夫乐事的食谱或任何食物物品的属性。
• 它不会设置任何门槛。不会有任何食谱、物品或方块因为 Meal Mastery 等级而变得不可用。
• 它不会改变饥饿值，也不会添加营养或食物类别系统。
• 它不会取代食谱查看器。JEI/REI/EMI 集成是可选的，只会提供额外功能。
• 它不会接入其他进度模组。它的烹饪等级与 Project MMO 技能等级或 LevelZ 等级无关，也不会发出或消耗它们的经验值。
• 它不会占用属于其他模组的提示框区域。只要安装了营养模组，营养信息行就会默认关闭。

源代码与问题反馈

https://github.com/XircTwerk/Meal-Mastery

分支 1.20.1面向 Minecraft 1.20.1（Fabric、Forge）。分支 1.21.1面向 Minecraft 1.21.1（Fabric、NeoForge）——农夫乐事没有适用于 1.21.1 的 Forge 版本，因此加载器有所不同。

采用 MIT 许可证。整合包可免费收录此模组；如果能附上致谢链接，我们将不胜感激，但并非必需。

Meal Mastery 是一个独立的附属模组，与农夫乐事的作者没有关联，也未获得他们的认可或支持。