服主指南

这是把 FarmersDelight 跑起来的上手流程：你需要什么、怎么装、怎么确认装好了、大多数服主第一天会动的几个开关， 以及控制台出问题时怎么读日志。

它只负责把你从「下载好的 jar」带到「能跑的服务器」，再带你过一遍最可能动的设置。每页都会链到完整讲该主题的那一页： 随包方块与物品定义见方块行为配置，config.yml 见首要配置项， 读控制台见确认行为已加载，升级对现有安装的影响见迁移与升级。

按这个顺序读

1. 环境要求与加载顺序 —— Paper/Folia 与 Java 版本，以及为什么 CraftEngine 必须先加载。
2. 安装 —— 放 jar、首次启动、/ce reload all，再确认方块和物品都在。
3. 资源包 —— CraftEngine 怎么发包，以及你真正会碰到的两种故障。
4. 首要配置项 —— 大多数服主第一天会改的那几个 config.yml 设置，以及每项是干什么的。
5. 方块行为配置 —— CE 方块列表、标签及所有可配置的 FD 行为模式。
6. 确认行为已加载 —— 怎么读一条 CraftEngine 行为报错：它是「某个方块配置写错了」的信号，不是崩溃。
7. 故障排查 —— 现象 → 原因 → 解决，外加日志在哪。
8. 性能排查与调节 —— 可重复的采样步骤、各预算的作用和取舍。
9. 迁移与升级 —— 全新安装或更新时哪些东西会带过来，以及为什么有些随包文件永远不会被覆盖。

60 秒速览

• 把 CraftEngine 和 FarmersDelight 丢进 plugins/。CraftEngine 是硬依赖，会自动先加载。
• 启动一次服务器。FarmersDelight 会把它的 CraftEngine 资源释放到 plugins/CraftEngine/resources/farmersdelight/，把自己的 config.yml 释放到 plugins/FarmersDelight/。
• 按 CraftEngine 的文档生成并托管资源包，然后执行 /ce reload all。
• 给自己来一个 farmersdelight:cooking_pot，确认物品能正常解析、放下、打开。

以上都成了，就装完了——直接跳到 首要配置项。没成的话，故障排查 兜底。