relauncher

模组

· 作者 juanmuscaria

用于基于 Java 应用程序的 JVM 重启库。

0 本站下载 0 关注 更新于 6 个月前

最新 1.1.0 · 26.1.2 · Fabric / Forge

一键开服(送7天)

Relauncher

面向基于 Java 的应用程序的 JVM 重新启动库。将单个 JAR 放入你的模组文件夹中,它即可在 Minecraft 1.6.4 至最新版本之间工作,或者作为早期插件或常规插件在 Hytale Server 上运行。

功能说明

Relauncher 会在游戏加载之前透明地重启 JVM 进程并添加额外的参数。这适用于以下场景:

  • 添加 JVM 标志 - GC 调优、-XX:+AlwaysPreTouch、系统属性等,无需触碰启动器设置
  • 整合包工具支持 - 其他模组可以在安装依赖项或配置环境(如 javaagents、模块层等)后以编程方式触发重新启动

重新启动发生在启动过程的极早期阶段,在任何重要的游戏状态初始化之前。外部启动器会看到一个单一且连续的进程,没有额外的窗口,也没有孤立的进程残留。

支持的版本

Loader Minecraft 版本 入口点
Forge (LaunchWrapper) 1.6.4 - 1.12.2 ITweaker via manifest
Forge (ModLauncher) 1.13.2+ ITransformationService via SPI
NeoForge (ModLauncher) up to 1.21.1 ITransformationService via SPI
NeoForge (FancyModLoader) 1.21.3+ IModFileCandidateLocator via SPI
Fabric 1.14+ PreLaunchEntrypoint via fabric.mod.json
Quilt 1.14+ Uses Fabric's PreLaunchEntrypoint
Hytale Server (early) - ClassTransformer SPI
Hytale Server (plugin) - JavaPlugin via manifest.json

Java 版本:8 到 25

平台:Linux、Windows 和 macOS,支持 x86_64 和 aarch64。

安装方法

  1. 下载通用 JAR 文件 (relauncher-universal-<version>.jar)
  2. 将其放入你的 mods/ 文件夹中
  3. 启动游戏一次,它将在 config/relauncher/config.cfg 处创建配置文件
  4. 编辑配置文件以添加 JVM 参数并将 enabled = true
  5. 重新启动游戏

配置

配置文件位于 <game directory>/config/relauncher/config.cfg:

# Relauncher Configuration
# Extra JVM arguments to add when relaunching, one per line.
# Lines starting with # are comments, blank lines are ignored.

# Set to false to disable relaunching without removing your arguments.
enabled = true

# Add extra JVM arguments below, one per line:
-XX:+UseG1GC
-XX:+AlwaysPreTouch
-Dsome.java.property=true

配置中的 enabled 标志仅控制配置文件自身的参数。如果另一个模组提供了 CommandLineProvider SPI 实现,无论此标志如何,都会发生重新启动。

工作原理

Relauncher 按优先级顺序尝试三种策略来重启 JVM:

  1. POSIX exec (Linux / macOS) - 通过原生 Rust 库调用 execvp() 就地替换当前进程。PID 相同,零开销,最干净的重新启动方式。

  2. Windows DLL - 挂钩 DllMain(DLL_PROCESS_DETACH) 以便在 JVM 完全关闭后派生子进程。在此之前会复制 stdin/stdout/stderr 以确保它们在清理过程中存活。父进程等待子进程完成并转发其退出代码。

  3. Fallback (纯 Java) - 启动带有继承 I/O 的子进程,等待其完成后停止。适用于所有平台,但原始进程会在整个游戏会话期间保留。

启动器兼容性

Launcher Status
Vanilla Fully supported
PrismLauncher Fully supported (system properties workaround)
CurseForge Fully supported (delegates to vanilla)
Modrinth Fully supported (theseus wrapper workaround)
ATLauncher Fully supported
MultiMC Not supported - relies on a stdin protocol that can't be replayed after relaunch. A warning is logged and the relaunch is skipped. Consider switching launchers or applying the arguments manually.

给模组开发者

API 依赖

将 relauncher-core 添加为仅编译依赖项——通用 JAR 将在运行时存在:

dependencies {
    compileOnly 'com.juanmuscaria:relauncher-core:<version>'
}

编程式重新启动

如果你的模组需要重启 JVM(例如在安装 javaagent 之后),直接调用 Relauncher.relaunch():

import com.juanmuscaria.relauncher.Relauncher;
import com.juanmuscaria.relauncher.RelaunchResult;

List<String> extraArgs = Arrays.asList("-Dfoo=bar", "-XX:+AlwaysPreTouch");
RelaunchResult result = Relauncher.relaunch(extraArgs);

// 如果代码执行到了这里,说明重新加载并未发生
if (result.isFailed()) {
    logger.error("Relaunch failed: " + result.reason());
} else if (result.isSkipped()) {
    logger.warn("Relaunch skipped: " + result.reason());
}

SPI 提供者

你也可以在不直接调用 API 的情况下注入 JVM 参数,只需实现 CommandLineProvider 并通过 ServiceLoader 注册即可。 Relauncher 会自动扫描 mods 文件夹中的服务文件,因此你的模组甚至尚未加入类路径也可以工作。

import com.juanmuscaria.relauncher.CommandLineProvider;

public class MyProvider implements CommandLineProvider {
    @Override
    public List<String> extraJvmArguments() {
        return Collections.singletonList("-Dmy.mod.installed=true");
    }

    @Override
    public int priority() {
        return 0; // 数值越小,优先级越高(越先运行)
    }
}

在 META-INF/services/com.juanmuscaria.relauncher.CommandLineProvider 中注册:

com.example.mymod.MyProvider

检查重新加载状态

Relauncher.isRelaunched()  // 如果我们处于已重新加载的 JVM 中,则返回 true
Relauncher.getDepth()      // 0 = 原始进程,1 = 第一次重新加载,以此类推

调试

在启动器的 JVM 参数中添加 -Drelauncher.debug=true。这将记录完整的命令行提取、参数组装和策略选择过程。有助于排查为什么重新加载没有按预期工作。

从源码构建

./gradlew build                           # 完整构建
./build-natives.sh                        # 交叉编译原生库

你需要 Java 17+(用作工具链;输出仍针对 Java 8)以及 Gradle 9。 要交叉编译原生 Rust 库,你还需要 cross、cargo-xwin、 cargo-zigbuild 以及 Zig 工具链。

许可证

Mozilla Public License 2.0

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源