Skip to content

v26.1 — GA

Latest

Choose a tag to compare

@StarsailsClover StarsailsClover released this 05 Sep 17:01
v26.1
6fac5ca

BCDebugJavaAgent v26.1 — GA

General Availability — production release of the v26.1 line.

What changed since v26.0

Universal runtime

  • One artifact for every game JVM: the entire agent is Java 8 bytecode
    (major 52 verified) — attaches to 1.12.x-era JDK 8 games through 26.x JDK
    21+ games. No per-era builds.
  • mappingsFile load failures fall back to automatic discovery (when
    network consent is given).

Secured, audited control plane

  • httpToken=<secret>: every endpoint requires the token (X-BCDebug-Token
    header or token query), constant-time compared, on both frontends.
  • Structured JSONL audit trail (bcdebug-audit.log) with caller address —
    including auth-fail records for unauthorized probes.
  • Method enforcement: GET on reads, POST on writes (both frontends).

Live diagnostics and runtime operations

  • /filters?add=&remove= — extend recording scope without restart
    (retransform-based, tracker-guarded); removal mutes (no byte surgery).
  • /hooks/add?class=&method=&desc=&level= — plant ad-hoc observation
    points into a running game; /hooks/list, /hooks/clear.
  • /logs?level=&contains=&limit= and /methods?contains=&min=&limit=
    filtering.
  • /status visibility: muted prefixes, token enabled.

Readability

  • Exports and HTTP payloads show fully deobfuscated class, method AND
    descriptor triples when mappings are active.
  • Experimental 1.12 profile (MCP-named hooks, user-supplied mapping).

GA promotion round (MC 1.21.1 dedicated server, GA jar)

Check Result
Agent init v26.1, token enabled, hooks active
Mapping auto-discovery 6148 mappings applied
Hook reload / filter add / runtime hook add Accepted (pending-state for unloaded targets)
Token enforcement 401 for unauthenticated
Log filtering 3 filtered rows
Auto-filter ServerLevel#tick (export) entryCount=43419
Export / audit Success, records captured

Combined with the Alpha.9 battery (PASS) and Alpha.10 LTS validation, the
production-testing gate is satisfied. 56 unit tests green.

Quick start

java -javaagent:bcdebug-javaagent-v26.1.jar=hookProfile=auto,mappingsAuto=true,logFile=true,exportIntervalSec=60 -jar minecraft.jar

安装说明(中文)

  1. 下载 bcdebug-javaagent-v26.1.jar —— 单制品覆盖 JDK 8+ 全部游戏 JVM。
  2. 推荐配置:hookProfile=auto,mappingsAuto=true,logFile=true,exportIntervalSec=60。
  3. 多用户主机启用令牌:httpToken=<secret>。
  4. 运行中操作:/filters、/hooks/add、/log-level、/export。

MIT License — Copyright (c) 2026 BlockConnect