配置文件（ModularUI Config）

基本信息

属性	值
配置文件路径	`config/modularui.cfg`
加载类	`Config.init(File)`，在 `CommonProxy.preInit` 中调用
实时重载	`ConfigChangedEvent.OnConfigChangedEvent` → `Config.syncConfig()`（无需重启，仅 `forceEnableDebugBlock` 例外）
分类数	6（animations / rendering / keyboard / localization / json / debug）

Key	默认值	范围	说明
`openCloseDurationMs`	200	0–3000	GUI 开/关动画的绘制时长（毫秒）
`openCloseFade`	false	—	是否绘制淡入淡出动画
`openCloseScale`	false	—	是否绘制缩放动画
`openCloseTranslateFromBottom`	false	—	是否从屏幕底部弹出/收回
`openCloseRotateFast`	false	—	是否绘制快速旋转动画

[!NOTE] 5 个动画开关默认全为 false，唯一的非零值是 openCloseDurationMs = 200。即默认状态下 GUI 开关没有动画效果。

Key	默认值	取值	说明
`smoothProgressbar`	true	—	平滑绘制进度条
`textCursor`	`underscore`	`underscore` / `vertical`	文本框光标样式

Key	默认值	说明
`escRestoreLastText`	false	按 ESC 关闭时是否把输入框文本恢复为打开前的值
`closeWindowsAtOnce`	false	是否一次性关闭所有已打开的窗口

Key	默认值	说明
`locale`	`Locale.getDefault().toLanguageTag()`	GUI 数字的区域格式

[!NOTE] 该项带一段回退逻辑：读取后若 NumberFormat.getNumberInstance(newLocale) 不是 DecimalFormat 实例，则放弃新 locale 并把配置值重置回当前生效的 locale.toLanguageTag()。

Key	默认值	说明
`useJson`	false	启用 JSON 定义的 widget（`WidgetJsonRegistry.init()`）。开启会增加加载时间

服务端专用：ModularUI.init 中若 FMLCommonHandler.getSide() == Side.SERVER，会调用 JsonLoader.loadJson() 加载 JSON 定义。

Key	默认值	说明
`debug`	false	显示调试信息
`forceEnableDebugBlock`	false	在非开发环境下也注册调试方块（需重启）

[!IMPORTANT] forceEnableDebugBlock 是本 mod 唯一能产生方块的开关，但它默认为 false，因此默认配置下 ModularUI 不会注册任何方块。详见分类页的说明。