渲染配置
基本信息
| 属性 | 值 |
|---|---|
| 配置分类 | Rendering |
| 客户端专用 | 是（分类注释明示无需与服务端同步，BattlegearConfig.java:99-101） |
| 图形化配置 | BattlegearConfigGUI，入口 guiFactory = "mods.battlegear2.gui.BattlegearGuiFactory"（Battlegear.java:44） |
功能
Rendering 分类控制本模组的自定义渲染器、HUD 元素位置与屏幕组件显隐。
渲染器开关
| 配置项 | 默认值 | 合法值 | 来源 |
|---|---|---|---|
Disabled Renderers |
空列表 | spear、shield、bow、quiver、flagpole |
BattlegearConfig.java:63, 111 |
读取后立即 Arrays.sort（BattlegearConfig.java:112），供后续 Arrays.binarySearch 判定。每个值对应一个自定义渲染器（ClientProxy.java:82-109）。
bow控制的BowRenderer注册在原版Items.bow上（ClientProxy.java:96-97），而非本模组的两把自制弓 —— 自制弓的渲染器注册在这两个 if 之外，不受该开关影响（ClientProxy.java:98, 100）。
HUD 元素位置
以下 8 个配置项把 HUD 条在快捷栏附近做相对偏移，默认全为 0（BattlegearConfig.java:114-125）：
| 配置项 | 元素 |
|---|---|
Quiver hotbar relative horizontal position |
箭袋槽位条 |
Quiver hotbar relative vertical position |
箭袋槽位条 |
Shield bar relative horizontal position |
盾牌体力条 |
Shield bar relative vertical position |
盾牌体力条 |
Offhand hotbar relative horizontal position |
副手快捷栏 |
Offhand hotbar relative vertical position |
副手快捷栏 |
Mainhand hotbar relative horizontal position |
主手快捷栏 |
Mainhand hotbar relative vertical position |
主手快捷栏 |
horizontal / vertical 两个方向由 String[] pos = { "horizontal", "vertical" } 循环生成（BattlegearConfig.java:115-116）。写入内存后由 refreshGuiValues 持久化（BattlegearConfig.java:556-573）。
第一人称盾牌偏移
| 配置项 | 默认值 | 范围 | 存储换算 | 来源 |
|---|---|---|---|---|
Equipped shield in 1st person relative size |
0 | -60 ~ 100 | 值 × -1 / 100F |
BattlegearConfig.java:132-141 |
Equipped shield in 1st person vertical position offset |
0 | -100 ~ 100 | 值 / 100F |
BattlegearConfig.java:142-148 |
Equipped shield in 1st person horizontal position offset |
0 | -100 ~ 100 | 值 / 100F |
BattlegearConfig.java:149-155 |
三项写入 equippedShieldOffset[0..2]（BattlegearConfig.java:80）。注意源码注释中的方向描述与配置名互换（例如 vertical position offset 的注释写的是 “move right”），本条目按配置项名与代码换算如实记录，不做推测。
数值
| 布尔项 | 默认值 | 作用 | 来源 |
|---|---|---|---|
Render arrow with bow uncharged |
true |
未蓄力时也渲染箭矢 | BattlegearConfig.java:126、:58 |
Render quiver on skeleton back |
true |
骷髅背部渲染箭袋 | BattlegearConfig.java:127、:58 |
Force screen components rendering |
false |
强制渲染屏幕组件 | BattlegearConfig.java:129、:59 |
交互
refreshConfig 在图形化配置界面关闭时把 disabledRenderers 与 3 个布尔项写回配置文件并重新注册渲染器（BattlegearConfig.java:542-554）。refreshGuiValues 单独持久化 8 个位置偏移（BattlegearConfig.java:556-573）。
配置项变更提示：config.battlegear.warn=A restart is needed for changes to take effect（en_US.lang）。
合成配方
不适用。