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.

v26.3

Aprism Loader v26.3 (Official Release)

The official release of the v26.3 minor line of the 2026 major line.
Targets Minecraft Java Edition 26.2. This minor collapses Alpha.1 through
Alpha.9 into the loader-ecosystem parity + experimental-surface set: the
QA0 API gaps (game events, typed registries, networking), the experimental
AI/rendering reference surfaces, and full Fabric/Forge/NeoForge feature
parity for the mainstream loaders.

What is new since v26.2

Loader-ecosystem parity (the v26.3 focus)

• Event-bus dispatch priority (Forge/NeoForge parity) —
  EventPriority (HIGHEST/HIGH/NORMAL/LOW/LOWEST), priority-sorted
  dispatch with registration order within a tier, cancel short-circuit
  across tiers, priority-agnostic unregistration.
• InterModComms (Forge/NeoForge parity) — one-way cross-mod messaging
  keyed by method string: phase-gated send window (fail-closed before
  INIT), per-target buffered queues drained in send order, exact
  method-key filtering with non-match retention, shutdown clear.
• Command & key-binding registration (Fabric parity) —
  CommandSpec/CommandRegistration and KeyBindingSpec/
  KeyBindingRegistry with one-shot registration windows (INIT opens,
  COMPLETE freezes), duplicate rejection, registration-order preservation.
• Tick scheduler & resource reload (Fabric parity) —
  TickScheduler (repeating + one-shot tasks per distribution, fail-safe
  handler firing, side independence) and ResourceReloadRegistry
  (one-shot window, fail-safe reload firing).

QA0 API gaps (Alpha.1-Alpha.3)

• Game-event dispatch — GameTickEvent, ClientRenderEvent,
  WorldLoadEvent, WorldUnloadEvent over the phase-strict event bus
  with attachment gating and fail-safe dispatch.
• Typed registries — ResourceKey, TypedRegistry, typed
  Block/Item/Entity content registries with fail-closed binding.
• Networking API — PacketChannel, NetworkPacket,
  NetworkTransport seam with fail-closed sends and listener isolation.

Experimental / reference-only surfaces

• AI support reference (goal #8) — AiRequest/AiResponse/
  AiAssistant contract, AI_EXTENSION .aep type, capability-gated
  completion registry. No production guarantee.
• Rendering pipeline innovation reference (goal #9) — RenderBackend
  (Vulkan-first per the Mojang transition, Metal/DX12 experimental),
  RenderCapability, RenderingProvider seam. No production guarantee.

Test & verification status

• Test suite: 496 tests, 0 failures (grew from 430 at the v26.3 line
  start through the parity alphas).
• Real-game harness: SMOKE PASS on Minecraft 26.2 + Aprism agent.
• All Alphas shipped with signed commits/tags and cosign-verified release
  assets (SHA-256 + sigstore keyless, AprismLab identity).

Upgrade notes

• Mods compiled against v26.1/v26.2 recompile unchanged against v26.3
  (all new surfaces are additive; the priority-register overload is a
  default method).
• The event bus now dispatches in priority order; mods relying on
  registration-order dispatch of same-priority listeners keep their
  behaviour (stable within a tier).
• Known limitations remain listed in Doc 09 (Known Issues); the parity
  surfaces define the registration contracts but the actual game-side
  dispatch (command dispatcher binding, input-system mapping, tick-loop
  driving) is provided by the injector/native layer.

Documentation

English: docs/en/01-architecture-design.md (sections added per alpha),
docs/en/09-known-issues.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.

v26.2

Aprism Loader v26.2 (Official Release)

The official release of the v26.2 minor line of the 2026 major line.
Targets Minecraft Java Edition 26.2. This minor collapses Alpha.1 through
Alpha.9 into a single frozen, verified surface.

Highlights

• Structured logging facility (Alpha.1, goal #6) — AprismLogging
  central facility with per-unit AprismLoggers, TRACE..ERROR threshold
  gating, a retained ring buffer (backs crash reports), console sink
  (stdout/stderr split at WARN), and an append-mode file sink under
  <game-root>/aprism-logs/. Fail-safe: a broken sink never crashes the
  host game.
• Native mod list (Alpha.2, goal #7 part 1) — ModListRegistry rebuilt
  from loaded containers and load-report failures after every
  performLoad; per-unit immutable snapshots (id, version, name,
  description, kind, loader key, source, depends, state) ready for the
  future in-game mod menu.
• Typed mod settings (Alpha.3, goal #7 part 2) — mods declare typed
  settings under custom.aprism.settings (string/integer/double/boolean/
  enum with defaults, labels, and enum options); SettingsRegistry
  validates get/set against declarations and persists user values as one
  JSON file per mod under config/aprism-settings/. Defensive: invalid
  persisted values fall back to defaults. Closes the QA0 config-API gap.
• Aprism BE approach research (Alpha.4, goal #5) — research report
  comparing native BE injection routes (Windows proxy-DLL P0, Android
  Zygisk/container P1, iOS research tier, BDS via LeviLamina adapter) with
  a recommended three-layer native architecture, decisions DEC-BE-1..5, and
  a P0-P4 plan (EN canonical + ZH copy under docs/research/).
• Loader-support extraction complete (Alpha.5, goal #4 CLOSED) — all
  transitional built-in foreign-loader bridges, built-in support extensions,
  and foreign-loader shim types removed from aprism-loader-core and the
  production artifact. The LoaderEntrypointHandler SPI is now the ONLY
  foreign-loader dispatch path; AprismRefract branch .aep archives are the
  providers (verified by five cross-repo E2E tests).
• QA1 review + crash report hardening (Alpha.6) — crash reports embed
  the recent structured-log tail and the mod list snapshot; the runtime
  mirrors key lifecycle events into the structured facility.
• Real-game harness re-run + baseline refresh (Alpha.7) — SMOKE PASS on
  real Minecraft 26.2 with JDK 25; unit-level mixed-instance performLoad
  baseline 27 ms, real-game agent-init-to-lifecycle-complete ~1 s.
• Documentation refresh + known issues (Alpha.8) — Doc 02 settings
  schema, README post-extraction state, and Doc 09 known issues (EN + ZH).
• Release candidate (Alpha.9) — surface frozen, production checklist
  complete.

Alpha changelog (v26.2-Alpha.1 .. Alpha.9)

Alpha	Subject	Tests
Alpha.1	Structured logging facility (AprismLogging, ring buffer, console/file sinks)	364
Alpha.2	Native mod list registry (ModListRegistry + ModListEntry + ModListState)	374
Alpha.3	Mod settings schema + registry (typed declarations, JSON persistence)	395
Alpha.4	Aprism BE approach research report (EN + ZH, DEC-BE-1..5)	395
Alpha.5	Loader-support extraction complete (goal #4 closed; SPI-only dispatch)	364
Alpha.6	QA1 superset review + crash report hardening	364
Alpha.7	Real-game harness re-run (SMOKE PASS) + startup baseline refresh	364
Alpha.8	Documentation refresh + known issues (Doc 09 EN + ZH)	364
Alpha.9	Release candidate (surface frozen, production checklist complete)	364

Verification

• Full test suite at Alpha.9: 364 tests, 0 failures, 0 skipped
  (all modules, JDK 21 Temurin, --rerun-tasks).
• Real-game verification: Minecraft 26.2 booted with the Aprism fat agent
  jar; full .aje lifecycle observed in the live game (SMOKE PASS,
  v26.2-Alpha.7).
• All artifacts signed: signed commits and tags (SSH ED25519), cosign
  keyless signatures on release assets, CycloneDX SBOM.

Contents

• Aprism-v26.2-JE-26.2.jar — the self-contained javaagent (fat jar,
  dependencies relocated)
• checksums.txt — SHA-256 of the artifact
• .sig / .bundle — cosign keyless signatures
• Aprism-sbom.cdx.json — CycloneDX software bill of materials

Quick start

java -javaagent:Aprism-v26.2-JE-26.2.jar=aprismVersion=v26.2;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/; loader-support extensions (.aep,
e.g. Fabric-Support / NeoForge-Support from the AprismRefract releases) go
into <game-dir>/aprism-extensions/. See docs/zh/08-开发者指南.md and
docs/en/08-developer-guide.md.

Artifact verification

sha256sum -c checksums.txt

cosign verify-blob Aprism-v26.2-JE-26.2.jar \
  --signature Aprism-v26.2-JE-26.2.jar.sig \
  --bundle Aprism-v26.2-JE-26.2.jar.bundle \
  --certificate-identity-regexp "NDBlockConnect/Aprism" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Known issues

See docs/en/09-known-issues.md (canonical) and docs/zh/09-已知问题.md.

v26.4-Alpha.9

Aprism Loader v26.4-Alpha.9 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.9-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.9-JE-26.2.jar=aprismVersion=v26.4-Alpha.9;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.

v26.4-Alpha.8

Aprism Loader v26.4-Alpha.8 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.8-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.8-JE-26.2.jar=aprismVersion=v26.4-Alpha.8;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.

v26.4-Alpha.7

Aprism Loader v26.4-Alpha.7 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.7-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.7-JE-26.2.jar=aprismVersion=v26.4-Alpha.7;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.

v26.4-Alpha.6

Aprism Loader v26.4-Alpha.6 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.6-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.6-JE-26.2.jar=aprismVersion=v26.4-Alpha.6;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.

v26.4-Alpha.5

Aprism Loader v26.4-Alpha.5 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.5-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.5-JE-26.2.jar=aprismVersion=v26.4-Alpha.5;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.

v26.4-Alpha.4

Aprism Loader v26.4-Alpha.4 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.4-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.4-JE-26.2.jar=aprismVersion=v26.4-Alpha.4;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.

v26.4-Alpha.3

Aprism Loader v26.4-Alpha.3 (Pre-Release)

Build of the 2026 major line. Targets Minecraft Java Edition 26.2.

Contents

• Aprism-v26.4-Alpha.3-JE-26.2.jar: the self-contained javaagent (fat jar, dependencies relocated)
• checksums.txt: SHA-256 of the artifact
• .sig / .bundle: cosign keyless signatures (verify with cosign verify-blob)

Quick start

java -javaagent:Aprism-v26.4-Alpha.3-JE-26.2.jar=aprismVersion=v26.4-Alpha.3;mcEdit=JE;mcVersion=26.2;gameRoot=<path-to-game-dir> ...

Place .aje mods in <game-dir>/mods/. See docs/zh/08-开发者指南.md.