Workflow & Automation

dsh-minecraft-agent

jcs130/dsh-minecraft-agent · ★ 4

jcs130

A DeepSeek Harness plugin system that lets AI agents live and act autonomously in Minecraft — not just one bot, but a whole world of "transmigrators" governed by a goddess,…

License
MIT
Added
2026-08-16
Maintenance
active
Install kind
github
npm
@jcs130/dsh-minecraft-agent
Manifest details
Manifest status
Declared
Manifest path
package.json#dsh
Manifest checked
2026-08-19
Lifecycle scripts
None found

Static manifest checks report declarations only; they are not compatibility or security review.

安装

dsh plugin --profile web add github:jcs130/dsh-minecraft-agent

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

For install and environment setup, plus plugin development tutorials, see DSH community docs ↗

README

Source README · body: en · Read Chinese README

2026-10-28 development update: the Connection tab enables continuous autonomy by default. The same goal continues beyond cumulative 30-call/40-round limits, preserving its session, progress and receipts; safe step boundaries, owned short rests and explicit user pauses remain supported. See the continuation guide. The core rc.115 candidate includes current upstream work and shared first-person, vanilla skin and armor preview fixes. The formal dependency remains installable rc.99 until the replacement public package is verified.

Publication is on hold at the user's request. This source update does not publish npm/GitHub releases or reload live Agents. See the current verification scope; the published installation below remains rc.24 / core rc.99.

0.3.0-rc.24 is published on GitHub and npm with npm latest, exact core 0.5.7-rc.99 and optional Qiandengji 0.5.0-rc.24. Explicit read-only queries can overlap navigation; batch message readback, recovery and memory deduplication preserve task and evidence semantics.

Unmodified official DSH 0.2.1-rc.2 / rc.3 passed default public-registry pnpm installation, main/Worker loading, 38 MCP tools and real local knowledge queries. Each host passed 154 tests with one optional skip. Anonymous archive bytes match the reviewed build. See npm verification and release notes. Missing exact materials still use compatible rendering. Publication does not reload live Agents; native Desktop pixels and long-term gameplay remain separate checks. Candidate flags inside the immutable archive are build-time snapshots.

Editable personas, default-off mineral queries, local viewer skins, a shared versioned server notebook and official DSH capability presets are available from the Minecraft settings page. Offline CPU token-vector/keyword retrieval is not a neural semantic model; configure your own embeddings service when needed. Local skins affect the own web avatar only. Existing game, native reasoning/tools, metrics and experiment views remain available. See configuration and notebook, installation and public verification.

Published archives retain their reviewed bytes. Candidate flags inside the archive are build-time snapshots; Release attachments and main-branch records describe current distribution status. Installation alone starts no game or model.

简体中文 | English

Live spectating

Watch the Agent's existing game connection in first-person, third-person or 3D spectator views. Toggle the HUD and camera locally; the DSH panel can place the game beside native reasoning, replies and tool records.

Live 3D spectating from the shared core, with the HUD hidden

Captured on 2026-10-26 from the shared Agent MC World core's existing live spectator page, not an AI-generated image or a DSH Desktop window. This server has custom dungeon content; its skills and character appearance depend on optional server/appearance resources.

Live spectator HUD with map, abilities and action state

Embedded DSH game view beside native conversation and tools

The third image is a recorded DSH Web integration test. The transcript is visibly labelled offline UI test data; it demonstrates the layout, not live model reasoning. See screenshot provenance, Desktop installation and market listing status. The root screenshots.json provides the gallery in this order.

A thin DeepSeek Harness adapter for the shared Agent MC World core. DSH owns persona, goals, sessions, memory and model choice. The core owns one Minecraft body, navigation, tools, game memory, learning evidence, fast-decision contracts and visualization. The optional agent-mc-qiandengji package enables that server's protocols and reference material explicitly.

The rc.24 release consumes core 0.5.7-rc.99 and optional pack 0.5.0-rc.24. Java 1.21.1 is primary; actual connection protocols and compatible viewer materials remain explicit. Publication, installation, native Desktop pixels and live gameplay are separate acceptance stages.

The default lean tool set now retains *_script for on-demand shared routine and method discovery; explicit tools.exclude is respected.

Optional Harness2 practice reuses DSH's registered model route and the core's isolated execution, baseline/held-out comparison and game-memory contracts. It is disabled by default and never adopts a skill or resumes a live Agent automatically.

Use Node.js 24. The first-run form reuses DSH's selected provider, model and reasoning effort, allocates local ports and keeps a private per-account data directory. An empty first task connects without starting inference. The right pane renders DSH's original reasoning, tools and replies; game-only mode hides the transcript for streaming. Missing reasoning stays unavailable. Stop and configure preserves the session and persists the stopped state. Advanced deployments may still use a private configFile; see examples. Local and cloud models use the same body and public SDK/MCP interface. Microsoft authentication and server-specific activation remain explicit steps.

An existing session resumes with its original identity, goals and history. The adapter preserves structured receipts, task terminal states, cancellation and real DSH turn boundaries. Model actions carry actual session/turn/step attribution. Shadow suggestions are not counted as adopted learned actions. Client stream duration is not engine execution time, and unavailable metrics remain unknown.

The exact dependencies are public: use npm ci, npm run build and npm test. All locked dependencies use registry.npmjs.org with integrity metadata. Tests cover native DSH sessions, loopback model formatting/cancellation, stock official main/Worker loading and legacy repair rollback. MC_DSH_PROFILE targets an isolated installed profile for the stock fixture; DSH_RUNTIME selects an external host for other API tests. The build copies only the adapter; it does not bundle another body or import a Cortico checkout.

See the migration guide and installation guide. The old 0.1.x implementation is retained as legacy reference and excluded from the default release.

MIT. Demonstration personas reference fictional third-party characters; no third-party YSM model is distributed.