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. mappingsFileload 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 ortokenquery), constant-time compared, on both frontends.- Structured JSONL audit trail (
bcdebug-audit.log) with caller address —
includingauth-failrecords 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./statusvisibility: muted prefixes, token enabled.
Readability
- Exports and HTTP payloads show fully deobfuscated class, method AND
descriptor triples when mappings are active. - Experimental
1.12profile (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安装说明(中文)
- 下载
bcdebug-javaagent-v26.1.jar—— 单制品覆盖 JDK 8+ 全部游戏 JVM。 - 推荐配置:
hookProfile=auto,mappingsAuto=true,logFile=true,exportIntervalSec=60。 - 多用户主机启用令牌:
httpToken=<secret>。 - 运行中操作:
/filters、/hooks/add、/log-level、/export。
MIT License — Copyright (c) 2026 BlockConnect