配置文件（ModularUI Config）
基本信息
| 属性 | 值 |
|---|---|
| 配置文件路径 | config/modularui.cfg |
| 加载类 | Config.init(File)，在 CommonProxy.preInit 中调用 |
| 实时重载 | ConfigChangedEvent.OnConfigChangedEvent → Config.syncConfig()（无需重启，仅 forceEnableDebugBlock 例外） |
| 分类数 | 6（animations / rendering / keyboard / localization / json / debug） |
animations
| Key | 默认值 | 范围 | 说明 |
|---|---|---|---|
openCloseDurationMs |
200 | 0–3000 | GUI 开/关动画的绘制时长（毫秒） |
openCloseFade |
false | — | 是否绘制淡入淡出动画 |
openCloseScale |
false | — | 是否绘制缩放动画 |
openCloseTranslateFromBottom |
false | — | 是否从屏幕底部弹出/收回 |
openCloseRotateFast |
false | — | 是否绘制快速旋转动画 |
[!NOTE] 5 个动画开关默认全为
false，唯一的非零值是openCloseDurationMs = 200。 即默认状态下 GUI 开关没有动画效果。
rendering
| Key | 默认值 | 取值 | 说明 |
|---|---|---|---|
smoothProgressbar |
true | — | 平滑绘制进度条 |
textCursor |
underscore |
underscore / vertical |
文本框光标样式 |
keyboard
| Key | 默认值 | 说明 |
|---|---|---|
escRestoreLastText |
false | 按 ESC 关闭时是否把输入框文本恢复为打开前的值 |
closeWindowsAtOnce |
false | 是否一次性关闭所有已打开的窗口 |
localization
| Key | 默认值 | 说明 |
|---|---|---|
locale |
Locale.getDefault().toLanguageTag() |
GUI 数字的区域格式 |
[!NOTE] 该项带一段回退逻辑：读取后若
NumberFormat.getNumberInstance(newLocale)不是DecimalFormat实例，则放弃新 locale 并把配置值重置回当前生效的locale.toLanguageTag()。
json
| Key | 默认值 | 说明 |
|---|---|---|
useJson |
false | 启用 JSON 定义的 widget（WidgetJsonRegistry.init()）。开启会增加加载时间 |
服务端专用：ModularUI.init 中若 FMLCommonHandler.getSide() == Side.SERVER，
会调用 JsonLoader.loadJson() 加载 JSON 定义。
debug
| Key | 默认值 | 说明 |
|---|---|---|
debug |
false | 显示调试信息 |
forceEnableDebugBlock |
false | 在非开发环境下也注册调试方块（需重启） |
[!IMPORTANT]
forceEnableDebugBlock是本 mod 唯一能产生方块的开关，但它默认为false， 因此默认配置下 ModularUI 不会注册任何方块。详见分类页的说明。
相关条目
无游戏内容条目——ModularUI 是界面库。