Skip to content

DebugBridge v2.1.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 Aug 10:57
· 1 commit to main since this release
v2.1.0
2e4186d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

DebugBridge v2.1.0

Groovy-Java bridge for Minecraft: a WebSocket REPL into the running client.

Installation

  1. Install Fabric Loader for your Minecraft version
  2. Drop the appropriate JAR into your mods folder
  3. Launch the game — you'll see a developer warning on first run
  4. After accepting, the bundled web UI is at http://localhost:9976
    (the in-game startup message prints the exact URL)

Release artifacts

This release publishes the same DebugBridge
2.1.0 feature line for every
maintained Minecraft target. Choose the jar whose Minecraft version
matches the instance exactly.

  • debugbridge-1.19-*.jar — legacy Minecraft 1.19 support
  • debugbridge-1.21.11-*.jar — Minecraft 1.21.11 support
  • debugbridge-26.1-*.jar — exact Minecraft 26.1 support
  • debugbridge-26.2-*.jar — stable 26.2 line

New Minecraft lines

  • Adds a complete exact-26.1 bridge, including native entity,
    block, screenshot, recording, session-control, and GPU-backed
    item-texture providers.
  • Promotes the former 26.2 development module to stable Minecraft
    26.2, with exact metadata and stable rendering/API targets.

Safer recordings

  • record_video now uses temporary storage by default with a
    24-hour TTL and automatic cleanup.
  • Set storage: "persistent" to keep captures under
    <gameDir>/debugbridge-recordings/.
  • Recording payloads now receive strict, centralized validation;
    response metadata reports storage, directory, and expiry.

Reliability and hardening

  • runCommand keeps the same opt-in wire contract but now uses a
    native per-version provider instead of a Groovy round-trip.
  • Configuration values are deserialized and range-validated before
    use, while the legacy lua config block remains supported.
  • Object references are bounded, script execution reuses its worker,
    mapping search avoids redundant passes, and errors are formatted
    consistently without leaking unnecessary Java internals.
  • Recording lifecycle, disconnect errors, texture-provider cleanup,
    and entity/equipment refresh races are handled more defensively.

Web UI

  • Improves inventory slot/component rendering and extracted the
    repeated slot presentation into a shared component.
  • Adds renderer-fallback indicators and fixes entity texture/status
    races and stale timers.
  • Adds unit coverage for bridge services and entity/block stores.

Compatibility

  • The endpoint set and Groovy 5 scripting model remain compatible
    with v2.0.0.
  • Existing opt-in gates for runCommand and session control remain
    disabled by default.

Supported Versions

  • Minecraft 1.19 (Fabric Loader >= 0.14.0)
  • Minecraft 1.21.11 (Fabric Loader >= 0.16.0)
  • Minecraft 26.1 exact (Fabric Loader >= 0.19.2)
  • Minecraft 26.2 stable (Fabric Loader >= 0.19.2)
Assets 6
Loading