BugTorch

[!INFO] Git Commit: a0fd8d7 | Updated: 2026-10-02

纯 Mixin 补丁包。修一批 1.7.10 原版缺陷、回移少量不新增内容的特性， 并可选地给若干第三方 mod 打补丁。自身不注册任何方块 / 物品 / 实体 / 附魔 / 维度。

身份

属性 实测值
modid bugtorch（全小写，BugTorch.java:38）
modName BugTorch
资源域 bugtorch
主类 jss.bugtorch.BugTorch
Java 文件 108（5 362 行），其中 1 个在 jss.util 包下
注册内容 0 方块 / 0 物品 / 0 实体（无任何 GameRegistry 调用）
配置项 110（88 boolean + 22 数值），分 base.cfg / modSupport.cfg
Mixin 92 个 @Mixin 类，89 个已注册 / 3 个未注册
Mixin 条目 82（EARLY 69 + LATE 13）
Access Transformer 3 条，全部为 MerchantRecipe 的私有字段
硬依赖 required-after:gtnhmixins@[2.0.0,)
可选依赖 Thaumcraft、VillageNames、witchery、temperateplants、torchLevers、ExtraUtilities、TXLoader

[!IMPORTANT] 「bug 报告工具」的猜测不成立：README 首段写明名字来自「杀虫剂喷灯（bug spray + lighter）」的玩笑，即用喷灯喷掉 bug。 它是修 bug 的一方。全仓无崩溃上报、遥测、issue 生成或错误收集代码。

[!NOTE] mcmod.info 全文为 ${modId} / ${modName} / ${modVersion} / ${minecraftVersion} 占位符， modid 与版本只能从 gradle.properties 的 modId 与生成的 Tags.VERSION 读取。

[!NOTE] 三份 mixins.bugtorch*.json 的 mixins / client / server 数组全为空， 实际注入清单由 Mixins 枚举在运行时生成， 静态读 json 会误判成「零 mixin」。

源码缺陷

缺陷 位置
3 个 @Mixin 类已实现但从未注册，运行时不可达 未注册 Mixin 类
isVersionLessThan 定义后零调用，并引入未使用的 ComparableVersion 导入 TargetedMod.java:47
TX_LOADER 条目传了三参构造的 targetClass，但实际走两参重载将其丢弃 TargetedMod.java:40
dyeOreIds 填充后未校验 OreDictionary.getOreID 是否返回无效 ID（-1） BugTorch.java:93-95

依赖关系

  • 硬依赖 gtnhmixins（UniMixins 的 GTNH 分支，≥ 2.0.0）——属库，不在本 wiki 收录范围。
  • 以下目标 mod 在 relation.md 有登记行但尚未成文，本 wiki 暂无条目： villagenames、hodgepodge、 lwjgl3ify、angelica、thaumcraft。
  • 以下目标 mod 不在收录范围（relation.md 无对应行）： Aether II、Crayfish Furniture (cfm)、Extra Utilities、Gany’s Surface、L-Library、 NotFine、OptiFine、TXLoader、CoFHCore、Pam’s Temperate Plants、Torch Levers、Witchery。

核心列表

主类、配置、Mixin 注册表与加载插件

Mod 支持列表

7 个按 mod 划分的支持类

Mixin列表

按主题分组的 92 个 @Mixin 类

  • backport - 5 类：蜘蛛网剪切、创造扔末影珍珠、枯灌木掉木棍、火矢引爆 TNT 车、火球音效
  • blockfarmland - 3 类：水培、新纹理、不被踩踏
  • cofhcore - 1 类：装 CoFHCore 时的 Shift 合并堆叠复制防护
  • damage - 3 个条目 / 4 个类：熔岩与火焰伤害缩放
  • damage-scaling - 7 组成对配置共 14 项：按最大生命值缩放环境伤害
  • entitylivingbase - 3 类：溺水 / 窒息伤害缩放 + 客户端药水粒子
  • fastrandom - 7 个已注册 + 2 个未注册：用 xoshiro256** 替换 java.util.Random
  • fix - 11 类：原版方块 / 物品 / 音效缺陷修复
  • gamesettings - 3 类：客户端选项加载与交互加速，全部排除 OptiFine
  • logcleanup - 4 类：Netty 泄漏、告示牌刷屏、实体属性刷屏等
  • mod-late - 13 条 LATE 条目，全部打第三方 mod 的补丁
  • optimization - 8 类：跳过不必要的方块 / 实体计算
  • placement - 5 类：南瓜、压力板、火把、末地门的位置校验放宽
  • potion - 2 类：毒与凋零伤害缩放
  • rendering - 4 类（1 个未注册）：附魔混合、粒子深度排序、附魔台粒子
  • shearing - 3 类：剪刀掉落复制与耐久判定
  • smartrender - 1 类：禁用 SmartRender 渲染处理器
  • tweaks - 8 类：行为微调（闪电音量、局域网端口、任意染料染皮甲等）
  • 未注册 Mixin 类 - 3 个已实现但从未注册的 @Mixin 类（死代码）
  • villagertrademeta - 2 类：村民交易 NBT 元数据保真
  • worldgen - 8 类：矿道空腔、结构组件、村庄道路与水井

客户端列表

唯一的客户端 UI 代码