Repository navigation
Remold v0.2.4
v0.2.4 Release Notes (draft for commander review)
Status: released 2026-11-07 (v0.2.4).
Previous release: v0.2.3 (0036550).
Highlights
@RemoldReinitscope: newscopeelement withSELF/INCLUDE_SUBCLASSES(default preserves
existing behaviour).SELFreinitializes only exact declaring-class instances; hostClassis
canonicalized so JBR's old-version "shadow"Classcannot corrupt identity filtering after a
structural redefine. A scope on a static field is ignored with a single[REINIT-SCOPE]warn.- Forge Mixin template hot update:
plugin-forgenow drivesIMixinTransformer.reload
reflectively and cascades a re-weave +redefineDynamicto loaded targets (ForgeMixinHotSwap).
Previously a changed@Mixinclass was defined into the target loader whileMixinInfostayed
stale, so@Injectbodies in targets never updated. - Mixin
@Injectself-evolution: added/renamed@Injecthandler methods now hot-swap.
MixinClassInfoSyncruns beforereloadMixin(the conform check reads that metadata) and
rolls back members when reload is rejected. - Profiler / entity probe robustness:
ProfilerTransformer.transformuses per-call local state
(reentrant, no shared-field clobbering); stale static-fieldClassrefs are normalized via
ClassIdentity.canonicalize;toggleEntityProbecatchesThrowableand rolls back from a
pre-call snapshot (failed enable restores the registration, failed disable re-registers). - Verification tooling:
probeAllaggregate task (not incheck) with zero exclusions; new
seconds-scale probes for multi-mixin targets,@Injectevolution,sourceBytecodeCachereal-path
matrix,LayoutGatereject→recover,@RemoldReinitscope, shadow-Class identity.
Fixes
plugin-mixin:MixinInfo.reloadMixinvalidated new@Injecthandlers against the previous
ClassInfo, rejecting added/renamed handlers withConform error ... please restart client;
sync now happens before reload, withSyncTokenrollback.plugin-forge: Mixin template changes were not reloaded (targets kept old handlers); new
ForgeMixinHotSwapreloads the template and cascades target re-weaving.coreprofiler: shared mutable transformer state causedNullPointerException: this.classReader is nulland intermittentClassFormatErrorwhenClassWriter.getCommonSuperClassre-entered the
transformer;transformis now stateless per call.coreprofiler/LibTool: static-fieldClassreferences rewritten by JBR redefinition (shadow
Classwith old fields,getInstances=0, silent no-op retransform) are canonicalized at API
boundaries.corelayout: type-change reject summaries no longer claim the reader scan failed; the note is
limited toREMOVED_FIELD.plugin-arc:Injectorused the package-privateRemoldAgent.instfield across the
app/bootstrap loader boundary (IllegalAccessError); it now uses publicRemoldAgent.getInst().
Verification
- JUnit: 461 tests, 0 skipped, 0 failures.
:tests:initFixOracle: all assertions pass../gradlew probeAll(explicit, not wired intocheck): all Gradle-hosted JVM probes pass,
includingalignBaselineProbeandoffsetStabilityProbe(47/47). Aggregate probes include
scopeReinitProbe35/0,cacheSourceMatrixProbe23/0,layoutRejectRecoverProbe41/0,
doubleBraceProbe80/0, P0.5 63/0, two-phase 42/0, lambda-bridge 35/0, retry 15/0,
initFix-fallback 14/0, inject-conflict 8/0, reader-scan 1/0, and the entity/shadow/class-identity
probes. External container scripts (Fabric C3/C5/multi-mixin, Forge C5/multi-mixin) are listed by
probeAllbut run separately with their own evidence files.- Mutation checks (seconds-scale, recorded in evidence): scope exact-class filter removal → red;
cache first-load write /putIfAbsentremoval → red; layout live-instance reject removal → red;
cancellablerevert and reload-order revert → red.
Known limits / manual acceptance
- Manual acceptance still pending:
docs/acceptance/01-manual-checklist.md(template scenarios
1–8, build/result columns intentionally empty for the user to confirm; real Fabric 1.21.1 client). - Forge upstream Mixin 0.8.5/0.8.7 semantics: cross-mixin same-name
@Uniquefields are merged
into a single field (Fabricsponge-mixindisambiguates to<sessionId>$<modId>$<name>$0).
Remold's re-weave keeps the merged field stable; this is upstream behaviour, not a Remold defect. - Forge
ClassInfomember sync for newly added Mixin members is not implemented on the Forge
side (Fabric covers it viaMixinClassInfoSync); structural contract changes still require a
restart. - NeoForge Mixin compatibility is not verified end-to-end.
NeoForgeHotswapPluginand the
sharedModLauncherMixinBridge/ForgeMixinHotSwapcode path exist, but there is no NeoForge
MDK probe and no realrunServerevidence: NeoForge mixin re-weaving, template hot update,
@Unique/@Injectretention and mixin-config registration are all unverified on NeoForge
(tracked as 🔶 indocs/status.md§Forge/NeoForge rows). Do not treat Forge 1.21.1 evidence as
covering NeoForge. - Container probes cover real servers (Fabric KnotServer, Forge
runServer), not a client GUI;
evidence hashes are per-process (Mixin sessionId) and not cross-run comparable. alignBaselineProbe/offsetStabilityProbeare JBR-sensitive and require
-XX:+AllowEnhancedClassRedefinition.offsetStabilityProbeProbe E's strict "cached Field
accessor auto-updated" assertion holds on JBR 25.0.2 (the intended p05 JDK); on JBR 21 the
accessor keeps the stale offset and reads the adjacents2=200Lslot, which is an
environment difference, not offset corruption.probeAllmust be run with JBR 25.0.2
(-Pp05.jbr=<jbr-25.0.2>); Probe D/D2 now pollcompilation.logfor Tier-4 compilation
(up to 30 rounds) instead of a fixed 100 ms warmup, which removes the batch-load flake.
Artifacts (build check)
core/build/libs/remold-agent.jar— 1.4 MB; MANIFEST:Premain-Class/Agent-Class=
remold.RemoldAgent,Boot-Class-Path: remold-agent.jar,Can-Redefine-Classes: true,
Can-Retransform-Classes: true; shaded content onlyremold/+libs/.plugin-{fabric,forge,mixin,arc}/build/libs/remold-plugin-*-0.2.4.jar.