v26.4

Aprism Loader v26.4 (Official Release)

The official release of the v26.4 minor line of the 2026 major line.
Targets Minecraft Java Edition 26.2. This minor is the deep API line:
it pushes the Aprism JE native API down into lower-level positions and
delivers the AprismJDK subproject design, in service of the owner's
directive to permeate every aspect of the loader's low-level surface.

What is new since v26.3

AprismJDK subproject (Alpha.1-Alpha.2)

• AprismJDK research + design — the AJR (Aprism Java Runtime)
  positioning: an OpenJDK-variant distribution built bottom-up around the
  Aprism agent model, with the AprismateAgent, opened jdk.aprismate
  interfaces, performance/hardware fusion APIs, Cpp2Java/Rust2Java
  bridges on the FFM API, and a cross-Java-version compatibility matrix.
  Delivered as design docs (EN + ZH) plus the subproject skeleton in
  AprismLab/AprismJDK (which has since shipped its own v26.0-Alpha.1
  independently).
• Doc 10 — the project management & version-control conventions,
  codified: versioning scheme, trunk-based branching, signed
  commits/tags, release pipeline contract, testing rules, bilingual doc
  rules, subproject governance, security & disclosure.

Deep API layers (Alpha.3-Alpha.8)

• Deep bytecode-hook API (A3) — ClassShape / ClassShapeDiff /
  ClassShapeAnalyzer (ASM-backed structural introspection and
  validate-before-redefine) plus fail-safe load-time ClassLoadObservers
  wired into the transformation pipeline.
• JVM introspection (A4) — JvmInsight: typed threads, class stats,
  heap summary, GC collectors, JIT state and VM identity over MXBeans.
• Native interop bridge (A5) — NativeBridgeProvider FFM-model seam
  with the capability-gated NativeBridgeRegistry; the FFM backend
  registers on AprismJDK (JDK 22+), stock JVMs refuse fail-closed.
• AprismateAgent reference (A6) — loader-side runtime detection
  (aprismate.jdk.version) and proven capability assembly
  (class-redefinition, method-hooks, jvm-introspection,
  native-bridge).
• Performance & hardware fusion (A7) — advisory HardwareInsight
  (proven CPU tokens only, -1 sentinels) with a replaceable deep probe
  via HardwareRegistry.
• Cross-language runtime (A8) — the Cpp2Java / Rust2Java reference:
  ForeignType ABI vocabulary, typed signatures, ownership policies,
  binding registry, capability-gated invocation through the native bridge
  seam.

Test & verification status

• Test suite: 579 tests, 0 failures (grew from 496 at the v26.4 line
  start).
• Real-game harness: SMOKE PASS on Minecraft 26.2 with JDK 25 and 2
  mods (v26.4-Alpha.9 candidate freeze; Doc 10 §5.3 requirement met).
• All Alphas shipped with signed commits/tags and cosign-verified release
  assets (SHA-256 + sigstore keyless, AprismLab identity).

Upgrade notes

• All new surfaces are additive; mods compiled against v26.3 recompile
  unchanged.
• Every deep capability degrades gracefully on stock JVMs: detection is
  fail-safe, capability queries return proven values only, and no deep
  API ever throws into the game.

Documentation

English: docs/en/01-architecture-design.md (sections added per alpha),
docs/en/10-project-management-and-version-control.md,
docs/research/aprismjdk/01-design.md, docs/release-notes/.
Chinese: mirrored under docs/zh/.

---

Aprism — a cross-platform, cross-version Minecraft mod loader & injector.
Author: BlockConnect@StarsailsClover. License: GPL-2.0.