问荆的技术笔记
无论你是从原模组第一次过来，还是在升级现有的 FarmersDelight 安装，以下这些的行为都和「直接覆盖文件」不一样。本页
讲的是操作层面的规则；方块层面的细节（旧版 canvas_rug、boost-chance 默认值、番茄藤和炉灶灼烧的改动）见
方块行为配置。
这是一个移植，不是模组。预期玩法与 Farmer's Delight 一致，但你服务器上存在的只有这些 CraftEngine 配置实际提供的 内容。世界就是普通的 Paper/Folia 世界——没有模组存档导入这一步。装好插件、生成包，内容就出现了。作物、工作站、食物和配方 都在游戏内像玩家预期的那样放置和制作。
配方解锁进度（当 recipes.discovery.enabled: true 时）以配方 id 存储。把配方 id 当成稳定的存档键：
每次启动，FarmersDelight 都会拿你的 config.yml 与当前运行构建随包的那份对齐，而不改动你设过的任何值：
所以插件更新后你不需要手动迁移 config.yml——你调过的值都活着，新设置以默认值出现，死键被清掉。（这过程中若备份失败，
会记录到日志里，而不是中止更新。）
村民与流浪商人交易现已放入 world-data.yml，稻草掉落规则的启用白名单现已放入 drops.yml，砧板的逐物品 / 逐标签显示表
现已放入 display-overrides.yml（items / tags）。只要旧版 config.yml 仍含有 world-data:、drops:、
cutting-board.display-overrides 或 cutting-board.display-tag-overrides 段，对应段就会自动移入对应文件。
config.yml 内被改名的设置（各工作站的 hopper-interactions 子开关改为 allow-hopper；performance.* 归入
warnings / budgets / proxy-display 三组）会就地重写。移动前相关文件都会备份；之后请编辑独立文件。
小刀的生物额外掉落已从 drops.yml 迁入 CraftEngine 资源包（vanilla_loots.yml 里的
farmersdelight:*_from_* 条目），因为它在包里能和其余掉落一起被 CE 直接解析、也方便照格式增删。
drops.yml 里残留的 mob-extra / mob-extra-tools 段会被静默忽略——
想改这些掉落就编辑包内条目；附加插件经 FarmersDelightKnifeDrops 运行期注册的规则不受影响。
升级时有三条不同的「仅当缺失才安装」规则要注意，因为它们意味着你对随包内容的编辑会在更新后保留，但新的随包内容不一定 会自己送到：
全套内置资源只在第一次启动时释放一次。之后：
craftengine-resources:
auto-completion: true
auto-completion: true（默认）会在后续启动时还原被删 / 缺失的资源文件——但从不覆盖已存在的文件。如果你是故意删了
某些随包配置、不想它们被加回来，就设成 false。无论哪种设置，你就地编辑过的文件永远不会被覆盖，所以一次改动了随包
方块 / 配方文件的插件更新，不会落到已经有该文件的服务器上——这类改动请手动合并（或删掉该文件，让 auto-completion
还原新版本）。
recipes:
merge-missing-bundled: false
配方文件仅当完全缺失时才写出。更新新增的配方永远不会到达已经有 recipes/*.yml 的服务器。启动时，存在于 jar 里但
不在硬盘上的 id 会在控制台被列出一次。想把这些新 id 拉进来，设 merge-missing-bundled: true——但如果你是故意删了配方，
就保持 false，因为合并会把每个被删配方都带回来。任一设置下，硬盘上已有的 id 都不会被覆盖。同一个开关也管
recipes/special_recipes.yml 里的随包卡片：开关为 false 时，从文件里删掉一张卡片就是真的删掉（禁用）。
CrabbersDelight、BrewinAndChewin、BarbequesDelight 与 EndsDelight 的厨锅、砧板与特殊配方不再放在
plugins/<附属>/recipes/*.yml，而是随各自的数据包发布，位于
plugins/CraftEngine/resources/<附属>/configuration/farmersdelight/，根键分别是 cooking_recipes、cutting_recipes、
special_recipes。配方 id 与内容都没变，只是摆放位置和生效方式变了：
plugins/<附属>/recipes/{cooking_pot_recipes,cutting_board_recipes,special_recipes}.yml 不再被读取，
可以删掉。若你在里面改过配方，先把改动搬到上面那个数据包目录，再 /ce reload all（或重启）。
升级时新文件会由插件自动释放；已存在的同名文件不会被覆盖。/ce reload all（或重启），不再是 /fd reload：数据包内容由 CraftEngine 在加载数据包时读取。plugins/CraftEngine/resources/<附属>/configuration/recipes/。它们多了一层：plugins/<附属>/recipes/<同名文件>.yml
仍会被叠加读取，同 id 以插件文件为准——游戏内的酒桶配方编辑器写的就是这个文件。所以旧文件可以留着当覆盖层
（内容与数据包默认值相同，不会改变结果），也可以删掉改用数据包版本；改动数据包里的配方同样要 /ce reload all。升级时会把旧的 FarmersDelight 战利品数据包从每个世界移除——其中的伤害类型文件会先迁移到伤害数据包，不会丢失。
战利品注入现在是 CraftEngine 资源包数据：编辑 FarmersDelight 包里的 vanilla_loots.yml，再执行 /ce reload all。
见 首要配置项。
/stop）——不要热换 jar。config.yml、world-data.yml 和 drops.yml 自动迁移、CraftEngine 资源自动补全。merge-missing-bundled）。/ce reload all），在游戏内确认贴图。本页转载自 FarmersDelight Wiki，按 GPL-3.0 许可分发。正文未改动，仅对链接与排版做了适配。