MagentaDolphin
08e9679b06
The engine now ships an MCP server, a toolset registry and skill assets -- measured against a live editor rather than read about. Building a second transport beside it is not a contest this project can win. ADR-0001 is narrowed, not withdrawn. Its liveness reasoning survives intact: process over file, tools that vanish honestly, recovery without a restart. Three mechanisms are dropped (own JSON-RPC server, UDP-broadcast discovery, own heartbeat) and discovery becomes a probe of the documented endpoint, which the measurement showed gives a fast negative -- HTTP 404 with a routing error body, no hang. That is the property the PID file could not provide. Two layers stay ours: a server that runs without the engine, and tools that run in a live game outside the editor, the layer the registry's editor-only declaration leaves uncovered. The load-bearing claim is flagged as not yet attempted: a runtime tool answering in a packaged build. Until that runs it is derived, not measured. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
53 lines
5.0 KiB
Markdown
53 lines
5.0 KiB
Markdown
# ue-toolchain
|
||
|
||
Инструменты для разработки на Unreal Engine через LLM-агентов: UE-плагин, MCP-сервер, скиллы, установщик, локальная документация проекта.
|
||
|
||
**Статус:** ранняя разработка. Готов и лицензирован один компонент — бандл скиллов
|
||
`plugins/ue-design-skills/` (17 скиллов, 232 записи о режимах отказа, гейт поставки
|
||
на 16 правилах). Остальные компоненты таблицы ниже — план, кода ещё нет.
|
||
|
||
## Состав (план)
|
||
|
||
| Компонент | Назначение |
|
||
|---|---|
|
||
| `Engine/` | UE-плагин редактора (C++): JSON-RPC сервер, discovery, мониторинг |
|
||
| `mcp-server/` | MCP-сервер на Python: инструменты для агентов (Hermes, Claude Code, Codex) |
|
||
| `plugins/ue-design-skills/` | Скиллы для LLM-агентов: нормы и воспроизводимые рецепты обнаружения. Харнес-нейтральны, индекс — `catalog.json` |
|
||
| `installer/` | CLI: установка плагина, регистрация MCP, копирование скиллов |
|
||
| `docs/` | Архитектурные решения и документация |
|
||
| `examples/` | Минимальный UE-проект для интеграционных тестов |
|
||
|
||
## Архитектурные решения
|
||
|
||
- [ADR-0001: Discovery over PID file](docs/architecture/decisions/0001-discovery-over-pid-file.md) — поиск запущенного редактора через UDP-broadcast, а не через файл-PID.
|
||
- [ADR-0002: Harness-neutral skill bundle](docs/architecture/decisions/0002-harness-neutral-skill-bundle.md) — репозиторий как маркетплейс, `catalog.json` как источник истины, манифест вендора как адаптер. Нейтральность проверяется гейтом, а не обещается.
|
||
- [ADR-0003: Split licensing](docs/architecture/decisions/0003-split-licensing-prose-and-code.md) — проза бандла под CC BY-ND 4.0, код и метаданные под Apache-2.0; правообладатель назван, атрибуция в титрах — просьба, а не условие.
|
||
- [ADR-0004: Engine tool surface out of skill content](docs/architecture/decisions/0004-engine-tool-surface-out-of-skill-content.md) — имена тулсетов, мета-тулов и эндпоинтов движка не попадают в `skills/`: слой экспериментальный, а его отказ молчалив. Проверяется правилом гейта P17.
|
||
- [ADR-0005: Native transport narrows ADR-0001](docs/architecture/decisions/0005-native-transport-narrows-adr-0001.md) — движок привёз свой MCP-сервер; свой мост, UDP-discovery и heartbeat сняты, контракт живости сохранён. Нашими остаются два слоя: сервер без редактора и тулы в рантайме.
|
||
|
||
## Лицензия
|
||
|
||
Copyright (c) 2026 MagentaDolphin. Издатель — Kodlo.art.
|
||
|
||
| Что | Лицензия |
|
||
|---|---|
|
||
| Код: плагин редактора, MCP-сервер, установщик, гейт поставки, манифесты | [Apache-2.0](LICENSE) |
|
||
| Проза бандла `plugins/ue-design-skills/` | [CC BY-ND 4.0](plugins/ue-design-skills/LICENSE) |
|
||
|
||
Практическая разница: код можно форкать и переиздавать как обычно; **изменённую
|
||
версию текстов публиковать как свой продукт нельзя**. Всё остальное разрешено —
|
||
использование в коммерческой работе, правка под свою студию, дословное
|
||
распространение с указанием авторства, адаптеры формата под другие харнесы и
|
||
переводы.
|
||
|
||
На то, что вы создаёте с помощью инструмента, притязаний нет: ни на игру, ни на
|
||
код, ни на документацию, ни на выручку.
|
||
|
||
Если инструмент помог — упоминание приветствуется, но ничем не обязывает.
|
||
Атрибуция обязательна только при распространении самих материалов.
|
||
|
||
Оговорка: выбор лицензий — не юридическое заключение. Материал бандла получен
|
||
чтением стороннего сэмпла, распространяемого по UE EULA; в поставке нет чужого
|
||
кода, адресов и дословных выдержек, но заключением о вашем использовании это не
|
||
является.
|