配置 GUI（Configuration GUI）

基本信息

属性 值
类型 Forge 内置 Mod 配置 GUI
GUI 工厂类 locusway.overloadedarmorbar.client.gui.GuiFactory
GUI 屏幕类 locusway.overloadedarmorbar.client.gui.ModGUIConfig
注册方式 @Mod(guiFactory = ...) 注解注册 IModGuiFactory
适用端 客户端（Side.CLIENT）

功能

通过 Forge 标准的 IModGuiFactory 机制，提供 mod 列表 → “Config” 按钮的图形化配置界面，替代手动编辑配置文件。

GuiFactory

实现 cpw.mods.fml.client.IModGuiFactory：

方法 返回值
initialize(Minecraft) 空实现
mainConfigGuiClass() ModGUIConfig.class
runtimeGuiCategories() null（无运行时分类）
getHandlerFor(...) null（无运行时处理器）

ModGUIConfig

继承 cpw.mods.fml.client.config.GuiConfig，构造时传入：

  • 父 GuiScreen
  • ConfigurationHandler.getConfig().getCategory(CATEGORY_GENERAL) 的子元素（ConfigElement.getChildElements()）
  • OverloadedArmorBar.MODID 作为配置归属 ID
  • allRequire = false（非所有元素都需要重启）
  • localized = false（不强制本地化）
  • 简略配置文件路径（GuiConfig.getAbridgedConfigPath(...)），在 GUI 标题栏显示

数值

数值 值
GUI 工厂加载类 locusway.overloadedarmorbar.client.gui.GuiFactory
注册 ID overloadedarmorbar
配置分类 general

第三方 mod 集成

无——仅使用 Forge cpw.mods.fml.client.config.GuiConfig。

相关条目