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.