常见问题
游戏启动失败
先核对 Minecraft 1.20.1、Forge 47.2.x、Java 17 和 GeckoLib 4.4.x，确认没有同时放入两个版本的观鸟。客户端与服务器的文件也应一致。
排查需要模组版本、复现步骤和崩溃报告。
照片没生成，或者挂画是空的
留意聊天中的上传提示，检查是否处于冷却、达到配额，或服务器关闭了上传。恢复过存档时，请服主确认照片目录也一并恢复；管理员可以使用照片校验命令检查。
文档里的物品在游戏中找不到
检查模组版本，旧版本可能没有新加入的物品。对照更新记录确认对应版本，并检查客户端与服务器的版本是否一致。