故障排查

日志在哪

FarmersDelight 打印的一切都进普通的服务器控制台和 logs/latest.log。没有单独的日志文件。

控制台 / 日志语言

FarmersDelight 自己日志行的语言由 config.yml 里的 language: 控制：

• 留空（language: ''） —— 跟随 JVM / 系统语言；
• en_us 或 zh_cn —— 强制该语言。

它管的是日志、控制台输出，以及没有玩家上下文的任何文本。各个玩家仍按各自客户端语言看界面和聊天，与此设置无关。

解析是有兜底的：所配语言没安装时，FarmersDelight 会退回 CraftEngine/JVM 语言，再退回某个已加载的兜底语言，并记录用了 哪个兜底。启动时它还会把插件更新引入的新增语言键合并进你现有的 lang/*.yml，让文件跨升级保持完整。随包语言文件在 plugins/FarmersDelight/lang/。

调试日志

默认关闭。追某个具体子系统时，窄范围开启：

debug:
  enabled: true
  categories: [cooking_pot, stove, skillet, tray]

有用的类别：cooking_pot、stove、skillet、tray，外加 startup、recipe、loot 用来看逐子系统的启动细分。 想要安静的服务器就 categories: []（或保持 enabled: false）；all 或 * 只临时用。这些类别里的一切也会以 FINE 级别写出，所以调高日志器级别就能看到，不必开 debug。

现象 → 原因 → 解决

可重复的采样步骤和预算取舍见性能排查与调节。

多人煎锅负载

手持烹饪只检查正在烹饪的会话，没有会话时停止计时任务；配方按材质索引查询，模型在 CE 打包时生成。正常 TPS 下，N 个持续烹饪会话每秒约检查 20N 次、主动刷新进度最多约 5N 次，另有开始、结束和原版背包同步。这是代码操作量，不能代替真实服务器的 MSPT、GC 与网络测量。

关闭 skillet.handheld.progress-display.enabled 后，外观不变时不再周期构建和发送显示副本，原版库存同步仍保留烹饪外观。关闭 skillet.handheld.enabled 停止手持烹饪，也会跳过后续自动模型生成。

放置煎锅默认每 4 tick 最多轮询 512 个已记录的锅；超过 skillet.tick-budget 会延后处理，烹饪也可能变慢。烟雾和声音先判定是否触发，再查询区块观察者；默认概率下约 87.3% 的轮次可跳过查询。performance.budgets.chunk-effect-packet-budget 限制的是每区块每 tick 的特效广播次数，每次仍会发送给范围内的多名玩家，不能把它视为总网络包上限。密集烹饪区可降低 skillet.effects.viewer-distance、特效概率或关闭特效，再通过采样确认收益。

按功能采样性能

持有 farmersdelight.admin 权限的玩家可运行 /fd stats profile 200 all，正常 TPS 下采样约 10 秒；/fd perf 是 /fd stats 的别名。普通版与 debug 版均可使用，无须打开逐条 debug 日志。期间再次启动采样会被拒绝，避免覆盖别人的结果；结束后仍可用 /fd stats 查看上一份结果。发起者移动或离线不影响自动停止。

只读总览 /fd stats 也能在控制台执行；profile 采样和 addon <name> 状态行仍然绑定玩家。

例如 /fd stats profile 600 handheld 观察手持负载，再用 /fd stats profile 600 handheld_display 检查显示刷新。时长范围为 20 至 12000 tick；省略时长为 200，省略功能为 all。采样结束输出调用数、每秒调用数、累计/平均/最大耗时和 P95。全部耗时以毫秒表示，调用率使用实际经过时间。零调用表示窗口内未执行此功能，不表示功能没有成本。

每个功能只保留最近 4096 次调用用于分位计算，总次数、累计和最大值覆盖整次采样。厨锅热点带世界和坐标，最多跟踪先遇到的 4096 个锅，超限会提示遗漏调用数。采样关闭时不调用计时器、不记录样本，也不增加全玩家扫描或逐 tick 日志。

功能计时在实际执行线程上进行，统计在采样窗口内开始并完成的调用，包含被调用逻辑；handheld_display 可能已计入 handheld，各行不能相加。厨锅调度轮次在 Paper 上包含同步更新，在 Folia 上主要包含调度提交，不能作为区域执行成本。纳秒计时测量的是经过时间，会受线程停顿影响；这些结果不是 CPU 占用、全服 MSPT 或总网络流量。需要调用栈、GC 和全服瓶颈时使用服务端已有的 spark。

-PdebugTools=true 构建会额外生成 farmersdelight-<version>-debug.jar，包含 /fd debugtools 造景工具；普通包仍为 farmersdelight-<version>.jar。两者是同一个插件，只安装其中一个。

小规模手动测试可用 /fd debugtools test cooking_pot 64 200、skillet、stove 或 all。它在玩家附近分批创建测试工作站并自动采样；每批最多处理 16 个位置。用 /fd debugtools undo 清理，或用 /fd debugtools stop 停止尚未完成的批次。

手持计算负载使用 /fd debugtools test handheld 200 200：按数量模拟独立会话，无需手持物品、持续右键或附近热源，不消耗玩家物品。输出更新、显示构建、完成次数和每模拟 tick 计算耗时；仅覆盖槽位匹配、进度、显示副本及配方完成核对，不包含网络、经验事件、真实背包或 Folia 多区域派发，不能当作 200 位真实玩家的 MSPT。模拟使用已加载的生牛肉营火配方原始时间；stop 输出当前结果并结束，退出时清理。真实手持链路继续用 /fd stats profile 200 handheld 和 handheld_display 采样。

对症选择重载命令

需要时，/fd cleanup 会从已加载区块里清掉孤立的插件状态（需要 farmersdelight.admin）。

Folia 并发压力检查清单

区域相关工作（厨锅 tick、漏斗传输、GUI 写入、展示刷新）无法由仓库检查覆盖，需要真实的 Folia 服务端验证。 修改 TickManager、任一工作站管理器、容器 GUI 或调度适配层后都跑一遍，把控制台输出与 /fd stats 结果 随部署记录保存。

准备。 当前 FD jar、构建对应的 CraftEngine jar、按版本表选择 Java，安装 spark；测试世界放几名玩家。 /fd stats profile 600 采样 30 秒，/fd stats profile 600 station_tick 只看厨锅 tick。

1. 多区域。 在至少三个区域布置 20–40 个工作站（厨锅、砧板、煎锅、炉灶），全部开始烹饪，然后传送 远离直到区块卸载再回来。预期：控制台无 thread not owned by region / IllegalStateException，没有卡在 半途的工作站，没有料理复制。
2. 并发 GUI 写入。 两名分处不同区域的玩家同时操作不同工作站并放入/移动物品。预期：点击原子生效， 无物品丢失/复制，区域繁忙时工作站状态仍能在下一次 tick 正常保存。
3. 漏斗输入/输出。 用漏斗给厨锅/砧板进料并抽取产物，同时玩家交互。预期：无库存变更竞态、进度条无 跳变，漏斗路径与工作站处于同一区域。
4. 负载中重载。 工作站烹饪中执行 /fd reload all 与 /ce reload。预期：工作站状态一致恢复、无大量 advancement.award_failed 警告、标签桥接 CraftEngineTagBridge 刷新时不跨区访问世界状态。
5. 负载中关闭。 多玩家带 buff、工作站活跃时停服（或禁用插件）。预期：buff 保存遵守关服预算、主线程 不会等待排在自己后面的任务、正常停止时没有 "scheduler refused" 警告。
6. 度量。 在最繁忙的工作站区域执行 /fd stats profile 600 all 并开 spark。记录 station_tick / recipe_match / gui_refresh 的调用数与 P95，以及 Folia 区域数。数字必须与场景一起记录；零调用表示 窗口内该路径没有执行。

通过该清单只代表区域边界被实际压过，不代表所有第三方插件或自定义世界都已证明。请把 Folia 构建、Java 版本、CraftEngine 构建与结果随轮次记录。

下一步

迁移与升级 →

调试 activate 只处理自己的最近放置批次，undo 每玩家保留八批并跳过后来替换的容器。stop 也停止该测试的采样。配方编辑保存中请等待反馈；Esc/取消保留会话草稿，重新打开同一编辑器即可继续，退出或重载后清除。即使退出，已经接受的文件写入和配方刷新仍独立完成；失败反馈可能代表文件写入后生效未确认，需要检查控制台。