Repository navigation
Remold v0.2.1
🚀 Remold v0.2.1 Release Notes
Remold v0.2.1 进一步拓展了模组开发生态,正式带来 Minecraft Forge & NeoForge 统一自适应热重载插件,并深度优化了 Fabric 开发工作流(解除 Gradle Daemon 独占锁定、自动化部署)与 IDE 原生单文件编译实时监听,带来极致流畅的原生热重载体验!
🌟 核心亮点 (Highlights)
-
Minecraft Forge & NeoForge 统一自适应插件 (
:plugin-forge):- 新增扩展插件
:plugin-forge(分发产物remold-plugin-forge.jar),提供remold.HotswapPluginSPI 驱动; - 支持
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)注入探针参数。
- 新增扩展插件
-
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 符号转义损坏。
- 模板默认配置
-
IDE 原生编译目录实时监控 (
out/production):- 脚本层自动探测并创建工程根目录下的
out/production,纳入-javaagent监控目录表; RemoldAgent增强:显式指定未建的out/production时自动创建,当监控包含build/classes/...时自动向上查找到项目根目录探查并挂载out/production;- 在 IDEA 中通过单文件编译快捷键(
Ctrl + Shift + F9)编译的 class 改动能直接在 200ms 内触发热重载,无需等待 Gradle 完整构建流程。
- 脚本层自动探测并创建工程根目录下的
-
测试套件与规范守卫:
- 新增
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.jarremold-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.zipmindustry-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