Skip to content

Remold v0.2.1

Choose a tag to compare

@github-actions github-actions released this 03 Nov 08:47
· 683 commits to main since this release

🚀 Remold v0.2.1 Release Notes

Remold v0.2.1 进一步拓展了模组开发生态,正式带来 Minecraft Forge & NeoForge 统一自适应热重载插件,并深度优化了 Fabric 开发工作流(解除 Gradle Daemon 独占锁定、自动化部署)与 IDE 原生单文件编译实时监听,带来极致流畅的原生热重载体验!


🌟 核心亮点 (Highlights)

  1. Minecraft Forge & NeoForge 统一自适应插件 (:plugin-forge):

    • 新增扩展插件 :plugin-forge(分发产物 remold-plugin-forge.jar),提供 remold.HotswapPlugin SPI 驱动;
    • 支持 forge 与 neoforge 双别名挂载,自动识别 ModLauncher 与 NeoForge 运行时环境;
    • 跨 ClassLoader 穿透重织入 (ModLauncherMixinBridge):完美突破 ModLauncher / NeoForge 模块化加载层与 Agent 探针间的 ClassLoader 隔离,穿透执行 Mixin 增量重织入;
    • 事件总线自动刷新 (ForgeEventBusRefresher):监听重定义批次,自动识别 @SubscribeEvent / @EventBusSubscriber 的监听器增删,并在 MinecraftForge.EVENT_BUS / NeoForge Bus 上自动注销旧监听器并重新注册;
    • Gradle 脚本(remold.gradle/remold.gradle.kts)自动识别 Forge/NeoForge 生态(autoForge),并自动向 ModDevGradle(runs.client)与 ForgeGradle(minecraft.runs.client)注入探针参数。
  2. Fabric Loom 原生 Application 启动与守护进程解绑:

    • 模板默认配置 loom.runs.configureEach { preferGradleTask = false },解除游戏客户端对 Gradle 守护进程(Daemon)的排他占用,转为原生 Application 运行;
    • 自动在 IDEA Minecraft Client 与 Minecraft Server 启动项的 BeforeRunTask 中同步配置 deployArtifact 任务,运行前自动将最新构建产物同步至 run/mods/;
    • 优化 Minecraft_Client.xml 与 Minecraft_Server.xml 的 JVM 参数同步机制,使用 Matcher.quoteReplacement 原位更新 -javaagent,杜绝重复追加与 regex 符号转义损坏。
  3. IDE 原生编译目录实时监控 (out/production):

    • 脚本层自动探测并创建工程根目录下的 out/production,纳入 -javaagent 监控目录表;
    • RemoldAgent 增强:显式指定未建的 out/production 时自动创建,当监控包含 build/classes/... 时自动向上查找到项目根目录探查并挂载 out/production;
    • 在 IDEA 中通过单文件编译快捷键(Ctrl + Shift + F9)编译的 class 改动能直接在 200ms 内触发热重载,无需等待 Gradle 完整构建流程。
  4. 测试套件与规范守卫:

    • 新增 ForgePluginTest 与 WatchPathTest,测试基线提升至 403 个 JUnit 测试;
    • 规范状态标记扫描 (verifyDocStatusMarkers) 将 plugin-forge/src 纳入守卫范围,全量代码与客观设计文档 100% 保持无易腐标记。

🛠️ 快速上手 (Quick Start)

1. 声明 JitPack 仓库与 API 依赖

在你的 build.gradle / build.gradle.kts 中添加:

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    // 编译期 API 与热更控制注解 (@RemoldReinit, @OnReload)
    compileOnly 'com.github.I-hope1.Remold:api:v0.2.1'
}

2. 引入热重载 Gradle 脚本或插件

buildscript {
    repositories { maven { url 'https://jitpack.io' } }
    dependencies { classpath 'com.github.I-Hope1.Remold:gradle-plugin:v0.2.1' }
}
apply plugin: 'io.github.i-hope1.remold'

或直接引入脚本插件:

def remoldRef = (findProperty('remold.version') ?: '0.2.1')
apply from: "https://raw.githubusercontent.com/I-hope1/Remold/v${remoldRef}/remold.gradle"

3. 启动与热重载

  • 执行 ./gradlew runRemold 或在 IDEA 中直接运行自动生成的 Run with Remold / Minecraft Client 启动项;
  • 保持进程运行,在 IDEA 中修改代码后按 Ctrl + Shift + F9,改动瞬间生效!

📦 资产列表 (Release Assets)

  • JavaAgent 探针:
    • remold-agent.jar / remold-agent-0.2.1.jar
  • 生态插件:
    • remold-plugin-forge.jar / remold-plugin-forge-0.2.1.jar (✨ 新增)
    • remold-plugin-mixin.jar / remold-plugin-mixin-0.2.1.jar
    • remold-plugin-arc.jar / remold-plugin-arc-0.2.1.jar
  • Gradle 插件:
    • remold-gradle-plugin.jar / remold-gradle-plugin-0.2.1.jar
  • API 与源码:
    • remold-api-0.2.1.jar
  • 模版工程:
    • minecraft-fabric-template.zip
    • mindustry-mod-template.zip
  • Native 动态库:
    • libtool64.so(Linux x86_64)
    • libtoolarm64.so(Android arm64-v8a)

📑 完整变更日志 (Changelog)

详见仓库内 CHANGELOG.md。
Full Git Commits: v0.2.0...v0.2.1