常见问题（FAQ）

修改了配置但游戏里没生效？

• 热重载每 2 秒轮询一次，请稍候或手动调用 reload()
• 若使用了实例字段，请确认代码读取的是 get() 返回的当前实例

数值被自动改回默认值？

• 检查是否超出 @Range 的范围。越界会回退默认值并记录警告

我添加的条目为什么在 UI 里看不到？

• 确认类型是否受支持（boolean、数值、字符串、枚举、List<String>）
• 确认未在服务端查看 @ClientOnly 项
• 确认语言键是否正确（未提供键也应显示英文占位）

迁移后文件格式不像以前那样分节了？

• 迁移器会写成“扁平键值清单”并加入 config_version
• 如需恢复分节与注释格式，调用一次 save()（例如在 UI 界面点“保存”）

enum 的大小写要怎么写？

• 文件里大小写不敏感，内部按 Enum.name() 匹配

布尔值能否写成 1/yes/y？

• 可以，解析器会接受这些等价写法（不区分大小写）

我可以把列表写成单个字符串吗？

• 可以。未写 [...] 时会被当作单元素列表解析

如何禁止热重载？

• 调用 config.stop() 以停止文件监视器（也会清除缓存）