SRVfix

中文 | English

简介

SRVfix 是一个客户端 Forge coremod:当 Java 8 运行时的系统 DNS 服务器列表中包含畸形条目时,它能恢复 Minecraft 的 SRV 记录解析,让使用 SRV 地址的服务器可以正常连接。

本模组只使用操作系统已配置的 DNS 服务器,不会添加公共 DNS,也不会修改 DNS、hosts、网卡、启动器或 JVM 的任何设置。

• 生效范围:多人游戏服务器列表与"直接连接"
• 不受影响:Minecraft Realms 使用独立的地址解析路径,SRVfix 有意不做修改
• 无任何配置项、GUI、聊天输出或生成文件

支持版本

• Minecraft 1.7.10 / Forge 10.13.4.1614
• Minecraft 1.8.9 / Forge 11.15.1.2318
• Java 8

同 Minecraft 版本的其他 Forge 构建、以及更高版本的 Java 运行时,仅为尽力支持。

安装

从 Releases 页面下载与你 Minecraft 版本对应的 JAR,放入客户端的 mods 目录即可。无需任何配置或依赖模组,服务器端无需安装。

校验下载文件

每个 Release 附件均附带同名 .sha256 校验文件。PowerShell 校验示例:

(Get-FileHash .\SRVfix-1.8.9-1.0.0.jar -Algorithm SHA256).Hash

将输出的哈希与对应 .sha256 文件内容比对即可。

自行构建

旧版 ForgeGradle 无法在现代 Java 上运行,因此需要完整的 JDK 8。设置 JAVA8_HOME 或 JAVA_HOME 后执行:

.\build.bat

本地 .toolchains 目录已被忽略,可放置便携版 JDK 8。

构建会运行确定性的解析器与 transformer 测试,对两个 JAR 进行 reobf,并校验 manifest、Java 8 类文件版本与依赖内容。所有构建产物写入 .target/build/。将两个已验证 JAR 及其 SHA-256 文件打包到发版暂存区 .target/release-out/:

.\build.bat release

再将暂存区发布到交付区 .target/installer/1.7.10 / .target/installer/1.8.9(原子交换 + .target/delivery.json 溯源记录):

.\deliver.ps1

对四个跟踪域名执行真实 DNS 验收检查:

Push-Location forge-1.7.10; .\gradlew.bat liveSrvProbe; Pop-Location
Push-Location forge-1.8.9; .\gradlew.bat liveSrvProbe; Pop-Location

许可证

MIT License © Sakyvo

---

SRVfix

中文 | English

SRVfix is a client-side Forge mod that recovers Minecraft SRV lookups when a Java 8 runtime exposes malformed entries in the system DNS server list.

The mod uses only DNS servers already configured by the operating system. It does not add a public resolver or modify DNS, hosts, adapter, launcher, or JVM settings.

It applies to the Multiplayer server list, server-list connections, and Direct Connect. Minecraft Realms uses a separate address path and is intentionally not modified. SRVfix has no configuration, GUI, chat messages, or generated files.

Supported Versions

• Minecraft 1.7.10 / Forge 10.13.4.1614
• Minecraft 1.8.9 / Forge 11.15.1.2318
• Java 8

Other Forge builds for the same Minecraft versions and newer Java runtimes are best-effort only.

Install

Download the JAR matching your Minecraft version from the Releases page and place it in the client mods directory. No configuration or dependency mod is required. Servers do not need SRVfix.

Verifying Downloads

Every release asset ships a matching .sha256 checksum file. To verify in PowerShell:

(Get-FileHash .\SRVfix-1.8.9-1.0.0.jar -Algorithm SHA256).Hash

Compare the output with the contents of the corresponding .sha256 file.

Build

A full JDK 8 is required because the legacy ForgeGradle versions do not run on modern Java. Set JAVA8_HOME or JAVA_HOME, then run:

.\build.bat

The local .toolchains directory is ignored and may contain a portable JDK 8.

The build runs deterministic resolver and transformer tests, reobfuscates the two JARs, and verifies their manifests, Java 8 class versions, and dependency contents. All build output lands under .target/build/. To package both verified JARs and their SHA-256 files into the release scratch .target/release-out/, run:

.\build.bat release

Then publish the scratch into the delivery area .target/installer/1.7.10 / .target/installer/1.8.9 (atomic swap + provenance record in .target/delivery.json):

.\deliver.ps1

For a live DNS acceptance check on the four tracked domains, run the matching version task:

Push-Location forge-1.7.10; .\gradlew.bat liveSrvProbe; Pop-Location
Push-Location forge-1.8.9; .\gradlew.bat liveSrvProbe; Pop-Location

License

MIT License © Sakyvo