unreal-engine-mcp-server 0.5.17 → 0.5.18

package/CHANGELOG.md

@@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## 🏷️ [0.5.18] - 2026-02-21
+
+> [!IMPORTANT]
+> ### 🔧 Installation, Documentation & Dependency Updates
+> This release fixes npm install failures when downloading from GitHub releases, adds first-time project setup guidance, and updates dependencies.
+
+### 🛠️ Fixed
+
+<details>
+<summary><b>🐛 npm install failure from release archives</b> (<a href="https://github.com/ChiR24/Unreal_mcp/pull/215">#215</a>)</summary>
+
+| Issue | Root Cause | Fix |
+|-------|------------|-----|
+| `npm install` fails with ESLint config error | Release archives excluded `eslint.config.mjs` and other build files | Added `-source` archives with complete build files |
+| `prepare` script runs build unnecessarily | Checked only `dist/` existence, not build artifacts | Now verifies `dist/cli.js` and `dist/index.js` exist |
+| Deprecated `--ext .ts` flag in lint | ESLint 9.x removed support for `--ext` flag | Removed flag, extensions configured in `eslint.config.mjs` |
+
+**Files Modified:**
+- `package.json` (prepare script, lint scripts, removed prebuild)
+- `.github/workflows/release.yml` (added source archives, fixed plugin path)
+- `README.md` (added Rust/wasm-pack prerequisites)
+
+</details>
+
+### 📚 Documentation
+
+<details>
+<summary><b>📖 First-time project open instructions</b> (<a href="https://github.com/ChiR24/Unreal_mcp/commit/112df08">112df08</a>)</summary>
+
+Added guidance for users opening Unreal projects for the first time:
+- Explains UE prompt to rebuild missing modules
+- Documents expected plugin load failure after first rebuild
+- Recommends closing and reopening project to resolve
+
+</details>
+
+### ⬆️ Dependencies
+
+| Package | From | To | PR |
+|---------|------|-----|-----|
+| hono | 4.11.7 | 4.12.0 | [#213](https://github.com/ChiR24/Unreal_mcp/pull/213) |
+| ajv | 8.17.1 | 8.18.0 | [#210](https://github.com/ChiR24/Unreal_mcp/pull/210) |
+| actions/stale | 10.1.1 | 10.2.0 | [#208](https://github.com/ChiR24/Unreal_mcp/pull/208) |
+| actions/dependency-review-action | 4.8.2 | 4.8.3 | [#212](https://github.com/ChiR24/Unreal_mcp/pull/212) |
+
+---
+
 ## 🏷️ [0.5.17] - 2026-02-16
 
 > [!IMPORTANT]

package/README.md

@@ -99,6 +99,8 @@ Regenerate project files after copying.
 
 https://github.com/user-attachments/assets/d8b86ebc-4364-48c9-9781-de854bf3ef7d
 
+> ⚠️ **First-Time Project Open:** When opening the project directly (double-click `.uproject`) for the first time, UE will prompt *"Would you like to rebuild them now?"* for missing modules. Click **Yes** to rebuild. After the rebuild completes, you may still see: *"Plugin 'McpAutomationBridge' failed to load because module could not be loaded."* This is expected — UE rebuilds successfully but doesn't reload the plugin in the same session. **Simply close and reopen the project** and the plugin will load correctly. Alternatively, build via Visual Studio first to avoid this.
+
 ### Step 3: Enable Required Plugins
 
 Enable via **Edit → Plugins**, then restart the editor:
@@ -253,9 +255,12 @@ Optional WASM acceleration for computationally intensive operations. **Enabled b
 
 ### Building WASM (Optional)
 
+**Prerequisites:**
+1. Install Rust: https://rust-lang.org/tools/install/
+2. Install wasm-pack: `cargo install wasm-pack`
+
 ```bash
-cargo install wasm-pack  # Once per machine
-npm run build:wasm       # Builds  WASM
+npm run build:wasm       # Builds WASM
 ```
 
 To disable: `WASM_ENABLED=false`

package/dist/index.js

@@ -29,7 +29,7 @@ const DEFAULT_SERVER_NAME = typeof packageInfo.name === 'string' && packageInfo.
     : 'unreal-engine-mcp';
 const DEFAULT_SERVER_VERSION = typeof packageInfo.version === 'string' && packageInfo.version.trim().length > 0
     ? packageInfo.version
-    : '0.5.16';
+    : '0.5.18';
 function routeStdoutLogsToStderr() {
     if (!config.MCP_ROUTE_STDOUT_LOGS) {
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unreal-engine-mcp-server",
-  "version": "0.5.17",
+  "version": "0.5.18",
   "mcpName": "io.github.ChiR24/unreal-engine-mcp",
   "description": "A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via native automation bridge. Built with TypeScript and designed for game development automation.",
   "type": "module",
@@ -19,17 +19,17 @@
   ],
   "scripts": {
     "build:core": "tsc -p tsconfig.json",
-    "build": "npm run build:core && (npm run build:wasm || echo \"WASM build failed or wasm-pack missing; continuing with TypeScript-only build. To enable WASM, install wasm-pack and re-run npm run build.\")",
+    "build": "npm run clean && npm run build:core && (npm run build:wasm || echo \"WASM build failed or wasm-pack missing; continuing with TypeScript-only build. To enable WASM, install wasm-pack and re-run npm run build.\")",
     "build:watch": "tsc -p tsconfig.json --watch",
     "start": "node dist/cli.js",
     "dev": "ts-node-esm src/cli.ts",
-    "lint": "echo \"Lint: typescript/javascript, C, C++, C#\" && eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
+    "lint": "echo \"Lint: typescript/javascript, C, C++, C#\" && eslint .",
+    "lint:fix": "eslint . --fix",
     "lint:cpp": "echo \"Running C/C++ lint (cpplint)\" && (python -m cpplint --recursive plugins || echo 'cpplint not found; skipping C/C++ lint')",
     "lint:c": "echo \"Running C lint (cpplint)\" && (python -m cpplint --recursive plugins || echo 'cpplint not found; skipping C lint')",
     "lint:csharp": "echo \"Running C# lint (dotnet format)\" && (dotnet tool run dotnet-format --verify-no-changes || echo 'dotnet-format not available or formatting required; skipping C# lint')",
     "clean": "rimraf dist",
-    "prepare": "npm run build",
+    "prepare": "node -e \"const fs=require('fs');(fs.existsSync('dist')&&fs.existsSync('dist/cli.js')&&fs.existsSync('dist/index.js'))||require('child_process').execSync('npm run build',{stdio:'inherit'})\"",
     "automation:sync": "node scripts/sync-mcp-plugin.js",
     "clean:tmp": "node scripts/clean-tmp.js",
     "test": "node tests/integration.mjs",
@@ -39,8 +39,7 @@
     "test:all": "node tests/integration.mjs",
     "test:smoke": "node --loader ts-node/esm scripts/smoke-test.ts",
     "build:wasm": "echo 'Building WebAssembly module...' && cd wasm && wasm-pack build --target web --out-dir ../src/wasm/pkg && cd .. && node scripts/patch-wasm.js",
-    "type-check": "tsc --noEmit",
-    "prebuild": "npm run lint && npm run clean"
+    "type-check": "tsc --noEmit"
   },
   "engines": {
     "node": ">=18"

package/server.json

@@ -2,13 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.ChiR24/unreal-engine-mcp",
   "description": "MCP server for Unreal Engine 5 with 17 tools for game development automation.",
-  "version": "0.5.17",
+  "version": "0.5.18",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "unreal-engine-mcp-server",
-      "version": "0.5.17",
+      "version": "0.5.18",
       "transport": {
         "type": "stdio"
       },