Skip to content

v26.3

Choose a tag to compare

@github-actions github-actions released this 10 Aug 18:01
· 10 commits to main since this release
v26.3
0dff12b

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 dispatchGameTickEvent, ClientRenderEvent,
    WorldLoadEvent, WorldUnloadEvent over the phase-strict event bus
    with attachment gating and fail-safe dispatch.
  • Typed registriesResourceKey, TypedRegistry, typed
    Block/Item/Entity content registries with fail-closed binding.
  • Networking APIPacketChannel, 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.