dsh-unreal-engine-skills
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.
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) andunreal-skill(author UE Agent Skills inside the
editor), registered fromskills/. - The Unreal MCP connection. A
unreal-mcprow using@deepseek-ai/dsh-mcp-clientconnects to
the editor'sModelContextProtocolserver (defaulthttp://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.uprojectorGenerateProjectFiles.*).
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 inpackage.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 withdsh 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.
- Check that Unreal MCP is enabled and enable All Toolsets (or the individual toolset plugins you need). Restart the editor if prompted.
- 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.inisection for each version. - 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-skillsrow. Saving goes through Harness settings (settings.mutate→configEditor.edit); the host half then synchronizes theunreal-mcprow'surltohttp://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/mcpset before starting
Harness. It is process-wide (restart required) and always takes precedence over the form. - Custom transport guard. If you change the
unreal-mcprow to a stdio proxy
(transport: stdiowithcommand/args), the port sync leaves that row untouched. - Patch entry caveat. In a profile patch, an entry with the same
idreplaces the row's
config instead of merging. A hand-written patch must repeatserverName/transport/url;
writing onlyurlfails 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 withhmr.executing.exit()and runs on the HMR queue
(HMR transactions cannot be nestedis 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, includingProgrammaticToolset.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)
Sign in to leave a review.
Leave a reviewNo results found