dsh-unreal-engine-skills

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • No description — Repository has no description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • process.env — Environment variable access in cordis.patch.yml
  • exec() — Shell command execution in lib/index.js
  • process.env — Environment variable access in lib/index.js
  • process.env — Environment variable access in test/connection.test.js
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

README.md

dsh-unreal-engine-skills

English | 中文

Unofficial DeepSeek Harness port of Epic Games'
Unreal Engine Skills for Claude Code
(MIT, upstream 3.1.2). One bundle gives an agent three things:

  • Three runtime skills. unreal-mcp (discover and call Editor toolsets), create-toolset
    (author AI-callable C++/Python toolsets) and unreal-skill (author UE Agent Skills inside the
    editor), registered from skills/.
  • The Unreal MCP connection. A unreal-mcp row using @deepseek-ai/dsh-mcp-client connects to
    the editor's ModelContextProtocol server (default http://127.0.0.1:8000/mcp). The port and URL
    path are editable on the Harness Plugins page and take effect on save, without restarting.
  • Unreal project context. When a session's working directory is inside an Unreal project, a
    short UE-specific context note is added to the system prompt (the directory is detected by
    walking upward for a .uproject or GenerateProjectFiles.*).

Current version: 1.1.0. Use main for the latest development. To pin a local checkout to an engine line, run git switch 5.8 or git switch 5.9 before installing it. The 5.9 maintenance line starts from the UE 5.9 MegaJam Preview interface.

See Status and verification boundary
for what has and has not been verified.

Install

Requires DeepSeek Harness >=0.2.0-rc.2 <0.3.0 (declared as engines.dsh in
package.json).

From GitHub

dsh plugin --profile <your-profile> add github:liuli-zsl/dsh-unreal-engine-skills

For dsh web, use the web profile. On the official Desktop app, prefer the app's Plugins
page and enter the GitHub source there. Command-line management of desktop requires the command
installed by Desktop, an initialized profile, and fully quitting the app first; the npm CLI cannot
manage that profile. See the official CLI reference.
The bundle patch adds two loader rows: unreal-engine-skills (this package) and unreal-mcp
(@deepseek-ai/dsh-mcp-client).

From the plugin market

This plugin is listed in the community catalog used by dshmarket; market PR #8355 merged on 2026-10-20 (UTC).

The catalog's npm-version index for Harness 0.2.1+ Plugins → Discover is narrower than its full GitHub catalog: its generator requires an npm package, an exact version and its publish time. This plugin's catalog record has no npm package or version, and it is absent from that index as checked on 2026-10-21. It remains GitHub-only with private: true. This is a limit of that catalog's generator, not a requirement of every Discover index. See docs/publishing.md.

From a local checkout (development)

Point the Harness plugin manager's install_bundle at this directory, or add the directory with
dsh plugin add. When installed as a link to this checkout, run pnpm install --frozen-lockfile
here first: the host-side dependency (@deepseek-ai/schemastery) must be present in this
repository's node_modules, otherwise the plugin row silently stays inactive and none of the
skills, context injection or port form work.

Editor setup (once per project)

Your engine build must actually contain the ModelContextProtocol and AllToolsets plugins.
This package does not install them, and does not claim support for every UE5 release. The exact
engine version/branch and Windows/Linux behavior have not yet been recorded as verified.

  1. Check that Unreal MCP is enabled and enable All Toolsets (or the individual toolset plugins you need). Restart the editor if prompted.
  2. In Editor Preferences, check Model Context Protocol → Auto Start Server. Stock UE 5.8 defaults to off. The UE 5.9 Preview base configuration enables it. To start it for this session, run ModelContextProtocol.StartServer [port] in the editor console. The setup guide lists the .ini section for each version.
  3. The default port is 8000. When running multiple editors, assign a fixed port to each workspace and select the matching endpoint in Harness. See setup.

Port configuration

  • Plugins page form (recommended). Port and URL path are volatile config of the
    unreal-engine-skills row. Saving goes through Harness settings (settings.mutate →
    configEditor.edit); the host half then synchronizes the unreal-mcp row's url to
    http://127.0.0.1:<port><path> and the MCP client reconnects, without a restart. The sync runs
    both for a settings save (the Loader announces committed volatile changes) and after a plugin
    reload, and writes only when the url actually changes. It preserves current explicit settings
    (including headers, timeouts and reconnect policy), with bundle defaults for fields that have not
    been overridden (failOnStartupError, 300 s tool timeout, ~1 h backoff reconnect budget). On a
    Harness build that does not announce volatile updates, a saved endpoint takes effect on the next
    reload or restart.
  • Valid input. Port must be an integer from 1 to 65535. The path must start with /, contain
    no spaces, backslashes, query or fragment, and use percent encoding for characters outside the
    RFC 3986 path set (for example /mcp%20endpoint). Both the form and host schema validate it.
  • Environment variable. UNREAL_MCP_URL=http://127.0.0.1:9999/mcp set before starting
    Harness. It is process-wide (restart required) and always takes precedence over the form.
  • Custom transport guard. If you change the unreal-mcp row to a stdio proxy
    (transport: stdio with command/args), the port sync leaves that row untouched.
  • Patch entry caveat. In a profile patch, an entry with the same id replaces the row's
    config instead of merging. A hand-written patch must repeat serverName / transport / url;
    writing only url fails schema validation and the plugin will not activate. Prefer the form or
    the environment variable.
  • The sync relies on the HMR transaction around configEditor.edit(): it escapes the nested
    transaction check with hmr.executing.exit() and runs on the HMR queue
    (HMR transactions cannot be nested is a design constraint, not a defect).

Verify

With the editor running, ask the agent to read the current level. With tool search enabled it lists toolsets, reads the tool schema using the discovery tools advertised by the editor, and invokes the read-only tool through call_tool. UE 5.8 provides describe_toolset. UE 5.9 Preview provides describe_toolsets and describe_tools. Confirm the level belongs to the intended project.

Security

The bundle gives an agent broad live access to a running editor, including
ProgrammaticToolset.execute_tool_script (arbitrary Python inside the editor process). Treat it
like "letting an assistant run arbitrary code". Commit or shelve before long MCP sessions and
review the diff afterwards. The upstream
README has the
full threat model.

Status and verification boundary

The discovery and configuration instructions were checked against UE 5.8.4 and UE 5.9 Preview source and base configuration. See Epic’s 5.8 MCP reference and 5.9 MCP reference. For this version, an end-to-end Harness installation and read-only call against the editor still need verification. The changelog records automated checks and earlier live results.

Repository layout

Path Purpose
package.json Package manifest: dsh.bundle.patch, dsh.client (browser half and its inject modules), exports["./client"], and the engines.dsh compatibility range.
cordis.patch.yml Bundle patch layer: inserts the unreal-engine-skills row and the unreal-mcp row (whose url defaults to UNREAL_MCP_URL via a !!js expression).
lib/index.js Host half: skill registration from skills/, Unreal project detection and system-prompt context injection, the volatile Config (port, path) and the url sync.
lib/client.js Browser half: a hand-written __ModuleLoader__.load bundle (no build step) rendering the port form on the bundle page and the "Configure" entry on the unreal-mcp row.
skills/ The three skills' SKILL.md files and the unreal-mcp reference documents (setup.md, operations.md).
locale/ Localization dictionaries.
docs/publishing.md Release, npm and plugin-market submission steps.
LICENSE, THIRD_PARTY_NOTICES.md License and upstream attribution.

Related projects

  • EpicGames/unreal-engine-skills-for-claude-code-plugin
    — the upstream Claude Code plugin (MIT). This repository is a port of it.
  • PeterTXPan/dsh-unreal-mcp — another unofficial
    DeepSeek Harness bundle for the Unreal MCP server, independently maintained. This project
    differs in its plugin-page port form with hot reload and its targeting of the current 0.2.x
    Harness line; the two can be evaluated independently.

Development

There is no build step. Repo conventions (version bump, documentation sync, verification scope) are
in AGENTS.md; changes are recorded in CHANGELOG.md. Publishing and
marketplace steps are in docs/publishing.md.

Run pnpm install --frozen-lockfile --ignore-scripts, then pnpm test. The tests use Node's built-in
runner and do not compile code. The CI workflow runs the same checks on Node 22 and 24; its remote
result must be checked after pushing.

License

MIT © 2026 liuli-zsl. Adapted skill material retains Epic Games' MIT notice; see
THIRD_PARTY_NOTICES.md. Unreal Engine is a trademark of Epic Games, Inc.
This project is unofficial and is not affiliated with or endorsed by Epic Games.

Reviews (0)

No results found