TC4Tweak

基本信息

net.glease.tc4tweak.TC4Tweak —— @Mod 入口。

@Mod(modid = TC4Tweak.MOD_ID, name = "TC4 Tweak", version = TC4Tweak.VERSION,
     dependencies = "required-after:Thaumcraft",
     guiFactory = "net.glease.tc4tweak.GuiFactory")

⚠️ modid 是 tc4tweak（单数）

项 值
MOD_ID tc4tweak（单数）
分类名 tc4tweaks（复数）
Logger 名 LogManager.getLogger("TC4TweakTransformer")（与 modid 不同）
mcmod.info modid tc4tweak

分类名取自仓库目录名 TC4Tweaks（复数），而真实 modid 是 tc4tweak（单数）。 搜索/引用时必须用单数形式。

版本

VERSION = "${version}" —— 构建期占位符。 真实版本在 build.gradle:65：

version = "1.7.10-10.13.4.1614-1.7.10"

这正是 version_gate.py 判定 ok 的依据（1.7.10-10.13.4 模式）。

硬依赖

dependencies = "required-after:Thaumcraft" —— 唯一依赖声明。 @Mod 注解没有 acceptableRemoteVersions，网络兼容性由 自定义 @NetworkCheckHandler 处理。

版本兼容范围

ACCEPTED_CLIENT_VERSION = VersionParser.parseRange("[1.4.27,2)")

checkConnection 中：客户端侧要求远端版本落在 [1.4.27, 2)， 或 allowAll 为真；服务端侧恒返回 true。

KNOWN_SIGNATURE：jar 签名校验

ImmutableMap.of(
    "473C3A397676978FF4877ABA2D57860DDA20E2FC", "glease",
    "004227A857B097EDE4E36ACB9B5491BC9808464", "glease");

构造器注册 ICrashCallable（标签 TC4Tweak signing signature）， 崩溃报告中列出代码签名指纹并标注 Built by: <known|glease>。 未匹配时提示 Do not bother glease for this crash!。

生命周期

4 个 @Mod.EventHandler 全部直接委托给 proxy： preInit / init / postInit / serverStarted。

配置同步

detectAndSendConfigChanges() 在服务器实例存在时，向所有客户端广播 MessageSendConfiguration（disc 0）与 MessageSendConfigurationV2（disc 1）， 由客户端套用自己的本地化字符串 —— 服务端/客户端配置值可不同。

相关条目

源码

  • src/main/java/net/glease/tc4tweak/TC4Tweak.java
  • build.gradle:65
  • src/main/resources/mcmod.info