BackhandConfig
服务端配置：副手行为开关与物品名单
基本信息
| 属性 | 值 |
|---|---|
| 路径 | xonin.backhand.utils.BackhandConfig |
| 注解 | @Config(modid = Backhand.MODID) |
| 注册 | GTNHLib ConfigurationManager |
全部配置项（默认值取自 @Config.Default* 注解）
| 字段 | 类型 | 默认值 | @Config.Sync |
说明 |
|---|---|---|---|---|
OffhandAttack |
boolean | false |
✓ | 允许副手攻击 |
EmptyOffhand |
boolean | false |
✓ | 副手无物品时是否仍启用动作与渲染 |
OffhandBreakBlocks |
boolean | false |
✓ | 允许副手破坏方块 |
offhandBlacklist |
String[] |
{} 空 |
✗ | 禁止放入副手的物品名名单 |
mainhandUseStopsOffhandFallback |
String[] |
见下 | ✓ | 主手使用后不再回退触发副手的物品名 |
OffhandPickup |
boolean | false |
✓ | 捡起的物品可进入空副手 |
[!IMPORTANT] 默认值来源 上表默认值全部读自
@Config.DefaultBoolean/@Config.DefaultStringList注解， 不是「未调用 setter 所以取字段初始值」—— 这些字段在 Java 层没有初始值，值完全由注解提供。
@Config.Sync 的含义
注解类注释：“Configs that will be synced with the server’s config if playing in multiplayer”。
标 ✓ 的项在多人游戏时以服务端配置为准；offhandBlacklist 未标 Sync，属纯本地项。
默认名单（mainhandUseStopsOffhandFallback）
首项为 "matter-manipulator:itemMatterManipulator0"。
查询入口
Backhand.isOffhandBlacklisted 与 Backhand.doesMainhandUseStopOffhandFallback。