unrealhub-developer

UnrealMCPHub 代码库开发维护指南。面向修改 Hub 源码（Python/MCP 服务器）的开发者。触发：用户修改 UnrealMCPHub/src 下源码时激活。

25 stars

Best use case

unrealhub-developer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

UnrealMCPHub 代码库开发维护指南。面向修改 Hub 源码（Python/MCP 服务器）的开发者。触发：用户修改 UnrealMCPHub/src 下源码时激活。

Teams using unrealhub-developer should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/unrealhub-developer/SKILL.md --create-dirs "https://raw.githubusercontent.com/ComeOnOliver/skillshub/main/skills/blackplume233/UnrealMCPHub/unrealhub-developer/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/unrealhub-developer/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How unrealhub-developer Compares

Feature / Agent	unrealhub-developer	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

UnrealMCPHub 代码库开发维护指南。面向修改 Hub 源码（Python/MCP 服务器）的开发者。触发：用户修改 UnrealMCPHub/src 下源码时激活。

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# UnrealMCPHub 开发者指南

> **注意**：本文件面向 Hub 代码库本身的维护与开发。
> 如需了解如何**使用** Hub 驱动 UE 开发，请参阅 `skills/use-unrealhub/SKILL.md`（随 Hub 仓库一起发布）。
>
> **维护规约**：对 Hub 的任何功能变更（新工具、参数修改、行为变化）
> 都**必须**同步更新 `skills/use-unrealhub/SKILL.md`。详见下方「添加新工具检查清单」。

## 架构概览

```
UnrealMCPHub/
├── src/unrealhub/
│   ├── server.py              # MCP 服务器入口、工具注册
│   ├── config.py              # 项目配置管理
│   ├── tools/
│   │   ├── project_tools.py   # setup/config/remove/status
│   │   ├── build_tools.py     # build_project
│   │   ├── launch_tools.py    # launch/stop/restart editor
│   │   ├── install_tools.py   # check_plugin_status
│   │   ├── discovery_tools.py # discover/manage instances
│   │   ├── monitor_tools.py   # health check
│   │   ├── log_tools.py       # get_log
│   │   ├── proxy_tools.py     # ue_status/list/call/run_python
│   │   └── session_tools.py   # add_note/get_session
│   └── core/
│       ├── instance_manager.py
│       ├── process_manager.py
│       └── watcher.py
├── skills/
│   ├── unrealhub-developer/
│   │   └── SKILL.md           # 本文件（开发者指南）
│   ├── use-unrealhub/
│   │   └── SKILL.md           # 使用者技能（随 Hub 发布）
│   └── ue-benchmark/
│       ├── SKILL.md           # Benchmark 通用框架
│       └── scenarios/         # 各评测场景规格
│           └── vampire-survivors-v1.md
```

## 工具注册模式

所有工具在 `server.py` 中通过 `@mcp.tool()` 装饰器注册。添加新工具时：

1. 在对应的 `tools/*.py` 中实现函数
2. 在 `server.py` 中导入并注册
3. 更新 `skills/use-unrealhub/SKILL.md` 的工具速查表

## 代理工具原理

`proxy_tools.py` 中的 `ue_call`/`ue_run_python` 通过 HTTP 转发到 UE 内运行的 RemoteMCP 插件。关键逻辑：

- 活跃实例选择：`instance_manager.get_active()`
- HTTP 转发：`POST http://{host}:{port}/mcp/call`
- 离线降级：返回引导信息而非抛异常

## 添加新工具检查清单

- [ ] `tools/*.py` 中实现
- [ ] `server.py` 中注册
- [ ] 错误处理（连接失败、实例离线、参数校验）
- [ ] **同步更新** `skills/use-unrealhub/SKILL.md`
- [ ] 如有新的使用模式/注意事项，同步补充到技能文件的对应 Part

## 发布检查清单

每次 Hub 发版（打 tag / bump version）前必须执行：

- [ ] **更新 `PLUGIN_TAG`**：检查 [RemoteMCP](https://github.com/blackplume233/UnrealRemoteMCP) 最新 tag，
      将 `src/unrealhub/config.py` 中的 `PLUGIN_TAG` 更新为该 tag（如 `"v1.0.0"`）
- [ ] **更新 `pyproject.toml` version**：与 git tag 一致
- [ ] **全量测试通过**：`pytest tests/ -v`
- [ ] **SKILL.md 同步**：确认 `skills/use-unrealhub/SKILL.md` 反映所有变更
- [ ] **Lint 清零**：无新增 lint 错误

Related Skills

gtm-developer-ecosystem

from ComeOnOliver/skillshub

Build and scale developer-led adoption through ecosystem programs. Use when deciding open vs curated ecosystems, building developer programs, scaling platform adoption, or designing student program pipelines.

use-unrealhub

from ComeOnOliver/skillshub

通过 UnrealMCPHub 驱动 Unreal Engine 完成游戏开发全流程的综合技能。覆盖：工程管理、C++ 编译、关卡构建、PIE 测试、AI 寻路、内存治理、弹窗处理、Slate UI 操控、UMG Widget 创建。触发：用户提及 UE/Unreal/编译/启动/崩溃/MCP/PIE/关卡/怪物/AI/UI/Widget/Slate 等关键词时激活。

browser-extension-developer

from ComeOnOliver/skillshub

Use this skill when developing or maintaining browser extension code in the `browser/` directory, including Chrome/Firefox/Edge compatibility, content scripts, background scripts, or i18n updates.

unity-developer

from ComeOnOliver/skillshub

Build Unity games with optimized C# scripts, efficient rendering, and proper asset management. Masters Unity 6 LTS, URP/HDRP pipelines, and cross-platform deployment. Handles gameplay systems, UI implementation, and platform optimization. Use PROACTIVELY for Unity performance issues, game mechanics, or cross-platform builds.

mobile-developer

from ComeOnOliver/skillshub

Develop React Native, Flutter, or native mobile apps with modern architecture patterns. Masters cross-platform development, native integrations, offline sync, and app store optimization. Use PROACTIVELY for mobile features, cross-platform code, or app optimization.

ios-developer

from ComeOnOliver/skillshub

Develop native iOS applications with Swift/SwiftUI. Masters iOS 18, SwiftUI, UIKit integration, Core Data, networking, and App Store optimization. Use PROACTIVELY for iOS-specific features, App Store optimization, or native iOS development.

frontend-developer

from ComeOnOliver/skillshub

Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture. Optimizes performance and ensures accessibility. Use PROACTIVELY when creating UI components or fixing frontend issues.

blockchain-developer

from ComeOnOliver/skillshub

Build production-ready Web3 applications, smart contracts, and decentralized systems. Implements DeFi protocols, NFT platforms, DAOs, and enterprise blockchain integrations. Use PROACTIVELY for smart contracts, Web3 apps, DeFi protocols, or blockchain infrastructure.

professional-senior-chrome-extension-architect-developer

from ComeOnOliver/skillshub

Verwandelt den Agenten in einen professionellen MV3-Architekten und Entwickler mit Fokus auf AI-Integration, Sicherheit, Performance, Testing und Publishing-Compliance.

readme-for-developers

from ComeOnOliver/skillshub

Write developer-oriented README as onboarding documentation. Use when creating/updating README, setting up new projects, or when new developers need to understand the codebase quickly. README = Entry point + Architecture overview + Working agreement.

unreal-engine-developer

from ComeOnOliver/skillshub

Expert Unreal Engine 5 developer and technical artist for complete game development via agentic coding. Enables AI-driven control of Unreal Editor through MCP, Python scripting, Blueprints, and C++ for level design, asset management, gameplay programming, and visual development.

developer-experience

from ComeOnOliver/skillshub

Developer Experience specialist for tooling, setup, and workflow optimization. Use when setting up projects, reducing friction, improving development workflows, or automating repetitive tasks. Focuses on making development joyful and productive.