二次开发 开源 娱乐 农夫乐事插件 Pro｜Paper / Folia｜种植烹饪与自动化 1.2.9

关于这个插件
这是面向生存服与休闲服的农夫乐事玩法移植。本分支持续维护厨具、配方、种植和自动化，让玩家把种下的作物、采集的食材加工成不同料理。
CraftEngine 提供物品、方块、模型和资源包，本插件负责相应玩法、菜单与加工逻辑。客户端使用服务器提供的资源包，无需安装原版农夫乐事模组。
"Pro"是本维护分支的名称，全部功能免费开放，源码与发布构建均可从 GitHub 获取。

玩法与功能

• 种植与食物：作物、沃土、野生植物、蘑菇与食物效果，丰富服务器日常生活。
• 厨房与烹饪：厨锅、砧板、炉灶、手持煎锅，支持热源、工具、容器与多项产出。
• 配方与编辑：游戏内浏览、搜索和编辑配方，支持食材组、调味品、配比与优先级。
• 自动化：漏斗加工、自动收集、储物与红石，让食材从农田走上餐桌。
• 扩展功能：可选流体罐与浸泡加工、村民种植管理、玩家统计、配方发现与成就。
• 服务端支持：Paper / Folia 调度，以及附属开发 API。

从农田到餐桌
种植和收集：可配置单层、双层与攀绳作物，配合沃土、堆肥、蘑菇群落和储物设施，扩展日常农场。村民功能包含收获补种、种子留存、食物共享与背包管理，可按服务器需要配置。
准备和烹饪：砧板可以要求不同工具，配置多项产出与概率；厨锅处理热源、容器和烹饪进度；炉灶与手持煎锅提供放置烹饪、翻面等互动。食物还可带有营养、舒适等效果。
配方和管理：玩家能按厨具浏览、搜索配方，使用配方书查看关联内容。管理员可在游戏中编辑，也能使用文件配置等效食材、嵌套分组、标签、组件、调味品、配比与优先级，适合继续扩展自己的菜谱。
加工和联动：漏斗、自动收集和红石锁定可连接生产流程。安装 FluidCore 可启用流体罐、灌装排空与浸泡加工；安装 UltimateAdvancementAPI 可启用成就。

运行环境
具体版本覆盖与限制见兼容说明。

安装与开始使用

1. 从 GitHub Releases 下载插件 JAR 与对应内容包，安装 CraftEngine。
2. 将插件和需要的可选依赖放入 plugins 文件夹。
3. 将内容包解压到 plugins/CraftEngine/resources/，确认其下直接是 farmersdelight/ 与 farmersdelight_fluids/。
4. 启动服务器，生成并应用 CraftEngine 资源包，使用 /fd recipe 浏览配方。管理员可用 /fd recipe edit 编辑配方。

内容包需要手动安装和更新。升级前请备份自己的配置，详情见中文文档。

常用命令

• /fd help：查看可用命令。
• /fd recipe：浏览配方；/fd recipe book：打开配方书。
• /fd recipe edit：进入配方编辑器，需要管理权限。
• /fd reload：重载本插件配置与配方。
• /ce reload：重载 CraftEngine 内容与资源。

资源包与更新
插件 JAR 与内容包是两项内容，安装时需要同时准备。内容包提供物品模型、贴图与配方配置，客户端还需要应用 CraftEngine 生成的资源包才能看到对应外观。
本插件启动和重载不会自动释放、补齐或覆盖内容包。已有服务器升级时，先备份当前资源与配方，再对照更新说明合并自己的改动，避免直接覆盖已调整的内容。
流体与成就依赖是独立插件，更新农夫乐事 JAR 不会替换它们。发布页提供配套构建；需要对应功能时再安装。旧流体库的世界或物品数据不会自动转换，迁移前请先阅读配置指南。
当前稳定版 1.2.9 补齐英文分类和储罐说明，并保留 1.2.8 的物品恢复与玩法修复。中文与英文服务器均可按文档设置语言。

下载与交流
当前稳定版：1.2.9。插件、内容包、对应源码与更新说明统一在GitHub Releases提供。
QQ 交流群：2161068984，点击加入。
问题反馈：GitHub Issues。请附 Minecraft、CraftEngine、插件版本与完整报错，方便定位。
运行统计：查看 bStats 实时数据。

来源与授权
本项目是灰度 HuiDu_OwO（IOVEYOUMC0）的 Farmersdelight-Plugin 独立维护分支，由 ydxc2009 持续维护。
原模组 Farmer's Delight 由 vectorwing 及贡献者制作，移植素材保留 MIT 授权与原作者归属。
本插件使用 AGPL-3.0-only；第三方素材与依赖保留各自许可，见仓库 NOTICE 与 THIRD_PARTY。