PlugDev 1.4.0 — background capture and player controls
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.0From a running local development project:
plug client start --instance "FO 26.1.2" --player CaptureTester
plug capture shot --name menu --width 960See 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.
