Repository navigation
Remold v0.2.0
🚀 Remold v0.2.0 Release Notes
Remold v0.2.0 是一个里程碑式的重要更新版本!本次发布不仅将热重载能力延伸至 Minecraft Fabric (Mixin) 与 Mindustry (Arc 全套资源) 两大游戏模组生态,还在底层架构上补齐了字段类型动态变更、物理内存布局漂移安全门、第三方反射缓存驱逐 SPI、Lambda 单向捕获桥等核心安全防线,提供更加极致、零侵入、零重启的 Java 运行时开发体验。
🌟 核心亮点 (Highlights)
-
Minecraft Fabric 生态全面就绪 (
:plugin-mixin):- 深度集成 SpongePowered Mixin 字节码重织入桥;
- 支持在热重载时动态修改
@Mixin切入点与注入逻辑,无需重启 Minecraft 客户端; - 支持在 Mixin 类中使用
@Unique配合@RemoldReinit注入全新实例字段; - 随版本分发开箱即用的 minecraft-fabric-template。
-
Arc 全套多媒体与界面资源原位直刷 (
:plugin-arc):- PNG 贴图:Tier 1 原位直刷显存(
Gl.texSubImage2D),零重启修改界面与图集像素;支持运行期新增贴图动态注册; - 字体 / 语言包 / 音频 / 着色器:字体精确路由 UI 槽位,国际化 Bundle 安全回写内容缓存,音效音乐原位复用重载,内置着色器原位重编;
- 随版本分发开箱即用的 mindustry-mod-template。
- PNG 贴图:Tier 1 原位直刷显存(
-
字段类型变更(Field Type Changed)安全热重载:
- 当普通字段描述符类型变更(oldDesc != newDesc)且批次外无悬空读者时:无活体实例或标有
@RemoldReinit时安全放行; - 自动清除旧类型指纹缓存,重定义后由 InitFix 引擎安全写入新类型的初始值。
- 当普通字段描述符类型变更(oldDesc != newDesc)且批次外无悬空读者时:无活体实例或标有
-
物理内存布局预测器与漂移安全门 (
LayoutPredictor/SuperclassDriftGate):- 事前使用抛弃式 ClassLoader 干净预测物理布局(实测与 DCEVM 布局 100% 吻合);
- 结合堆存活探测,精准阻断父类增删字段引起的子类物理偏移漂移;
- 协同预注入整条非 JDK 祖先链,彻底防御 package-private 运行时包隔离访问异常。
-
第三方实例级反射与序列化缓存驱逐 SPI (
ReflectionCacheManager):- 内置 Jackson
ObjectMapper、GsonGson与 ArcJson实例级驱逐器; - 类重定义完成后自动清空解析缓存,防止反序列化错读陈旧字段元数据。
- 内置 Jackson
-
Lambda 表达式增强对齐与单向捕获桥 (
LambdaAligner):- 新增单向捕获桥,安全支持删除旧捕获变量;
- 支持新增捕获变量的纯源重放(字面量常量、
static final、final实例字段、可折叠算式、构造器参数回溯); - 引入 LVT 形参名定捕获身份,拦截同签名换序的静默错值。
🛠️ 快速上手 (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.0'
}2. 引入热重载 Gradle 插件
buildscript {
repositories { maven { url 'https://jitpack.io' } }
dependencies { classpath 'com.github.I-Hope1.Remold:gradle-plugin:v0.2.0' }
}
apply plugin: 'io.github.i-hope1.remold'3. 启动与热重载
- 执行
./gradlew runRemold(或在 IntelliJ IDEA 中直接使用自动生成的Run with Remold运行配置); - 保持进程运行,修改代码后按
Ctrl + Shift + F9,即刻体验秒级原位热更新!
📦 资产列表 (Release Assets)
- JavaAgent 探针:
remold-agent.jar/remold-agent-0.2.0.jar
- 生态插件:
remold-plugin-arc.jar/remold-plugin-arc-0.2.0.jarremold-plugin-mixin.jar/remold-plugin-mixin-0.2.0.jar
- Gradle 插件:
remold-gradle-plugin.jar/remold-gradle-plugin-0.2.0.jar
- API 与源码:
remold-api-0.2.0.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.1.3...v0.2.0