Skip to content

v26.1-Alpha.6 — Mute semantics + audit log

Pre-release
Pre-release

Choose a tag to compare

@StarsailsClover StarsailsClover released this 05 Sep 08:05
· 5 commits to v26.1 since this release
v26.1-Alpha.6
d2489db

BCDebugJavaAgent v26.1-Alpha.6

Pre-Release — Alpha builds are functional but unstable. Do not run in production environments.

Highlights

Mute semantics for filter removal — a removed prefix now goes SILENT:

  • MethodRecorder gains a muted-prefix set: already-instrumented methods
    keep calling into the recorder, but entries for muted prefixes are no
    longer recorded (exit paths self-heal via missing stats entries).
    POST /filters?remove=X mutes X; re-adding unmutes. No byte surgery —
    hot-path cost is a small startsWith scan, zero when the set is empty.
  • setFilters responses now include the muted list.

Control-plane audit log:

  • Every mutation (/log-level, /filters, /hooks/reload) appends a
    structured JSONL record — {ts, op, detail} — to
    <outputDir>/bcdebug-audit.log. Best-effort by design: audit failures
    never affect the audited operation or the game.

Validation

Live on MC 1.21.1 dedicated server (obfuscated, mappings auto):

add dcd    -> {"added":1,"retransformed":1,"muted":[]}
remove dcd -> {"removed":1,"muted":["dcd"]}
re-add dcd -> {"added":1,"muted":[]}          (recording resumes)
AUDIT: 3 JSONL records captured (filters ×3)

54 unit tests green (mute/resume/isolation + audit wiring).

Build Information

Item Value
Artifact bcdebug-javaagent-v26.1-Alpha.6.jar (bytecode 52 — JDK 8+)
Commit d2489db (SSH-signed, Verified)
Tag v26.1-Alpha.6 (SSH-signed, Verified)

安装说明(中文)

  1. 下载 bcdebug-javaagent-v26.1-Alpha.6.jar。
  2. 录制暂停:POST /filters?remove=<前缀>;恢复:POST /filters?add=<前缀>。
  3. 审计轨迹:<outputDir>/bcdebug-audit.log。
  4. Alpha 版本不稳定,请勿用于生产环境。

MIT License — Copyright (c) 2026 BlockConnect