diff --git a/MCPForUnity/Runtime/Helpers/UnityFindObjectsCompat.cs.meta b/MCPForUnity/Runtime/Helpers/UnityFindObjectsCompat.cs.meta
index 195437795..f72eb3e0e 100644
--- a/MCPForUnity/Runtime/Helpers/UnityFindObjectsCompat.cs.meta
+++ b/MCPForUnity/Runtime/Helpers/UnityFindObjectsCompat.cs.meta
@@ -1,2 +1,11 @@
fileFormatVersion: 2
-guid: 7c3a9f12e4b60438d9a1c52ef8d07b3e
\ No newline at end of file
+guid: 7c3a9f12e4b60438d9a1c52ef8d07b3e
+MonoImporter:
+ externalObjects: {}
+ serializedVersion: 2
+ defaultReferences: []
+ executionOrder: 0
+ icon: {instanceID: 0}
+ userData:
+ assetBundleName:
+ assetBundleVariant:
diff --git a/README.md b/README.md
index cff6d256d..77358a498 100644
--- a/README.md
+++ b/README.md
@@ -1,46 +1,24 @@
-
+
+
+
+
-| [English](README.md) | [简体中文](docs/i18n/README-zh.md) |
-|----------------------|---------------------------------|
+
-#### Proudly sponsored and maintained by [Aura](https://www.tryaura.dev/) — the AI assistant for Unreal & Unity.
-##### And don't miss [Godot AI](https://github.com/hi-godot/godot-ai), the new open source MCP/AI project from the makers of MCP for Unity.
-
-[](https://coplaydev.github.io/unity-mcp/)
-[](https://discord.gg/y4p8KfzrN4)
-[](https://www.coplay.dev/?ref=unity-mcp)
-[](https://unity.com/releases/editor/archive)
-[](https://www.python.org)
-[](https://modelcontextprotocol.io/introduction)
-[](https://opensource.org/licenses/MIT)
-
-**Create your Unity apps with LLMs.** MCP for Unity bridges AI assistants — Claude, Codex, VS Code, local LLMs, and more — with your Unity Editor via the [Model Context Protocol](https://modelcontextprotocol.io/introduction). Give your LLM the tools to manage assets, control scenes, edit scripts, run tests, and automate workflows.
-
-
-
----
-
-## Read the Docs
-
-### **→ [coplaydev.github.io/unity-mcp](https://coplaydev.github.io/unity-mcp/)**
-
----
-
-## Install
-
-In Unity: **Window → Package Manager → + → Add package from git URL**, paste:
-
-```text
-https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
-```
+[English](README.md)
[简体中文](docs/i18n/README-zh.md) | [Discord](https://discord.gg/y4p8KfzrN4)
[Wiki](https://coplaydev.github.io/unity-mcp/)
-Beta channel uses `#beta`. Asset Store and OpenUPM paths are documented in the [Install guide](https://coplaydev.github.io/unity-mcp/getting-started/install).
+#### Proudly sponsored and maintained by [Aura](https://www.tryaura.dev/) — the AI assistant for Unreal & Unity.
+##### And don't miss [Godot AI](https://github.com/hi-godot/godot-ai), the new open source project from the makers of MCP for Unity.
-Then **Window → MCP for Unity → Configure All Detected Clients**. That's it — try a prompt:
+
Create your Unity apps with LLMs. MCP for Unity bridges AI assistants — Claude, Codex, VS Code, local LLMs, and more — with your Unity Editor via Model Context Protocol . Give your LLM the tools to manage assets, control scenes, edit scripts, run tests, and automate your game dev workflows.
-Full walkthrough: [Your First Prompt](https://coplaydev.github.io/unity-mcp/getting-started/first-prompt).
+
+
---
@@ -61,6 +39,25 @@ Full history: [Release Notes](https://coplaydev.github.io/unity-mcp/releases).
---
+## What it does
+
+Control the Unity Editor in natural language from any MCP client — create scenes & GameObjects, edit C# scripts, manage assets, run tests, profile, and build. 40+ focused tools, any client, free & MIT.
+
+**[Browse the full tool catalog →](https://coplaydev.github.io/unity-mcp/reference/tools/)**
+
+---
+
+## Quickstart
+
+**Requirements:** Unity **2021.3 LTS → 6.x** · Python **3.10+** (via [`uv`](https://docs.astral.sh/uv/)). Works with **any MCP client** — Claude Desktop & Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, and more.
+
+1. **Install** — Unity → Package Manager → Add from git URL:
+ `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta` _(or `openupm add com.coplaydev.unity-mcp`)_
+2. **Configure** — `Window → MCP for Unity → Configure All Detected Clients`.
+3. **Prompt** — *"Create a cube at the origin and add a Rigidbody."* The cube appears in seconds.
+
+---
+
## AI Asset Generation
Bring-your-own-key generation of **3D models** (text→3D and image→3D), **2D images**, and **Sketchfab** model import — straight into your project. Generated assets land under `Assets/Generated/`.
diff --git a/Server/README.md b/Server/README.md
index 581380a9f..470d09758 100644
--- a/Server/README.md
+++ b/Server/README.md
@@ -4,6 +4,8 @@
[](https://www.python.org)
[](https://opensource.org/licenses/MIT)
[](https://discord.gg/y4p8KfzrN4)
+[](https://pypi.org/project/mcpforunityserver/)
+[](https://pepy.tech/project/mcpforunityserver)
Model Context Protocol server for Unity Editor integration. Control Unity through natural language using AI assistants like Claude, Cursor, and more.
@@ -271,7 +273,7 @@ Once connected, try these commands in your AI assistant:
For complete documentation, troubleshooting, and advanced usage:
-📖 **[Full Documentation](https://github.com/CoplayDev/unity-mcp#readme)**
+📖 **[Full Documentation](https://coplaydev.github.io/unity-mcp/)**
---
diff --git a/Server/pyproject.toml b/Server/pyproject.toml
index 569ec6dd6..1b7889450 100644
--- a/Server/pyproject.toml
+++ b/Server/pyproject.toml
@@ -47,8 +47,11 @@ dev = [
]
[project.urls]
+Homepage = "https://coplaydev.github.io/unity-mcp/"
+Documentation = "https://coplaydev.github.io/unity-mcp/"
Repository = "https://github.com/CoplayDev/unity-mcp.git"
Issues = "https://github.com/CoplayDev/unity-mcp/issues"
+Changelog = "https://github.com/CoplayDev/unity-mcp/releases"
[project.scripts]
mcp-for-unity = "main:main"
diff --git a/Server/uv.lock b/Server/uv.lock
index 585a83c2b..3eaa003ee 100644
--- a/Server/uv.lock
+++ b/Server/uv.lock
@@ -858,7 +858,7 @@ wheels = [
[[package]]
name = "mcpforunityserver"
-version = "9.7.1"
+version = "9.7.3"
source = { editable = "." }
dependencies = [
{ name = "click" },
diff --git a/TestProjects/UnityMCPTests/Assets/Tests/EditMode/Services/TestJobManagerInitTimeoutTests.cs.meta b/TestProjects/UnityMCPTests/Assets/Tests/EditMode/Services/TestJobManagerInitTimeoutTests.cs.meta
index 663e2f94c..12d1c8c5f 100644
--- a/TestProjects/UnityMCPTests/Assets/Tests/EditMode/Services/TestJobManagerInitTimeoutTests.cs.meta
+++ b/TestProjects/UnityMCPTests/Assets/Tests/EditMode/Services/TestJobManagerInitTimeoutTests.cs.meta
@@ -1,2 +1,11 @@
fileFormatVersion: 2
-guid: e0b6718bcbe94429595354c108865f67
\ No newline at end of file
+guid: e0b6718bcbe94429595354c108865f67
+MonoImporter:
+ externalObjects: {}
+ serializedVersion: 2
+ defaultReferences: []
+ executionOrder: 0
+ icon: {instanceID: 0}
+ userData:
+ assetBundleName:
+ assetBundleVariant:
diff --git a/docs/i18n/README-zh.md b/docs/i18n/README-zh.md
index 420d4fb98..fddee9959 100644
--- a/docs/i18n/README-zh.md
+++ b/docs/i18n/README-zh.md
@@ -1,116 +1,65 @@
-
+
+
+
+
-| [English](../../README.md) | [简体中文](README-zh.md) |
-|----------------------|---------------------------------|
+
+
+[English](../../README.md)
[简体中文](README-zh.md) | [Discord](https://discord.gg/y4p8KfzrN4)
[Wiki](https://coplaydev.github.io/unity-mcp/)
#### 由 [Aura](https://www.tryaura.dev/) 荣誉赞助并维护 —— 面向 Unreal 与 Unity 的 AI 助手。
-##### 别错过 [Godot A](https://github.com/hi-godot/godot-ai)I 🤖，MCP for Unity 团队推出的全新开源 MCP/AI 项目！
+##### 别错过 [Godot AI](https://github.com/hi-godot/godot-ai) 🤖，MCP for Unity 团队推出的全新开源项目！
+
+
MCP for Unity 通过 Model Context Protocol 把 Claude、Cursor、VS Code、本地大模型等 AI 助手接入 Unity 编辑器，让它们直接帮你管理资源、搭场景、写脚本、跑测试，把开发流程里的重复活儿都包了。
-**用大语言模型创建你的 Unity 应用！** MCP for Unity 通过 [Model Context Protocol](https://modelcontextprotocol.io/introduction) 将 AI 助手（Claude、Cursor、VS Code 等）与你的 Unity Editor 连接起来。为你的大语言模型提供管理资源、控制场景、编辑脚本和自动化任务的工具。
+
+
-
最近更新
-更早的版本
+完整更新历史见 [发布说明](https://coplaydev.github.io/unity-mcp/releases)。
-* **v9.4.8** — 新编辑器 UI、通过 `manage_tools` 实时切换工具、技能同步窗口、多视图截图、一键 Roslyn 安装器、支持 Qwen Code 与 Gemini CLI 客户端、通过 `manage_probuilder` 进行 ProBuilder 网格编辑。
-* **v9.4.7** — 支持按调用路由 Unity 实例、修复 macOS pyenv PATH 问题、脚本工具的域重载稳定性提升。
-* **v9.4.6** — 新增 `manage_animation` 工具、支持 Cline 客户端、失效连接检测、工具状态跨重载持久化。
-* **v9.4.4** — 可配置 `batch_execute` 限制、按会话状态过滤工具、修复 IPv6/IPv4 回环问题。
-
-
---
-## 快速开始
-
-### 前置要求
-
-* **Unity 2021.3 LTS+** — [下载 Unity](https://unity.com/download)
-* **Python 3.10+** 和 **uv** — [安装 uv](https://docs.astral.sh/uv/getting-started/installation/)
-* **一个 MCP 客户端** — [Claude Desktop](https://claude.ai/download) | [Cursor](https://www.cursor.com/en/downloads) | [VS Code Copilot](https://code.visualstudio.com/docs/copilot/overview) | [GitHub Copilot CLI](https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli) | [OpenClaw](https://openclaw.ai)
-
-### 1. 安装 Unity 包
-
-在 Unity 中：`Window > Package Manager > + > Add package from git URL...`
-
-> [!TIP]
-> ```text
-> https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
-> ```
-
-**想要最新的 beta 版本？** 使用 beta 分支：
-```text
-https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta
-```
-
-
-其他安装方式（Asset Store、OpenUPM）
-
-**Unity Asset Store：**
-1. 访问 [Asset Store 上的 MCP for Unity](https://assetstore.unity.com/packages/tools/generative-ai/mcp-for-unity-ai-driven-development-329908)
-2. 点击 `Add to My Assets`，然后通过 `Window > Package Manager` 导入
-
-**OpenUPM：**
-```bash
-openupm add com.coplaydev.unity-mcp
-```
-
-
-### 2. 启动服务器并连接
+## 它能做什么
-1. 在 Unity 中：`Window > MCP for Unity`
-2. 点击 **Start Server**（会在 `localhost:8080` 启动 HTTP 服务器）
-3. 从下拉菜单选择你的 MCP Client，然后点击 **Configure**
-4. 查找 🟢 "Connected ✓"
-5. **连接你的客户端：** 一些客户端（Cursor、Antigravity 2.0、Antigravity IDE、OpenClaw）需要在设置里启用 MCP 开关或插件。Antigravity 2.0 与 Antigravity IDE 是分开列出的：Antigravity 2.0 已迁移到 `~/.gemini/config/`，而 Antigravity IDE 仍使用 `~/.gemini/antigravity-ide/`；如果两者都在使用，请分别配置。OpenClaw 还需要启用 `openclaw-mcp-bridge` 插件，并会跟随 MCP for Unity 当前选择的传输方式（HTTP 或 stdio）；另一些（Claude Desktop、Claude Code）在配置后会自动连接。
+用自然语言从任意 MCP 客户端操作 Unity 编辑器：搭场景、建 GameObject、写改 C# 脚本、调材质和着色器、跑测试、看性能、出包。40+ 个工具，任意客户端可用，免费、MIT 开源。
-**就这些！** 试试这样的提示词：*"Create a red, blue and yellow cube"* 或 *"Build a simple player controller"*
+**[查看完整工具目录 →](https://coplaydev.github.io/unity-mcp/reference/tools/)**
---
-
-功能与工具
+1. **安装** —— 在 Unity 里打开 Package Manager，从 git URL 添加：
+ `https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta` _(也可以用 `openupm add com.coplaydev.unity-mcp`)_
+2. **配置客户端** —— `Window → MCP for Unity → Configure All Detected Clients`，一键搞定所有检测到的客户端。
+3. **发个提示试试** —— *"在原点放一个立方体，加个 Rigidbody。"* 立方体几秒就出现在场景里了。
手动配置
+---
+
多个 Unity 实例
-Roslyn 脚本验证（高级） Roslyn 脚本验证（进阶）
- 手动 DLL 安装（如果 NuGetForUnity 不可用）
+ 手动安装 DLL（NuGetForUnity 用不了时）
- 1. 从 [NuGet](https://www.nuget.org/packages/Microsoft.CodeAnalysis.CSharp/) 下载 `Microsoft.CodeAnalysis.CSharp.dll` 及其依赖项
- 2. 将 DLL 放到 `Assets/Plugins/` 目录
- 3. 确保 .NET 兼容性设置正确
- 4. 在 Scripting Define Symbols 中添加 `USE_ROSLYN`
+ 1. 从 [NuGet](https://www.nuget.org/packages/Microsoft.CodeAnalysis.CSharp/) 下载 `Microsoft.CodeAnalysis.CSharp.dll` 及其依赖
+ 2. 把 DLL 放进 `Assets/Plugins/`
+ 3. 确认 .NET 兼容性设置正确
+ 4. 在 Scripting Define Symbols 里加上 `USE_ROSLYN`
5. 重启 Unity
@@ -197,35 +148,35 @@ MCP for Unity 支持多个 Unity Editor 实例。要将操作定向到某个特
故障排除
-贡献 参与贡献
遥测与隐私
---
-**许可证：** MIT — 查看 [LICENSE](../../LICENSE) | **需要帮助？** [Discord](https://discord.gg/y4p8KfzrN4) | [Issues](https://github.com/CoplayDev/unity-mcp/issues)
+**许可证：** MIT —— 见 [LICENSE](../../LICENSE) | **需要帮助？** [Discord](https://discord.gg/y4p8KfzrN4) | [Issues](https://github.com/CoplayDev/unity-mcp/issues)
---
@@ -234,8 +185,8 @@ MCP for Unity 支持多个 Unity Editor 实例。要将操作定向到某个特
[](https://www.star-history.com/#CoplayDev/unity-mcp&Date)
-研究引用 论文引用
+
+
+
diff --git a/docs/images/logo-header-dark.png b/docs/images/logo-header-dark.png
new file mode 100644
index 000000000..74ae94b69
Binary files /dev/null and b/docs/images/logo-header-dark.png differ
diff --git a/docs/images/logo-header-light.png b/docs/images/logo-header-light.png
new file mode 100644
index 000000000..19641d9db
Binary files /dev/null and b/docs/images/logo-header-light.png differ
diff --git a/docs/images/logo.png b/docs/images/logo.png
deleted file mode 100644
index 142983992..000000000
Binary files a/docs/images/logo.png and /dev/null differ
diff --git a/docs/wiki/V10.md b/docs/wiki/V10.md
new file mode 100644
index 000000000..8dd68aba4
--- /dev/null
+++ b/docs/wiki/V10.md
@@ -0,0 +1,233 @@
+# MCP for Unity v10 Release Candidate Notes
+
+These notes cover the v10 release candidate: the full major-version change from
+v9.0.0, the new AI asset generation/import surface, secure provider-key storage,
+Blender/local-file handoff, and the README/docs/brand refresh.
+
+For this comparison, **v9 means `v9.0.0`**, not the last v9 patch. The `v9.7.3`
+tag is still useful for the release-to-release changelog, but it already
+contains much of the v9 tool expansion.
+
+## What changed since v9.0.0
+
+At `v9.0.0`, MCP for Unity exposed 29 MCP tool entrypoints around the core Unity
+Editor loop: scenes, GameObjects, components, scripts, prefabs, assets,
+materials, shaders, VFX, console reads, editor refresh, async tests, custom
+tools, and batch execution.
+
+The v10 release candidate exposes 47 MCP tool entrypoints across 10 groups:
+`core`, `animation`, `asset_gen`, `docs`, `probuilder`, `profiling`,
+`scripting_ext`, `testing`, `ui`, and `vfx`.
+
+| Area | `v9.0.0` baseline | v10 release candidate |
+| --- | --- | --- |
+| Tool catalog | 29 MCP tool entrypoints, with most tools registered directly into one visible surface. | 47 MCP tool entrypoints across grouped domains. |
+| Tool visibility | No decorator-level group metadata and no `manage_tools` workflow for user-controlled visibility. | Tool registry has named groups; `core` is enabled by default and non-core groups are opt-in. |
+| Editor automation domains | Core scene/object/component/script/asset/prefab/material/shader/VFX/test/editor operations. | Adds build orchestration, camera/Cinemachine control, render pipeline and graphics operations, package management, physics, animation, UI Toolkit, profiling, ProBuilder, and procedural texture generation. |
+| Asset creation/import | Existing asset management and VFX/shader/script tools could create or modify project content, but external generation providers were not part of the product surface. | Adds the `asset_gen` group for Tripo/Meshy model generation, fal.ai/OpenRouter image generation, Sketchfab import, and local FBX/OBJ/glTF handoff from tools such as Blender. |
+| API lookup and docs | API discovery depended on external docs or local project inspection. | Adds `unity_docs` and `unity_reflect`, plus generated tool/resource reference docs. |
+| Safety model | Core tool execution, custom tools, async test polling, and instance routing were present. | Adds group-gated high-power tools, secure provider-key storage in Unity, project-scoped import hardening, archive/path validation, and more test coverage around transport, tool registry, provider adapters, and Unity compatibility. |
+| Editor UI and docs | The window focused on connection/client setup and the docs grew around accumulated features. | Adds tool/resource visibility flows, Asset Gen setup, glTFast dependency guidance, refreshed README/docs navigation, icons/social assets, and consistent "MCP for Unity" product naming. |
+
+Added MCP tool entrypoints since `v9.0.0`: `execute_code`,
+`generate_image`, `generate_model`, `import_model`, `import_model_file`,
+`manage_animation`, `manage_build`, `manage_camera`, `manage_graphics`,
+`manage_packages`, `manage_physics`, `manage_probuilder`, `manage_profiler`,
+`manage_texture`, `manage_tools`, `manage_ui`, `unity_docs`, and
+`unity_reflect`.
+
+## What v10 is about
+
+1. **A larger grouped tool surface** - the catalog grows from 29 to 47 MCP tool
+ entrypoints, with high-power domains split into opt-in groups.
+2. **Asset generation and import** - first-class MCP tools for generating 3D
+ models, generating 2D images, importing marketplace models, and handing off
+ local files from tools like Blender.
+3. **Safer agent operations** - provider keys stay in the Unity Editor, tools
+ are opt-in by group, long-running jobs are explicit and pollable, and file
+ writes are constrained to project assets.
+4. **Clearer product surface** - refreshed README, docs site, branding, and
+ distribution metadata.
+5. **Release confidence** - Python tests, Unity compile checks, docs builds, and
+ compatibility shims for the wide Unity support window.
+
+## AI Asset Generation
+
+The headline v10 feature is the new `asset_gen` tool group. It is disabled by
+default like other non-core tool groups, and can be enabled with `manage_tools`.
+
+| Tool | Purpose |
+| --- | --- |
+| `generate_model` | Generate 3D models from text or image prompts through providers such as Tripo and Meshy. |
+| `generate_image` | Generate 2D images through providers such as fal.ai and OpenRouter. |
+| `import_model` | Search and import downloadable Sketchfab models. |
+| `import_model_file` | Import a local model file already on disk, such as an FBX/OBJ/glTF exported from Blender. |
+
+Generation and import jobs are asynchronous. A request returns a `job_id`, and
+the client polls `action="status"` until the job completes or fails.
+
+## Provider keys
+
+Asset providers are bring-your-own-key. Keys are entered in the Unity Editor's
+Asset Gen tab and stored in the operating system secure store:
+
+- macOS: Keychain
+- Windows: Credential Manager
+- Linux: libsecret / Secret Service compatible tooling
+
+Keys are not written to project assets, `EditorPrefs`, generated docs, or MCP
+tool parameters. The MCP client can request a generation job, but it does not
+receive provider credentials.
+
+## Local image inputs
+
+v10 distinguishes hosted image inputs from local project images:
+
+- `image_url` points at an externally hosted image.
+- `image_path` points at a local file, commonly under `Assets/`.
+
+Meshy image-to-3D and fal/OpenRouter image-to-image can accept local image files
+by sending the image data inline as a base64 data URI. Tripo image-to-3D still
+requires a hosted `image_url` until an upload flow is wired.
+
+## Blender handoff
+
+The `import_model_file` tool creates a clean boundary between DCC generation and
+Unity import:
+
+1. The modeling tool creates or exports the asset.
+2. MCP for Unity imports the file with `import_model_file`.
+3. The Unity agent uses existing scene, material, prefab, and build tools to wire
+ the asset into the project.
+
+This is a handoff, not MCP for Unity controlling Blender directly.
+
+## Safety model
+
+### Opt-in tool group
+
+`asset_gen` is not part of the default core tool set. Users must explicitly
+enable it with `manage_tools`.
+
+### Project-scoped imports
+
+Generated and imported assets resolve into the Unity project's `Assets/` folder,
+with traversal and unsafe paths rejected. Archives are extracted through
+allowlisted import paths and extensions rather than blindly writing every file
+a provider returns.
+
+### No hidden spend
+
+Generation calls go to third-party providers using the user's own API keys.
+
+- MCP for Unity does not bundle provider credits.
+- Provider pricing, rate limits, and content policies are controlled by the
+ provider.
+- Enable the tool group only when you intend to call generation or import
+ providers.
+
+## Docs and brand refresh
+
+v10 also updates the project front door:
+
+- README trimmed into a clearer front door.
+- Docs site reorganized around Getting Started, Guides, Reference,
+ Architecture, Contributing, Migrations, and Releases.
+- Tool reference pages are generated from the tool registry.
+- Distribution and analytics docs are explicit about what is measured and what
+ is not.
+- Branding now consistently uses **MCP for Unity** in user-facing UI and docs.
+
+## Compatibility posture
+
+v10 continues the existing compatibility promise:
+
+- Unity 2021.3 LTS remains the package floor.
+- Unity 6.x stays in the supported matrix.
+- Known Unity API changes route through compatibility helpers under
+ `MCPForUnity/Runtime/Helpers/`.
+- Contributors touching shims or version-gated APIs run
+ `tools/check-unity-versions.sh` against installed Unity Hub editors.
+
+## Upgrade notes from v9
+
+1. Update the Unity package to v10. During RC testing, use the `beta` branch.
+2. Reconfigure MCP clients if the package prompts you to.
+3. Install optional dependencies only when needed. GLB import uses glTFast; FBX
+ import does not require that package.
+4. Enable `asset_gen` explicitly with `manage_tools` before calling asset
+ generation tools.
+5. Add provider keys in Unity, not in MCP client config files.
+6. Keep generated assets under review before committing them.
+
+## What is intentionally not in v10
+
+- No hosted MCP for Unity asset-generation credits.
+- No guarantee that every provider supports every input mode.
+- No automatic BlenderMCP configuration from Unity.
+- No promise that provider-generated assets are production-ready without artist
+ review.
+- No change to the rule that non-core tool groups start disabled.
+
+## Final comparison
+
+**Major-version comparison**: https://github.com/CoplayDev/unity-mcp/compare/v9.0.0...v10.0.0
+
+**v9.7.3 patch comparison**: https://github.com/CoplayDev/unity-mcp/compare/v9.7.3...v10.0.0
+
+## Troubleshooting
+
+### `asset_gen` tools do not appear
+
+The `asset_gen` group is disabled by default. Enable it with `manage_tools`:
+
+```text
+manage_tools action=activate group=asset_gen
+```
+
+If the tools still do not appear, refresh/reconnect the MCP server in the client.
+Some clients cache tool lists until the server is restarted or refreshed.
+
+### Provider key missing
+
+Generation providers are bring-your-own-key. Add keys in Unity's **Asset Gen**
+tab. Do not place provider keys in MCP client config files, prompts, project
+assets, or generated docs.
+
+### GLB import fails or has missing geometry/materials
+
+GLB/glTF import depends on **glTFast**. Install it from the Dependencies tab or
+via Package Manager before importing GLB assets. FBX imports do not require
+glTFast.
+
+### Tripo image-to-3D rejects `image_path`
+
+Tripo image-to-3D currently needs a hosted `image_url`. Local `image_path` inputs
+are supported by Meshy image-to-3D and fal/OpenRouter image-to-image, where the
+image can be sent inline as a base64 data URI.
+
+### Generated or imported files are larger than expected
+
+Provider output can include large binary assets. Review generated files before
+committing them, keep generated output under `Assets/Generated/` when possible,
+and avoid committing experimental provider output that is not needed by the
+project.
+
+### Archive import is rejected
+
+Archive extraction is intentionally constrained. Provider archives may be
+rejected when they contain unsupported extensions, traversal paths, scripts, or
+files outside the import allowlist. Import the model again with a supported
+format or inspect the archive before bringing it into the Unity project.
+
+## Related docs
+
+- Tool groups: https://coplaydev.github.io/unity-mcp/guides/tool-groups
+- Asset generation tools: https://coplaydev.github.io/unity-mcp/reference/tools/asset_gen/
+- generate_model: https://coplaydev.github.io/unity-mcp/reference/tools/asset_gen/generate_model
+- generate_image: https://coplaydev.github.io/unity-mcp/reference/tools/asset_gen/generate_image
+- import_model: https://coplaydev.github.io/unity-mcp/reference/tools/asset_gen/import_model
+- import_model_file: https://coplaydev.github.io/unity-mcp/reference/tools/asset_gen/import_model_file
+- Tool reference: https://coplaydev.github.io/unity-mcp/reference/tools/
+- Unity compatibility shims: https://coplaydev.github.io/unity-mcp/architecture/unity-compat
+- Project roadmap: https://coplaydev.github.io/unity-mcp/architecture/project-roadmap
diff --git a/website/docs/architecture/external-analytics.md b/website/docs/architecture/external-analytics.md
new file mode 100644
index 000000000..c24d88f70
--- /dev/null
+++ b/website/docs/architecture/external-analytics.md
@@ -0,0 +1,57 @@
+---
+description: How MCP for Unity tracks adoption with cookieless, aggregate-only analytics — a public PyPI downloads badge plus a private, maintainer-only dashboard.
+---
+
+# External analytics
+
+## What is tracked and why
+
+MCP for Unity tracks adoption with several aggregate signals, ordered from most to least honest about *real users*:
+
+- **In-product DAU / WAU** — the true active-user count, deduplicated per anonymous install UUID by the in-product telemetry (`Server/src/core/telemetry.py`). Surfacing it on this dashboard needs a read API on the Coplay telemetry backend.
+- **Unique repo cloners / viewers (14-day)** — from the GitHub repository traffic API; a strong proxy for developers actually pulling the code. Only collaborators can read it (needs a token), so it is private by nature.
+- **GitHub stars / forks** — real accounts that starred or forked; public, an interest (not usage) signal.
+- **PyPI installs** — daily/weekly/monthly download counts for `mcpforunityserver` from the public [pypistats.org](https://pypistats.org/packages/mcpforunityserver) API. **Heavily inflated** by CI, mirrors, `uvx` re-fetches, and Docker rebuilds — an install-event *reach* number, not a user count. A downloads badge appears in the README.
+- **Docs traffic** — aggregate pageview totals from [GoatCounter](https://www.goatcounter.com/) when provisioned.
+
+All sources are **cookieless, store no personal data, and expose only aggregates**. The DAU/WAU source is the [in-product telemetry](./telemetry) that runs inside the Unity Editor and is controlled by the user from the MCP for Unity settings window.
+
+## What is public vs private
+
+- **Public:** the PyPI **downloads badge** in the README (download counts are public on PyPI regardless of what we do).
+- **Private (maintainer-only):** the unified install + docs-traffic **dashboard**. It is posted to the GitHub Actions run summary, which only repo collaborators can see. There is **no public stats page and no stats file published to the site**.
+
+## Privacy stance
+
+- No cookies, no fingerprinting, no user IDs.
+- No PII is transmitted or stored.
+- GoatCounter is a privacy-first analytics service; its [privacy policy](https://www.goatcounter.com/help/privacy) commits to not selling data. The GoatCounter dashboard should be kept **private** so traffic numbers stay maintainer-only.
+- The maintainer summary contains only counts and a timestamp.
+
+## How data flows
+
+1. A GitHub Actions workflow (`.github/workflows/stats.yml`) runs daily at 06:00 UTC, and on demand via **Run workflow**.
+2. `website/scripts/fetch-stats.mjs` fetches PyPI recent-download counts and, when GoatCounter secrets are present, the total pageview count.
+3. The script renders a Markdown table that the workflow appends to `$GITHUB_STEP_SUMMARY`.
+4. Collaborators read the numbers on the **Actions → Adoption stats** run page. Nothing is committed to the repo or published to the docs site.
+
+## Maintainer provisioning
+
+Stars, forks, and PyPI numbers work out of the box. The two highest-signal rows need setup:
+
+**Unique repo cloners / viewers (GitHub traffic):**
+
+1. Create a fine-grained PAT scoped to `CoplayDev/unity-mcp` with **Repository permissions → Administration: read** (the traffic API requires it; the default `GITHUB_TOKEN` returns 401/403).
+2. Add it as the repository **secret** `STATS_GITHUB_TOKEN`.
+
+**In-product DAU / WAU (the true active-user count):**
+
+- The data is already collected by `Server/src/core/telemetry.py` (deduplicated per anonymous install UUID) and POSTed to the Coplay telemetry backend. Surfacing it here needs a **read / aggregate API** on that backend plus a token — back-end work owned by Coplay. Once available, add a `COPLAY_STATS_TOKEN` secret and a fetch in `fetch-stats.mjs`.
+
+**Docs traffic (GoatCounter):**
+
+1. Create a free [goatcounter.com](https://www.goatcounter.com/) site (e.g. code `mcp-for-unity`); keep its dashboard **private**.
+2. Generate an API token with read access to stats.
+3. Add secrets `GOATCOUNTER_TOKEN` (token) and `GOATCOUNTER_SITE` (site code), and an **Actions variable** `GOATCOUNTER_CODE` (same site code) so the docs build injects the cookieless beacon — collection happens on the public site, the numbers stay private.
+
+Then run **Actions → Adoption stats → Run workflow**. The `stats` workflow needs only `contents: read` — it posts to the run summary and never commits.
diff --git a/website/docs/guides/roslyn.md b/website/docs/guides/roslyn.md
index 3f27a1a6e..be35cf51f 100644
--- a/website/docs/guides/roslyn.md
+++ b/website/docs/guides/roslyn.md
@@ -24,7 +24,7 @@ Most users don't need this. Enable it when:
The installer downloads the required NuGet packages, places the DLLs in `Assets/Plugins/Roslyn/`, and adds `USE_ROSLYN` to Scripting Define Symbols.
-You can also trigger it from the menu: **Window → MCP For Unity → Install Roslyn DLLs**.
+You can also trigger it from the menu: **Window → MCP for Unity → Install Roslyn DLLs**.
## Manual install (if the installer isn't available)
diff --git a/website/docs/migrations/v10.md b/website/docs/migrations/v10.md
new file mode 100644
index 000000000..80bd1f505
--- /dev/null
+++ b/website/docs/migrations/v10.md
@@ -0,0 +1,263 @@
+---
+title: v10 - Asset Generation and Docs Refresh
+author: MCP for Unity Maintainers
+date: 2026-06-30
+---
+
+# MCP for Unity v10 Release Candidate Notes
+
+These notes cover the v10 release candidate: the full major-version change from
+v9.0.0, the new AI asset generation/import surface, secure provider-key storage,
+Blender/local-file handoff, and the README/docs/brand refresh.
+
+For this comparison, **v9 means `v9.0.0`**, not the last v9 patch. The `v9.7.3`
+tag is still useful for the release-to-release changelog, but it already
+contains much of the v9 tool expansion.
+
+## What changed since v9.0.0
+
+At `v9.0.0`, MCP for Unity exposed 29 MCP tool entrypoints around the core Unity
+Editor loop: scenes, GameObjects, components, scripts, prefabs, assets,
+materials, shaders, VFX, console reads, editor refresh, async tests, custom
+tools, and batch execution.
+
+The v10 release candidate exposes 47 MCP tool entrypoints across 10 groups:
+`core`, `animation`, `asset_gen`, `docs`, `probuilder`, `profiling`,
+`scripting_ext`, `testing`, `ui`, and `vfx`.
+
+| Area | `v9.0.0` baseline | v10 release candidate |
+| --- | --- | --- |
+| Tool catalog | 29 MCP tool entrypoints, with most tools registered directly into one visible surface. | 47 MCP tool entrypoints across grouped domains. |
+| Tool visibility | No decorator-level group metadata and no `manage_tools` workflow for user-controlled visibility. | Tool registry has named groups; `core` is enabled by default and non-core groups are opt-in. |
+| Editor automation domains | Core scene/object/component/script/asset/prefab/material/shader/VFX/test/editor operations. | Adds build orchestration, camera/Cinemachine control, render pipeline and graphics operations, package management, physics, animation, UI Toolkit, profiling, ProBuilder, and procedural texture generation. |
+| Asset creation/import | Existing asset management and VFX/shader/script tools could create or modify project content, but external generation providers were not part of the product surface. | Adds the `asset_gen` group for Tripo/Meshy model generation, fal.ai/OpenRouter image generation, Sketchfab import, and local FBX/OBJ/glTF handoff from tools such as Blender. |
+| API lookup and docs | API discovery depended on external docs or local project inspection. | Adds `unity_docs` and `unity_reflect`, plus generated tool/resource reference docs. |
+| Safety model | Core tool execution, custom tools, async test polling, and instance routing were present. | Adds group-gated high-power tools, secure provider-key storage in Unity, project-scoped import hardening, archive/path validation, and more test coverage around transport, tool registry, provider adapters, and Unity compatibility. |
+| Editor UI and docs | The window focused on connection/client setup and the docs grew around accumulated features. | Adds tool/resource visibility flows, Asset Gen setup, glTFast dependency guidance, refreshed README/docs navigation, icons/social assets, and consistent "MCP for Unity" product naming. |
+
+Added MCP tool entrypoints since `v9.0.0`: `execute_code`,
+`generate_image`, `generate_model`, `import_model`, `import_model_file`,
+`manage_animation`, `manage_build`, `manage_camera`, `manage_graphics`,
+`manage_packages`, `manage_physics`, `manage_probuilder`, `manage_profiler`,
+`manage_texture`, `manage_tools`, `manage_ui`, `unity_docs`, and
+`unity_reflect`.
+
+## What v10 is about
+
+v10 is organized around five concrete changes:
+
+1. **A larger grouped tool surface** - the catalog grows from 29 to 47 MCP tool
+ entrypoints, with high-power domains split into opt-in groups.
+2. **Asset generation and import** - first-class MCP tools for generating 3D
+ models, generating 2D images, importing marketplace models, and handing off
+ local files from tools like Blender.
+3. **Safer agent operations** - provider keys stay in the Unity Editor, tools
+ are opt-in by group, long-running jobs are explicit and pollable, and file
+ writes are constrained to project assets.
+4. **Clearer product surface** - refreshed README, docs site, branding, and
+ distribution metadata make it easier to understand what the project does and
+ where to start.
+5. **Release confidence** - Python tests, Unity compile checks, docs builds, and
+ compatibility shims keep the wide Unity support window practical.
+
+## AI Asset Generation
+
+The headline v10 feature is the new `asset_gen` tool group. It is disabled by
+default like other non-core tool groups, and can be enabled with `manage_tools`.
+
+The group contains:
+
+| Tool | Purpose |
+| --- | --- |
+| `generate_model` | Generate 3D models from text or image prompts through providers such as Tripo and Meshy. |
+| `generate_image` | Generate 2D images through providers such as fal.ai and OpenRouter. |
+| `import_model` | Search and import downloadable Sketchfab models. |
+| `import_model_file` | Import a local model file already on disk, such as an FBX/OBJ/glTF exported from Blender. |
+
+The tools use asynchronous job semantics for long-running work. A generation or
+import request returns a `job_id`; clients then call the corresponding
+`action="status"` operation until the job completes or fails. This keeps MCP
+calls responsive and gives agents a predictable pattern for progress reporting.
+
+### Provider keys
+
+Asset providers are bring-your-own-key. Keys are entered in the Unity Editor's
+Asset Gen tab and stored in the operating system secure store:
+
+- macOS: Keychain
+- Windows: Credential Manager
+- Linux: libsecret / Secret Service compatible tooling
+
+Keys are not written to project assets, `EditorPrefs`, generated docs, or MCP
+tool parameters. The MCP client can request a generation job, but it does not
+receive provider credentials.
+
+### Local image inputs
+
+v10 distinguishes hosted image inputs from local project images:
+
+- `image_url` points at an externally hosted image.
+- `image_path` points at a local file, commonly under `Assets/`.
+
+Meshy image-to-3D and fal/OpenRouter image-to-image can accept local image files
+by sending the image data inline as a base64 data URI. Tripo image-to-3D still
+requires a hosted `image_url` until an upload flow is wired.
+
+### Blender handoff
+
+The `import_model_file` tool creates a clean boundary between DCC generation and
+Unity import. BlenderMCP or another modeling workflow can create/export a model,
+then MCP for Unity imports that local file into the Unity project and can place
+it in the scene.
+
+This is a handoff, not MCP for Unity controlling Blender directly:
+
+1. The modeling tool creates or exports the asset.
+2. MCP for Unity imports the file with `import_model_file`.
+3. The Unity agent uses existing scene, material, prefab, and build tools to wire
+ the asset into the project.
+
+## Safety model
+
+Asset generation makes the bridge more powerful, so v10 calls out the guardrails
+around provider calls and file import.
+
+### Opt-in tool group
+
+`asset_gen` is not part of the default core tool set. Users must explicitly
+enable it with `manage_tools`, which keeps routine MCP sessions focused and
+limits accidental provider calls.
+
+### Project-scoped imports
+
+Generated and imported assets resolve into the Unity project's `Assets/` folder,
+with traversal and unsafe paths rejected. Archives are extracted through
+allowlisted import paths and extensions rather than blindly writing every file
+a provider returns.
+
+### No hidden spend
+
+Generation calls go to third-party providers using the user's own API keys:
+
+- MCP for Unity does not bundle provider credits.
+- Provider pricing, rate limits, and content policies are controlled by the
+ provider.
+- Enable the tool group only when you intend to call generation or import
+ providers.
+
+## Docs and brand refresh
+
+v10 also updates the project front door:
+
+- README trimmed into a clearer front door: what the project does, quickstart,
+ community, advanced links, and citation.
+- Docs site reorganized around Getting Started, Guides, Reference,
+ Architecture, Contributing, Migrations, and Releases.
+- Tool reference pages are generated from the tool registry so the docs match
+ the Python MCP layer.
+- Distribution and analytics docs are explicit about what is measured and what
+ is not.
+- Branding now consistently uses **MCP for Unity** in user-facing UI and docs.
+
+## Compatibility posture
+
+v10 continues the existing compatibility promise:
+
+- Unity 2021.3 LTS remains the package floor.
+- Unity 6.x stays in the supported matrix.
+- Known Unity API changes route through compatibility helpers under
+ `MCPForUnity/Runtime/Helpers/` instead of scattering `#if UNITY_*` gates
+ across tool code.
+- When touching shims or version-gated APIs, run `tools/check-unity-versions.sh`
+ against installed Unity Hub editors.
+
+The CoreCLR 6.8 path matters here. Deprecation fixes belong in one shim layer,
+not at every call site.
+
+## Upgrade notes from v9
+
+1. **Update the Unity package** to v10. During RC testing, use the `beta` branch.
+2. **Reconfigure MCP clients** if the package prompts you to, especially after
+ transport or server URL changes.
+3. **Install optional dependencies** only when needed. For example, GLB import
+ uses glTFast; FBX import does not require that package.
+4. **Enable `asset_gen` explicitly** with `manage_tools` before calling asset
+ generation tools.
+5. **Add provider keys in Unity**, not in MCP client config files.
+6. **Keep generated assets under review** before committing them. Provider
+ output can be large and belongs in the same review path as other binary
+ project assets.
+
+## What is intentionally not in v10
+
+Call these out to avoid confusing expectations:
+
+- No hosted MCP for Unity asset-generation credits.
+- No guarantee that every provider supports every input mode.
+- No automatic BlenderMCP configuration from Unity.
+- No promise that provider-generated assets are production-ready without artist
+ review.
+- No change to the rule that non-core tool groups start disabled.
+
+## Final comparison
+
+**Major-version comparison**: https://github.com/CoplayDev/unity-mcp/compare/v9.0.0...v10.0.0
+
+**v9.7.3 patch comparison**: https://github.com/CoplayDev/unity-mcp/compare/v9.7.3...v10.0.0
+
+## Troubleshooting
+
+### `asset_gen` tools do not appear
+
+The `asset_gen` group is disabled by default. Enable it with `manage_tools`:
+
+```text
+manage_tools action=activate group=asset_gen
+```
+
+If the tools still do not appear, refresh/reconnect the MCP server in the client.
+Some clients cache tool lists until the server is restarted or refreshed.
+
+### Provider key missing
+
+Generation providers are bring-your-own-key. Add keys in Unity's **Asset Gen**
+tab. Do not place provider keys in MCP client config files, prompts, project
+assets, or generated docs.
+
+### GLB import fails or has missing geometry/materials
+
+GLB/glTF import depends on **glTFast**. Install it from the Dependencies tab or
+via Package Manager before importing GLB assets. FBX imports do not require
+glTFast.
+
+### Tripo image-to-3D rejects `image_path`
+
+Tripo image-to-3D currently needs a hosted `image_url`. Local `image_path` inputs
+are supported by Meshy image-to-3D and fal/OpenRouter image-to-image, where the
+image can be sent inline as a base64 data URI.
+
+### Generated or imported files are larger than expected
+
+Provider output can include large binary assets. Review generated files before
+committing them, keep generated output under `Assets/Generated/` when possible,
+and avoid committing experimental provider output that is not needed by the
+project.
+
+### Archive import is rejected
+
+Archive extraction is intentionally constrained. Provider archives may be
+rejected when they contain unsupported extensions, traversal paths, scripts, or
+files outside the import allowlist. Import the model again with a supported
+format or inspect the archive before bringing it into the Unity project.
+
+## Related docs
+
+- [Tool groups](/guides/tool-groups)
+- [Asset generation tools](/reference/tools/asset_gen/)
+- [`generate_model`](/reference/tools/asset_gen/generate_model)
+- [`generate_image`](/reference/tools/asset_gen/generate_image)
+- [`import_model`](/reference/tools/asset_gen/import_model)
+- [`import_model_file`](/reference/tools/asset_gen/import_model_file)
+- [Generated tool reference](/reference/tools/)
+- [Unity compatibility shims](/architecture/unity-compat)
+- [Project roadmap](/architecture/project-roadmap)
diff --git a/website/docs/migrations/v6.md b/website/docs/migrations/v6.md
index b33ad19ec..02effe11c 100644
--- a/website/docs/migrations/v6.md
+++ b/website/docs/migrations/v6.md
@@ -14,7 +14,7 @@
The new MCP Editor Window is a complete rebuild using **UI Toolkit (UXML/USS)** with a **service-oriented architecture**. The design philosophy emphasizes **explicit over implicit** behavior, making the system more predictable, testable, and maintainable.
-**Quick Access:** `Cmd/Ctrl+Shift+M` or `Window > MCP For Unity > Open MCP Window`
+**Quick Access:** `Cmd/Ctrl+Shift+M` or `Window > MCP for Unity > Open MCP Window`
**Key Improvements:**
- 🎨 Modern UI that doesn't hide info as the window size changes
@@ -73,7 +73,7 @@ The new window intentionally removes implicit behaviors and complex edge-case ha
### ❌ Python Detection Warning
- **Old:** Warning banner if Python not detected on system
- **Why Removed:** Setup Wizard handles dependency checks, we also can't flood a bunch of error and warning logs when submitting to the Asset Store
-- **Alternative:** Run Setup Wizard via `Window > MCP For Unity > Setup Wizard`
+- **Alternative:** Run Setup Wizard via `Window > MCP for Unity > Setup Wizard`
### ❌ Separate Manual Setup Windows
- **Old:** `VSCodeManualSetupWindow`, `ManualConfigEditorWindow` popup dialogs
diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index 2f0ba06f8..66ec89d04 100644
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -20,6 +20,8 @@ function countConfigurators() {
}
const supportedClientCount = countConfigurators();
+const baseUrl = '/unity-mcp/';
+
/** @type {import('@docusaurus/types').Config} */
const config = {
title: 'MCP for Unity',
@@ -29,7 +31,7 @@ const config = {
// Hosted on GitHub Pages under the CoplayDev org.
// Custom domain (CNAME) deferred — see plan Phase 2.
url: 'https://coplaydev.github.io',
- baseUrl: '/unity-mcp/',
+ baseUrl,
organizationName: 'CoplayDev',
projectName: 'unity-mcp',
@@ -59,6 +61,22 @@ const config = {
crossorigin: 'anonymous',
},
},
+ {
+ tagName: 'link',
+ attributes: { rel: 'icon', type: 'image/png', sizes: '32x32', href: `${baseUrl}img/favicon-32.png` },
+ },
+ {
+ tagName: 'link',
+ attributes: { rel: 'apple-touch-icon', sizes: '180x180', href: `${baseUrl}img/apple-touch-icon.png` },
+ },
+ {
+ tagName: 'link',
+ attributes: { rel: 'icon', type: 'image/png', sizes: '192x192', href: `${baseUrl}img/android-chrome-192.png` },
+ },
+ {
+ tagName: 'link',
+ attributes: { rel: 'icon', type: 'image/png', sizes: '512x512', href: `${baseUrl}img/android-chrome-512.png` },
+ },
],
stylesheets: [
'https://api.fontshare.com/v2/css?f[]=satoshi@300,400,500,700,900&display=swap',
@@ -124,18 +142,20 @@ const config = {
],
},
],
+ ...(process.env.GOATCOUNTER_CODE ? ['docusaurus-plugin-goatcounter'] : []),
],
themeConfig:
/** @type {import('@docusaurus/preset-classic').ThemeConfig} */
({
image: 'img/social-card.png',
+ metadata: [{ name: 'theme-color', content: '#4f46e5' }],
navbar: {
title: 'MCP for Unity',
logo: {
alt: 'MCP for Unity logo',
src: 'img/logo-mark.svg',
- srcDark: 'img/logo-mark-dark.svg',
+ srcDark: 'img/logo-mark.svg',
},
items: [
{
@@ -205,6 +225,7 @@ const config = {
defaultMode: 'light',
respectPrefersColorScheme: true,
},
+ ...(process.env.GOATCOUNTER_CODE ? { goatcounter: { code: process.env.GOATCOUNTER_CODE } } : {}),
}),
};
diff --git a/website/package-lock.json b/website/package-lock.json
index bce930311..59a305bca 100644
--- a/website/package-lock.json
+++ b/website/package-lock.json
@@ -20,10 +20,12 @@
},
"devDependencies": {
"@docusaurus/module-type-aliases": "^3.6.3",
- "@docusaurus/types": "^3.6.3"
+ "@docusaurus/types": "^3.6.3",
+ "docusaurus-plugin-goatcounter": "^4.0.0",
+ "sharp": "^0.35.2"
},
"engines": {
- "node": ">=18.0"
+ "node": ">=20.9.0"
}
},
"node_modules/@algolia/abtesting": {
@@ -4259,9 +4261,9 @@
}
},
"node_modules/@emnapi/runtime": {
- "version": "1.10.0",
- "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz",
- "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==",
+ "version": "1.11.1",
+ "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.1.tgz",
+ "integrity": "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==",
"license": "MIT",
"optional": true,
"dependencies": {
@@ -4293,6 +4295,533 @@
"@hapi/hoek": "^9.0.0"
}
},
+ "node_modules/@img/colour": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz",
+ "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=18"
+ }
+ },
+ "node_modules/@img/sharp-darwin-arm64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.35.2.tgz",
+ "integrity": "sha512-eEieHsMksAW4IiO5NzauESRl2D2qz3J/kwUxUrSfV06A93eEaRfMpHXyUb1mAqrR7i8U9A0GRqE9pjn6u1Jjpg==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-darwin-arm64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-darwin-x64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.35.2.tgz",
+ "integrity": "sha512-BaktuGPCeHJMARpodR8jK4uKiZrPAy9WrfQW0sdI37clracq8Bp01AYS3SZgi5FS/y5twa9t4+LIuuxQjqRrWw==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-darwin-x64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-freebsd-wasm32": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-freebsd-wasm32/-/sharp-freebsd-wasm32-0.35.2.tgz",
+ "integrity": "sha512-YoAxdnd8hPUkvLHd3bWY+YA8nw3xM/RyRopYucNsWHVSan8NLVM3X2volsfoRDcXdUJPg6tXahSd7HXPK7lRnw==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "freebsd"
+ ],
+ "dependencies": {
+ "@img/sharp-wasm32": "0.35.2"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-darwin-arm64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.3.1.tgz",
+ "integrity": "sha512-4V/M3roRMTYjiwZY9IOVQOE8OyeCxFAkYmyZDrZl51uOKjibm3oeEJ4WAmLxutAfzFbC9jqUiPs2gbnGflH+7g==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-darwin-x64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.3.1.tgz",
+ "integrity": "sha512-c0/DxItpJv2+dGhgycJBBgotdqruGYDvA79drdh0MD1dFpy7JzJ/PlXwi1H4rFf0eTy8tgbI91aHDnZIceY3jQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "darwin"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-arm": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.3.1.tgz",
+ "integrity": "sha512-aGGy9aWzXgHBG7HNyQPWorZthlp7+x6fDRoPAQbGO3ThcttuTyKIx3NuSHb6zb4gBNq6/yNn9f1cy9nFKS/Vmg==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-arm64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.3.1.tgz",
+ "integrity": "sha512-JznefmcK9j1JKPz8AkQDh89kjojubyfOasWBPKfzMIhPwsgDy9evpE/naJTXXXmghS1iFwR8u/kTwh/I2/+GCw==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-ppc64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.3.1.tgz",
+ "integrity": "sha512-1EkwGNCZk6iWNCMWqrvdJ+r1j0PT1zIz60CNPhYnJlK/zyeWqlsPZIe+ocBVqPF8k/Ssee/NCk+tE9Ryrko6ng==",
+ "cpu": [
+ "ppc64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-riscv64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.3.1.tgz",
+ "integrity": "sha512-Ilays+w2bXdnxzxtQdmXR62u8o8GYa3eL4+Gr+1KiE4xperMZUslRaVPJwwPkzlHEjGfXAfRVAa/7CYCtSqsBw==",
+ "cpu": [
+ "riscv64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-s390x": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.3.1.tgz",
+ "integrity": "sha512-VfBwVHQTbRoj4XlpA/KLZ7ltgMpz+4WSejFzQ+GnoImjo1PtEJ59QB2qR1xQEeRPYIkNrPIm2L4cICMvz4C2ew==",
+ "cpu": [
+ "s390x"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linux-x64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.3.1.tgz",
+ "integrity": "sha512-+c8ukgwU62DS54nCAjw7keOfHUkmr0B5QHEdcOqRnodF/MNXJbVI8Eopoj4B/0H8Asr65I+A4Amrn7a85/md6A==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linuxmusl-arm64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.3.1.tgz",
+ "integrity": "sha512-qlKb/pwbkAi1WMsJrYHk7CuDrd12s27U2QnRhFYUoJNrRCmkosMTttuRFat/DDB3IlDm5qE1TJgZ4JDnHX8Ldw==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-libvips-linuxmusl-x64": {
+ "version": "1.3.1",
+ "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.3.1.tgz",
+ "integrity": "sha512-yO21HwoUVLN8Qa+/SBjQLMYwBWAVJjeGPNe+hc0OUeMeifEtJqu5a1c4HayE1nNpDih9y3/KkoltfkDodmKAlg==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-linux-arm": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.35.2.tgz",
+ "integrity": "sha512-SE4kzF2mepn6z+6E7L6lsV8FzuLL6IPQdyX8ZiwROAG/G8td+hP/m7FsFPwidtrF19gvajuC9l6TxAVcsA4S7A==",
+ "cpu": [
+ "arm"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-arm": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linux-arm64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.35.2.tgz",
+ "integrity": "sha512-af12Pnd0ZGu2HfP8NayB0kk6eC/lrfbQE6HlR4jD+34wdJ1Vw9TF6TMn6ZvffT+WgqVsl0hRbmNvz2u/23VmwA==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-arm64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linux-ppc64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.35.2.tgz",
+ "integrity": "sha512-hYSBm7zcNtDCozCxQHYZJiu63b/bXsgRZuOxCIBZsStMM9Vap47iFHdbX4kCvQsblPB/k+clhELpdQJHQLSHvg==",
+ "cpu": [
+ "ppc64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-ppc64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linux-riscv64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.35.2.tgz",
+ "integrity": "sha512-qQt0Kc13+Hoan/Awq/qMSQw3L+RI1NCRPgD5cUJ/1WSSmIoysLOc72jlRM3E0OHN9Yr313jgeQ2T+zW+F03QFA==",
+ "cpu": [
+ "riscv64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-riscv64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linux-s390x": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.35.2.tgz",
+ "integrity": "sha512-E4fLLfRPzDLlEeDaTzI98OFLcv++WL5ChLLMwPoVd0CIoZQqupBSNbOisPL5am9XsbQ9T84+iiMpUvbFtkunbA==",
+ "cpu": [
+ "s390x"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-s390x": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linux-x64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.35.2.tgz",
+ "integrity": "sha512-gi0zFJJRLswfCZmHtJdikXPOc5u7qamSOS3NHedLqLd4W8Q0NqjdBr6TTRIgsfFjqfTsHFgdfvJ9LwqSgcHiAA==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linux-x64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linuxmusl-arm64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.35.2.tgz",
+ "integrity": "sha512-siWbOW1u6HFnFLrp0waKyW7VEf7jYvcDWdrXEFa8AkdAQgEvuu5Fz8/Y70w9EeqAdwDtfU012BhEHHaDqvQNzg==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linuxmusl-arm64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-linuxmusl-x64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.35.2.tgz",
+ "integrity": "sha512-YBqMMcjDi4QGYiSn4vNOYBhmlC4z5AXqkOUUqI2e0AFA4urNv4ESgOgwNl3K+4etQhha0twXlzeF20bbULm9Yg==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "os": [
+ "linux"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-libvips-linuxmusl-x64": "1.3.1"
+ }
+ },
+ "node_modules/@img/sharp-wasm32": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.35.2.tgz",
+ "integrity": "sha512-Mrv4JQNYVQ94xH+jzZ9r+gowleN8mv2FTgKT+PI6bx5C0G8TdNYndu161pg2i7uoBwxy2ImPMHrJOM2LZef7Bw==",
+ "dev": true,
+ "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT",
+ "optional": true,
+ "dependencies": {
+ "@emnapi/runtime": "^1.11.1"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-webcontainers-wasm32": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-webcontainers-wasm32/-/sharp-webcontainers-wasm32-0.35.2.tgz",
+ "integrity": "sha512-QNV27pxs9wpApEiCfvHM1RDoP1w1+2KrUWWDPEhEwg+latvOrfuhWrHWZKwdSFwU6jh3myjw/yOCRsUIuOft3g==",
+ "cpu": [
+ "wasm32"
+ ],
+ "dev": true,
+ "license": "Apache-2.0",
+ "optional": true,
+ "dependencies": {
+ "@img/sharp-wasm32": "0.35.2"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-win32-arm64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.35.2.tgz",
+ "integrity": "sha512-BiVRYc/t6/Vl3e1hBx0hugG4oN9Pydf4fgMSpxTQJmwGUg/YoXTWHiFeRymHfCZzifxu4F4rpk/I67D0LQ20wQ==",
+ "cpu": [
+ "arm64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0 AND LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-win32-ia32": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.35.2.tgz",
+ "integrity": "sha512-YYEhx9PImCC7T0tI8JDMi4DB9LwLCXCU5OWNYEXAxh5Q1ShKkyC6byxzoBJ3gEFDnH2lQckWuDe70G7mB2XJog==",
+ "cpu": [
+ "ia32"
+ ],
+ "dev": true,
+ "license": "Apache-2.0 AND LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": "^20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
+ "node_modules/@img/sharp-win32-x64": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.35.2.tgz",
+ "integrity": "sha512-imoOyBcoM/iiUr4J6VPpCNjPnjvP/Gks95898yB8YqoGGYmHYbOyCuNv9FMhFgtaiHFGbHW8bxKqRV6VjtXThQ==",
+ "cpu": [
+ "x64"
+ ],
+ "dev": true,
+ "license": "Apache-2.0 AND LGPL-3.0-or-later",
+ "optional": true,
+ "os": [
+ "win32"
+ ],
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ }
+ },
"node_modules/@jest/schemas": {
"version": "29.6.3",
"resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz",
@@ -8303,6 +8832,16 @@
"npm": "1.2.8000 || >= 1.4.16"
}
},
+ "node_modules/detect-libc": {
+ "version": "2.1.2",
+ "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+ "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "engines": {
+ "node": ">=8"
+ }
+ },
"node_modules/detect-node": {
"version": "2.1.0",
"resolved": "https://registry.npmjs.org/detect-node/-/detect-node-2.1.0.tgz",
@@ -8363,6 +8902,16 @@
"node": ">=6"
}
},
+ "node_modules/docusaurus-plugin-goatcounter": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/docusaurus-plugin-goatcounter/-/docusaurus-plugin-goatcounter-4.0.0.tgz",
+ "integrity": "sha512-YJgbriYdruis4N0xutIv1qzoBi7/pe3RwExVvTyRAYLwNyd4oYA119pFSQ92pn6fUUxsffTanDvCT4cT1whSAA==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=20"
+ }
+ },
"node_modules/dom-converter": {
"version": "0.2.0",
"resolved": "https://registry.npmjs.org/dom-converter/-/dom-converter-0.2.0.tgz",
@@ -16743,9 +17292,9 @@
}
},
"node_modules/semver": {
- "version": "7.8.1",
- "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.1.tgz",
- "integrity": "sha512-rkVq3IXh+4FDGch+KwzX3aV9W3kO54GyEgpvBzSyctDA6Xtd7RJQV1xmXbeQp5v7+VzLOfVqiutSE6GICgPFvg==",
+ "version": "7.8.5",
+ "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+ "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
"license": "ISC",
"bin": {
"semver": "bin/semver.js"
@@ -16995,6 +17544,51 @@
"integrity": "sha512-y0m1JoUZSlPAjXVtPPW70aZWfIL/dSP7AFkRnniLCrK/8MDKog3TySTBmckD+RObVxH0v4Tox67+F14PdED2oQ==",
"license": "MIT"
},
+ "node_modules/sharp": {
+ "version": "0.35.2",
+ "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.35.2.tgz",
+ "integrity": "sha512-FVtFjtBCMiJS6yb5CX7Sop45WFMpeGw6oRKuJnXYgf/f1ms/D7LE/ZUSNxnW7rZ/dbslQWYkoqFHGPaDBtaK4w==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "@img/colour": "^1.1.0",
+ "detect-libc": "^2.1.2",
+ "semver": "^7.8.4"
+ },
+ "engines": {
+ "node": ">=20.9.0"
+ },
+ "funding": {
+ "url": "https://opencollective.com/libvips"
+ },
+ "optionalDependencies": {
+ "@img/sharp-darwin-arm64": "0.35.2",
+ "@img/sharp-darwin-x64": "0.35.2",
+ "@img/sharp-freebsd-wasm32": "0.35.2",
+ "@img/sharp-libvips-darwin-arm64": "1.3.1",
+ "@img/sharp-libvips-darwin-x64": "1.3.1",
+ "@img/sharp-libvips-linux-arm": "1.3.1",
+ "@img/sharp-libvips-linux-arm64": "1.3.1",
+ "@img/sharp-libvips-linux-ppc64": "1.3.1",
+ "@img/sharp-libvips-linux-riscv64": "1.3.1",
+ "@img/sharp-libvips-linux-s390x": "1.3.1",
+ "@img/sharp-libvips-linux-x64": "1.3.1",
+ "@img/sharp-libvips-linuxmusl-arm64": "1.3.1",
+ "@img/sharp-libvips-linuxmusl-x64": "1.3.1",
+ "@img/sharp-linux-arm": "0.35.2",
+ "@img/sharp-linux-arm64": "0.35.2",
+ "@img/sharp-linux-ppc64": "0.35.2",
+ "@img/sharp-linux-riscv64": "0.35.2",
+ "@img/sharp-linux-s390x": "0.35.2",
+ "@img/sharp-linux-x64": "0.35.2",
+ "@img/sharp-linuxmusl-arm64": "0.35.2",
+ "@img/sharp-linuxmusl-x64": "0.35.2",
+ "@img/sharp-webcontainers-wasm32": "0.35.2",
+ "@img/sharp-win32-arm64": "0.35.2",
+ "@img/sharp-win32-ia32": "0.35.2",
+ "@img/sharp-win32-x64": "0.35.2"
+ }
+ },
"node_modules/shebang-command": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
diff --git a/website/package.json b/website/package.json
index 2b50ff7b4..265265f34 100644
--- a/website/package.json
+++ b/website/package.json
@@ -11,12 +11,13 @@
"clear": "docusaurus clear",
"serve": "docusaurus serve",
"write-translations": "docusaurus write-translations",
- "write-heading-ids": "docusaurus write-heading-ids"
+ "write-heading-ids": "docusaurus write-heading-ids",
+ "gen:brand": "node scripts/gen-brand-assets.mjs"
},
"dependencies": {
"@docusaurus/core": "^3.6.3",
- "@docusaurus/preset-classic": "^3.6.3",
"@docusaurus/plugin-client-redirects": "^3.6.3",
+ "@docusaurus/preset-classic": "^3.6.3",
"@easyops-cn/docusaurus-search-local": "^0.46.1",
"@mdx-js/react": "^3.0.0",
"clsx": "^2.0.0",
@@ -26,10 +27,16 @@
},
"devDependencies": {
"@docusaurus/module-type-aliases": "^3.6.3",
- "@docusaurus/types": "^3.6.3"
+ "@docusaurus/types": "^3.6.3",
+ "docusaurus-plugin-goatcounter": "^4.0.0",
+ "sharp": "^0.35.2"
},
"browserslist": {
- "production": [">0.5%", "not dead", "not op_mini all"],
+ "production": [
+ ">0.5%",
+ "not dead",
+ "not op_mini all"
+ ],
"development": [
"last 3 chrome version",
"last 3 firefox version",
@@ -37,6 +44,6 @@
]
},
"engines": {
- "node": ">=18.0"
+ "node": ">=20.9.0"
}
}
diff --git a/website/scripts/fetch-stats.mjs b/website/scripts/fetch-stats.mjs
new file mode 100644
index 000000000..448d4ab19
--- /dev/null
+++ b/website/scripts/fetch-stats.mjs
@@ -0,0 +1,101 @@
+const PKG = 'mcpforunityserver';
+const REPO = 'CoplayDev/unity-mcp';
+const GH = 'https://api.github.com';
+
+export function normalizePypiRecent(recent) {
+ if (recent == null) {
+ return { lastDay: null, lastWeek: null, lastMonth: null, unavailable: true };
+ }
+ const d = (recent && recent.data) || {};
+ return { lastDay: d.last_day ?? 0, lastWeek: d.last_week ?? 0, lastMonth: d.last_month ?? 0 };
+}
+
+// Builds the unified stats object. Honest user signals (GitHub clones/stars,
+// and the in-product DAU/WAU surfaced elsewhere) sit alongside the noisy PyPI
+// download proxy, which renderSummary clearly labels as inflated.
+export function buildStats({ recent, repo = null, clones = null, views = null, webPageviews = null, generatedAt }) {
+ return {
+ generatedAt,
+ github: {
+ stars: repo?.stargazers_count ?? null,
+ forks: repo?.forks_count ?? null,
+ uniqueCloners14d: clones?.uniques ?? null,
+ uniqueViewers14d: views?.uniques ?? null,
+ },
+ pypi: normalizePypiRecent(recent),
+ web: webPageviews,
+ };
+}
+
+export function renderSummary(stats) {
+ const g = stats.github, p = stats.pypi;
+ const n = (x) => (x == null ? '—' : Number(x).toLocaleString('en-US'));
+ const web = stats.web && stats.web.total != null
+ ? `${n(stats.web.total)} total pageviews`
+ : '_pending GoatCounter provisioning_';
+ const trafficMissing = g.uniqueCloners14d == null && g.uniqueViewers14d == null;
+ return [
+ '## MCP for Unity — adoption (maintainer-only)',
+ `_generated ${stats.generatedAt}_`,
+ '',
+ '### Real-user signals (the honest ones)',
+ '| Signal | Value | Reads as |',
+ '| --- | ---: | --- |',
+ `| In-product DAU / WAU | _pending_ | **true active users** — already collected by the in-product telemetry; needs a Coplay read API |`,
+ `| Unique repo cloners (14d) | ${n(g.uniqueCloners14d)} | developers actually pulling the code |`,
+ `| Unique repo viewers (14d) | ${n(g.uniqueViewers14d)} | distinct repo visitors |`,
+ `| GitHub stars | ${n(g.stars)} | real accounts interested |`,
+ `| GitHub forks | ${n(g.forks)} | |`,
+ ...(trafficMissing
+ ? ['', '> Cloners/viewers are blank: the workflow needs a maintainer PAT with **Administration: read** (`STATS_GITHUB_TOKEN`). See the external-analytics doc.']
+ : []),
+ '',
+ '### Reach proxy (inflated — NOT a user count)',
+ '| Window | PyPI downloads |',
+ '| --- | ---: |',
+ `| Last day | ${n(p.lastDay)} |`,
+ `| Last week | ${n(p.lastWeek)} |`,
+ `| Last month | ${n(p.lastMonth)} |`,
+ '',
+ ...(p.unavailable
+ ? ['> PyPI stats are unavailable: the pypistats.org request failed. Do not treat these dashes as zero downloads.', '']
+ : []),
+ '> PyPI counts are install events — CI, mirrors, `uvx` re-fetches, and Docker rebuilds inflate them heavily. Treat as a trend line, not people.',
+ '',
+ '### Docs traffic',
+ web,
+ '',
+ ].join('\n');
+}
+
+async function main() {
+ const get = async (url, headers) => {
+ try { const r = await fetch(url, { headers }); return r.ok ? await r.json() : null; } catch { return null; }
+ };
+ const ghToken = process.env.STATS_GITHUB_TOKEN || process.env.GITHUB_TOKEN;
+ const ghHeaders = {
+ 'User-Agent': 'mcp-for-unity-stats',
+ Accept: 'application/vnd.github+json',
+ ...(ghToken ? { Authorization: `Bearer ${ghToken}` } : {}),
+ };
+
+ const recent = await get(`https://pypistats.org/api/packages/${PKG}/recent`, { Accept: 'application/json' });
+ const repo = await get(`${GH}/repos/${REPO}`, ghHeaders);
+ const clones = await get(`${GH}/repos/${REPO}/traffic/clones`, ghHeaders);
+ const views = await get(`${GH}/repos/${REPO}/traffic/views`, ghHeaders);
+
+ let web = null;
+ const gcToken = process.env.GOATCOUNTER_TOKEN, gcSite = process.env.GOATCOUNTER_SITE;
+ if (gcToken && gcSite) {
+ const j = await get(`https://${gcSite}.goatcounter.com/api/v0/stats/total`, { Authorization: `Bearer ${gcToken}` });
+ if (j) web = { total: j.total ?? null };
+ }
+
+ const stats = buildStats({ recent, repo, clones, views, webPageviews: web, generatedAt: new Date().toISOString() });
+ process.stdout.write(renderSummary(stats));
+}
+
+import { fileURLToPath } from 'node:url';
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+ main().catch((e) => { console.error(e); process.exit(1); });
+}
diff --git a/website/scripts/fetch-stats.test.mjs b/website/scripts/fetch-stats.test.mjs
new file mode 100644
index 000000000..b27f073fe
--- /dev/null
+++ b/website/scripts/fetch-stats.test.mjs
@@ -0,0 +1,71 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { normalizePypiRecent, buildStats, renderSummary } from './fetch-stats.mjs';
+
+test('normalizePypiRecent extracts day/week/month', () => {
+ assert.deepEqual(
+ normalizePypiRecent({ data: { last_day: 100, last_week: 700, last_month: 3000 } }),
+ { lastDay: 100, lastWeek: 700, lastMonth: 3000 },
+ );
+});
+
+test('normalizePypiRecent handles missing data', () => {
+ assert.deepEqual(normalizePypiRecent({}), { lastDay: 0, lastWeek: 0, lastMonth: 0 });
+});
+
+test('normalizePypiRecent marks failed requests as unavailable', () => {
+ assert.deepEqual(
+ normalizePypiRecent(null),
+ { lastDay: null, lastWeek: null, lastMonth: null, unavailable: true },
+ );
+});
+
+test('buildStats maps github + pypi + web', () => {
+ const stats = buildStats({
+ recent: { data: { last_day: 1, last_week: 2, last_month: 3 } },
+ repo: { stargazers_count: 11102, forks_count: 1229 },
+ clones: { uniques: 84 },
+ views: { uniques: 530 },
+ webPageviews: { total: 42 },
+ generatedAt: 't',
+ });
+ assert.deepEqual(stats.github, { stars: 11102, forks: 1229, uniqueCloners14d: 84, uniqueViewers14d: 530 });
+ assert.deepEqual(stats.pypi, { lastDay: 1, lastWeek: 2, lastMonth: 3 });
+ assert.deepEqual(stats.web, { total: 42 });
+});
+
+test('buildStats nulls github fields when sources unavailable', () => {
+ const stats = buildStats({ recent: { data: {} }, generatedAt: 't' });
+ assert.deepEqual(stats.github, { stars: null, forks: null, uniqueCloners14d: null, uniqueViewers14d: null });
+ assert.equal(stats.web, null);
+});
+
+test('renderSummary leads with real-user signals and labels PyPI as inflated', () => {
+ const stats = buildStats({
+ recent: { data: { last_day: 4912, last_week: 38270, last_month: 192776 } },
+ repo: { stargazers_count: 11102, forks_count: 1229 },
+ clones: { uniques: 84 },
+ views: { uniques: 530 },
+ generatedAt: 't',
+ });
+ const md = renderSummary(stats);
+ assert.match(md, /Real-user signals/);
+ assert.match(md, /GitHub stars \| 11,102/);
+ assert.match(md, /Unique repo cloners \(14d\) \| 84/);
+ assert.match(md, /true active users/); // DAU/WAU flagged first
+ assert.match(md, /inflated — NOT a user count/);
+ assert.match(md, /Last month \| 192,776/);
+});
+
+test('renderSummary notes when the traffic token is missing', () => {
+ const stats = buildStats({ recent: { data: {} }, repo: { stargazers_count: 1, forks_count: 0 }, generatedAt: 't' });
+ assert.match(renderSummary(stats), /Administration: read/);
+});
+
+test('renderSummary distinguishes unavailable PyPI stats from zero downloads', () => {
+ const stats = buildStats({ recent: null, repo: { stargazers_count: 1, forks_count: 0 }, generatedAt: 't' });
+ const md = renderSummary(stats);
+ assert.match(md, /Last day \| —/);
+ assert.match(md, /PyPI stats are unavailable/);
+ assert.match(md, /Do not treat these dashes as zero downloads/);
+});
diff --git a/website/scripts/gen-brand-assets.mjs b/website/scripts/gen-brand-assets.mjs
new file mode 100644
index 000000000..98e4c5350
--- /dev/null
+++ b/website/scripts/gen-brand-assets.mjs
@@ -0,0 +1,34 @@
+// Rasterizes the brand SVG marks into the favicon/icon PNG set.
+// Run from the website/ directory: `npm run gen:brand`
+// Text-bearing assets (hero banner, social card) are produced separately via
+// an HTML render so the Satoshi wordmark uses the real font.
+import sharp from 'sharp';
+import { readFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const HERE = path.dirname(fileURLToPath(import.meta.url)); // website/scripts
+const ROOT = path.resolve(HERE, '..', '..');
+const IMG = path.join(ROOT, 'website', 'static', 'img');
+
+const full = path.join(IMG, 'logo-mark.svg');
+
+async function rasterize(src, size, out) {
+ const svg = await readFile(src);
+ await sharp(svg, { density: 512 })
+ .resize(size, size, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+ .png()
+ .toFile(out);
+ console.log(' wrote', path.relative(ROOT, out), `(${size}px)`);
+}
+
+await mkdir(IMG, { recursive: true });
+await rasterize(full, 48, path.join(IMG, 'favicon.png'));
+await rasterize(full, 32, path.join(IMG, 'favicon-32.png'));
+await rasterize(full, 180, path.join(IMG, 'apple-touch-icon.png'));
+await rasterize(full, 192, path.join(IMG, 'android-chrome-192.png'));
+await rasterize(full, 512, path.join(IMG, 'android-chrome-512.png'));
+// 128px source for the UPM package icon — wiring it into MCPForUnity needs the
+// Unity Editor to generate the .meta, so it lives here as a source asset.
+await rasterize(full, 128, path.join(IMG, 'package-icon.png'));
+console.log('Brand icon set generated.');
diff --git a/website/sidebars.js b/website/sidebars.js
index 1aee6cea5..dd158e28f 100644
--- a/website/sidebars.js
+++ b/website/sidebars.js
@@ -75,6 +75,7 @@ const sidebars = {
'architecture/manage-physics',
'architecture/project-roadmap',
'architecture/roadmap',
+ 'architecture/external-analytics',
],
},
{
@@ -96,6 +97,7 @@ const sidebars = {
'migrations/v5',
'migrations/v6',
'migrations/v8',
+ 'migrations/v10',
],
},
'releases',
diff --git a/website/static/img/android-chrome-192.png b/website/static/img/android-chrome-192.png
new file mode 100644
index 000000000..288a3cabe
Binary files /dev/null and b/website/static/img/android-chrome-192.png differ
diff --git a/website/static/img/android-chrome-512.png b/website/static/img/android-chrome-512.png
new file mode 100644
index 000000000..a379e4e87
Binary files /dev/null and b/website/static/img/android-chrome-512.png differ
diff --git a/website/static/img/apple-touch-icon.png b/website/static/img/apple-touch-icon.png
new file mode 100644
index 000000000..8ba35c20d
Binary files /dev/null and b/website/static/img/apple-touch-icon.png differ
diff --git a/website/static/img/favicon-32.png b/website/static/img/favicon-32.png
new file mode 100644
index 000000000..e31b79e68
Binary files /dev/null and b/website/static/img/favicon-32.png differ
diff --git a/website/static/img/favicon.png b/website/static/img/favicon.png
index 142983992..05bdfc00f 100644
Binary files a/website/static/img/favicon.png and b/website/static/img/favicon.png differ
diff --git a/website/static/img/github-social-preview.png b/website/static/img/github-social-preview.png
new file mode 100644
index 000000000..a02f51ff2
Binary files /dev/null and b/website/static/img/github-social-preview.png differ
diff --git a/website/static/img/logo-mark-dark.svg b/website/static/img/logo-mark-dark.svg
deleted file mode 100644
index 0195f0e1d..000000000
--- a/website/static/img/logo-mark-dark.svg
+++ /dev/null
@@ -1,6 +0,0 @@
-
- MCP for Unity
-
diff --git a/website/static/img/logo-mark.svg b/website/static/img/logo-mark.svg
index 28d489cda..728afeca3 100644
--- a/website/static/img/logo-mark.svg
+++ b/website/static/img/logo-mark.svg
@@ -1,6 +1,23 @@
-
+
MCP for Unity
-
+
+
+
+
+
+
+
diff --git a/website/static/img/logo.png b/website/static/img/logo.png
index 142983992..065ea8160 100644
Binary files a/website/static/img/logo.png and b/website/static/img/logo.png differ
diff --git a/website/static/img/package-icon.png b/website/static/img/package-icon.png
new file mode 100644
index 000000000..9542e46a9
Binary files /dev/null and b/website/static/img/package-icon.png differ
diff --git a/website/static/img/social-card.png b/website/static/img/social-card.png
index a69ef8c9b..9eeb8a18e 100644
Binary files a/website/static/img/social-card.png and b/website/static/img/social-card.png differ
+
+ 
-
----
-
-## Read the Docs
-
-### **→ [coplaydev.github.io/unity-mcp](https://coplaydev.github.io/unity-mcp/)**
-
----
-
-## Install
-
-In Unity: **Window → Package Manager → + → Add package from git URL**, paste:
-
-```text
-https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
-```
+[English](README.md) 
[简体中文](docs/i18n/README-zh.md) | [Discord](https://discord.gg/y4p8KfzrN4) 
+
+ 
[简体中文](README-zh.md) | [Discord](https://discord.gg/y4p8KfzrN4) 
+