Skip to content

PlugDev 1.4.0 — background capture and player controls

Choose a tag to compare

@mattbaconz mattbaconz released this 09 Sep 13:13

PlugDev 1.4.0 adds background capture and rendered-player controls to the local plugin development loop. MCP 0.5.0 exposes the same implementation to coding agents.

Added

  • Native screenshots for existing Fabric 26.1.2 Prism instances, animated in-game cursors, real GUI hover/click interaction, camera and bounded player movement, HUD control and up to eight scenario test players.
  • PlugDev-1 Cursor: a white arrow with an amber accent. PlugDev-2 Cursor: a smaller dark arrow with a soft orange glow. Both sprites are original generated assets bundled with the optional client bridge.
  • Project-bound Windows recording, named PNG/GIF batches, crop/size controls, recording status/stop/cancel and source-once GIF/MP4 export. Failed encoding retains source footage for retry.
  • An optional isolated Minecraft 1.21.4 client with a 512 MiB heap limit, capped rendering and idle shutdown. The Prism main-client path preserves that profile's existing mods and memory settings.

Changed and fixed

  • Capture selects a verified client/window identity and does not inject global F1/F2 or activate Minecraft. Unsupported minimized, locked and headless states fail explicitly.
  • Agent command imports are loaded on demand; logs and rebuild queues are bounded.
  • MCP capture/player controls require CLI 1.4.0 or newer, preventing accidental dispatch to older foreground-capture implementations.
  • Optional GUI/TUI capture guidance, readiness and hover/focus states are clearer.

Install

npm install -g @plugdev/cli@1.4.0 @plugdev/mcp@0.5.0

From a running local development project:

plug client start --instance "FO 26.1.2" --player CaptureTester
plug capture shot --name menu --width 960

See capture scenarios and controls. Reload the MCP server in your editor after updating.

Verified with 270 passing CLI/MCP tests and real Windows/FO 26.1.2 GUI captures, player actions, test players, cancellation and reattachment. A same-client benchmark measured median native screenshots at 0.81 s versus 6.88 s for the existing WGC path (three warm samples per path); this is a local result, not a universal speed guarantee. Existing full-repository TypeScript diagnostics remain outside the release's passing build/test checks.

Capture requires an unlocked Windows desktop, FFmpeg with gfxcapture, and FFprobe. The rendered-client test used an isolated Paper 1.21.4 server through ViaVersion. No native Paper 26.1.2, headless or locked-desktop support is claimed.

PlugDev-2 Cursor in the tested Minecraft GUI