BugfixMod Settings

基本信息

pl.asie.foamfix.bugfixmod.BugfixModSettings —— 承载 foamfix.cfg 的全部配置项。实例化于 BugfixModClassTransformer.initialize()，无构造参数。

配置文件路径：<mcLocation>/config/foamfix.cfg。

配置分组与全部开关（28 项，按 `config.get(<category>, <key>, ...)` 的分类清点）

分组	键数
`ghostbuster`	8
`bugfixes`	13
`launchwrapper`	2
`tweaks`	5
合计	28

ghostbuster（7 项）

配置键	字段	默认	说明
`enableDebugger`	`gbEnableDebugger`	`false`	启用 `/ghostbuster` 命令
`debuggerLogFile`	`gbDebuggerLogFilePath`	`""`	空则输出到 MC 日志
`enableFixes`	`gbEnableFixes`	`true`	总开关，关闭则所有 ghost 修复不生效
`fixGrassVanilla`	`gbFixGrassVanilla`	`true`	原版草方块
`fixGrassBop`	`gbFixGrassBOP`	`true`	Biomes O’ Plenty 草方块
`fixFluidsVanilla`	`gbFixFluidsVanilla`	`true`	原版流体流动（部分修复）
`fixFluidsModded`	`gbFixFluidsModded`	`true`	模组流体方块
`fixVinesVanilla`	`gbFixVinesVanilla`	`true`	原版藤蔓

debuggerLogFile 一个键派生出两个字段：gbDebuggerLogFilePath（字符串）与 gbDebuggerLogFile（new File(...)，仅在路径非空时才构造，否则为 null）。

bugfixes（10 项）

配置键	字段	默认	来源
`jarDiscovererMemoryLeakFix`	`bfJarDiscovererMemoryLeakFixEnabled`	`true`	Forkage / immibis
`soundSystemUnpauseFix`	`bfSoundSystemUnpauseFixEnabled`	`true`	Forkage / immibis
`entityHeldItemNBTRenderFix`	`bfEntityHeldItemNBTRenderFixEnabled`	`true`	Forkage / immibis
`tessellatorAlphaPassCrashFix`	`bfAlphaPassTessellatorCrashFixEnabled`	`true`	FoamFix
`itemBounceHopperFix`	`ItemHopperBounceFixEnabled`	`false`	BugfixMod / williewillus
`itemBounceStairFix`	`ItemStairBounceFixEnabled`	`false`	BugfixMod / williewillus
`snowballFix`	`SnowballFixEnabled`	`true`	BugfixMod / williewillus
`clientBoatDesyncFix`	`BoatDesyncFixEnabled`	`true`	BugfixMod / williewillus
`clientHeartBlinkFix`	`HeartBlinkFixEnabled`	`true`	BugfixMod / williewillus
`clientHeartFlashFix`	`HeartFlashFixEnabled`	`true`	BugfixMod / williewillus
`clientToolDesyncFix`	`ToolDesyncFixEnabled`	`true`	BugfixMod / williewillus
`log4jExploitFix`	`bfLog4JExploitFixEnabled`	`true`	FoamFix
`biblioRceExploitFix`	`bfBiblioRCEFixEnabled`	`true`	FoamFix

launchwrapper（2 项）

配置键	默认	说明
`weakenResourceCache`	`true`	弱化资源缓存使其可 GC（注释标注 Safe）
`removePackageManifestMap`	`true`	移除未使用的 package manifest map

tweaks（4 项）

配置键	字段	默认	说明
`arrowDing`	`ArrowDingTweakEnabled`	`false`	怪物被箭射中也播「叮」声
`chickenLureFix`	`ChickenLureTweakEnabled`	`false`	母鸡对所有可繁殖物品而非仅种子产生吸引 AI
`villageAnvils`	`VillageAnvilTweakEnabled`	`false`	铁匠铺原本是「双石台阶」的位置生成铁砧
`mc18SkinSupport`	`mc18SkinSupport`	`true`	支持 MC 1.8+ 皮肤格式
`openUrlLinux`	`clOpenUrlLinux`	`true`	修复 Linux 客户端打开 URL

⚠️ 默认值取自 `config.get(...).getBoolean(<default>)` 的实参

本条目所有默认值都取自 BugfixModClassTransformer.initialize() 里 config.get(category, key, <default>, comment).getBoolean(<default>) 的第二个实参 （即 getBoolean 的入参），而不是凭 config 文件内容推断 —— 源码里的注释文本不构成默认值证据。

覆盖写入：专用服务器降级

在 config.save() 之前，若 <mcLocation>/saves 不存在，以下 3 项被强制置 false 并落盘： BoatDesyncFixEnabled、HeartBlinkFixEnabled、HeartFlashFixEnabled。详见 BugfixMod Class Transformer。

源码

src/main/java/pl/asie/foamfix/bugfixmod/BugfixModSettings.java
src/main/java/pl/asie/foamfix/bugfixmod/coremod/BugfixModClassTransformer.java:96-181