Preface

DeepSeek Harness (DSH) manages plugin layers by profile. To use ForgeaX game tools within a DSH session, you need to attach the published @forgeax/game MCP server, the bundled ForgeaX Skills, and the workspace guard to the same profile. Manually assembling the configuration can easily lead to missing tool names, service names, or skill registrations.

@forgeax/dsh-game is a DSH bundle designed for this scenario: once installed into a named profile, it integrates the @forgeax/game MCP server, its bundled ForgeaX Skills, and the workspace guard into the DSH session.

What This Is

  • Package name: @forgeax/dsh-game
  • GitHub repository path: https://github.com/ForgeaX-Games/forgeax-dsh-game-plugin
  • License: MIT
  • Purpose: A DSH bundle that integrates the @forgeax/game MCP server, its bundled ForgeaX Skills, and the workspace guard into a DSH profile.

It is a pure JS bundle, contains no game logic, and does not include a copy of ForgeaX. It parses and validates the published @forgeax/game, publishes the forgeaxGameLaunch service, which is then used by the DSH session.

Core Features

Below are the main capabilities it provides:

  1. Integrates the published @forgeax/game MCP server into the DSH session.

  2. Registers the forgeax-game and the forgeax-engine-* skills parsed from the bundled package.

  3. Exposes two tools:

mcp__forgeax__forgeax_status_lite
mcp__forgeax__forgeax_run_current_game

  1. Provides a workspace guard: rejects calls to mcp__forgeax__* where target_dir does not equal the current session’s cwd.

  2. Parses and validates @forgeax/game, and publishes the forgeaxGameLaunch service.

Pre-installation Checks

First, ensure the environment meets the requirements:

  1. The platform is macOS arm64, Linux x64, or Windows x64. Intel Mac, ARM Linux, and ARM Windows are installable but will fail at runtime startup.

  2. pnpm is in the PATH. If pnpm is missing, dsh plugin will exit with code 127.

  3. Node version is ≥ 22.

  4. Have a named profile ready. --profile is required; DSH has no implicit default profile.

Also check the trust boundary: this bundle parses and validates @forgeax/game and integrates related subprocesses in the DSH session. Treat it as a local component running with the current dsh process’s permissions; review the source code and license before installation.

According to verified information, this bundle does not read, store, or log API keys, tokens, or secret values; subprocesses start with env: {}, and DSH clears the parent environment before merging config.env.

Installation and Enabling

Install into a named profile:

dsh plugin --profile web add @forgeax/dsh-game

If multiple profiles need to use it, repeat this command for each profile.

After installation, restart dsh:

dsh --profile web

Bundle layers are read only once at startup; newly added bundles do not take effect until the next startup.

Typical Usage

Querying ForgeaX Status

After starting dsh --profile web, request the ForgeaX status in the session. The model should call:

mcp__forgeax__forgeax_status_lite

Note that DSH MCP only bridges tools, not resources; forgeax://status is not accessible in DSH sessions.

Running the Current Game

Among the tools exposed by this bundle is:

mcp__forgeax__forgeax_run_current_game

This can be called within a DSH session as the entry point for running a ForgeaX game.

One-off Operations Still Use CLI

One-off ForgeaX operations still use the CLI:

forgeax-game <init|use|doctor|devkit|upgrade>

Configuration Modifications

If you need to modify a line inserted by the bundle, you must insert a line with the same ID in the profile’s user patch file. For example, to modify:

id: forgeax-game.mcp-client
field: toolCallTimeoutMs

Refer to DSH profile patch rules for the specific patch syntax; restart dsh after modification for changes to take effect.

Use Cases and Notes

Suitable for these scenarios:

  • Need to call ForgeaX game tools within a DSH session.
  • Want to consolidate the @forgeax/game MCP server, ForgeaX Skills, and workspace guard into a single profile.
  • Want to avoid manually maintaining duplicate Skills installations in DSH.

Usage notes:

  1. Does not support transitive bundles. Only packages directly listed in dsh.profile.bundles contribute patch layers; other packages depending on this bundle do not automatically inherit its lines.

  2. Do not run forgeax-game devkit install. This bundle registers Skills directly; running the installer will only leave duplicate copies that DSH does not read.

  3. The workspace guard allows mcp__forgeax__* calls where session cwd cannot be obtained (e.g., Code Mode, nested dispatch) after an existence check and informs the model that it was not fully checked.

  4. DSH sessions only expose tools; do not rely on resources like forgeax://status.

  5. Environment passing is governed by DSH subprocess configuration: subprocesses start with env: {}, then merge config.env.

Conclusion

The value of @forgeax/dsh-game lies in integrating the @forgeax/game MCP server, ForgeaX Skills, and workspace guard into a DSH profile, enabling DSH sessions to call mcp__forgeax__forgeax_status_lite and mcp__forgeax__forgeax_run_current_game.

GitHub repository: https://github.com/ForgeaX-Games/forgeax-dsh-game-plugin

Directory page: Verified information does not include a directory page URL; to install from the DSH community directory, search by the package name @forgeax/dsh-game.