К основному содержанию
плагин CX Codex

bgs-modding-superpowers — плагин для Claude Code

Плагин bgs-modding-superpowers для сборки модпаков Bethesda: два MCP-сервера, аудит конфликтов в xEdit и управление MO2 прямо из сессии агента.

MIT ★ 1 596 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install bgs-modding-superpowers@awesome-codex-plugins
Открыть на GitHub

Что делает bgs-modding-superpowers

Плагин поднимает в сессии два MCP-сервера. xedit даёт девять инструментов по интентам (xedit_session, xedit_find_record, xedit_inspect_conflicts и остальные) плюс xedit_call для прямых команд демона. Каждый вызов проходит конвейер из семи стадий, от проверки состояния до аудита. bgs_kb ищет по локальной базе знаний на SQLite с FTS5 и отвечает, даже когда MO2 и xEdit не запущены.

MO2 управляется через брокер, Python-загрузчик и C++ DLL плагина. Агент читает состояние профиля, запускает лончеры, ловит PID дочерних процессов. Скрипт scripts/install-mo2-control-plane.ps1 ставит всё это в ваш MO2. Остальное берут на себя скиллы: setting-up-bgs-modding-environment проводит первичную настройку, xedit-conflict-audit ведёт разбор конфликтов, writing-modpack-devlog и writing-modpack-changelog пишут документацию проекта.

Нужен Windows и Node 22+. Целевые игры: Skyrim SE/AE, Fallout 4, Fallout 76, Starfield. Skyrim LE и Oblivion пробовали, но не тестировали. Сервер xedit не знает, где стоит MO2, пока в его env не задан BGS_MO2_ROOT с путём до каталога, где лежит ModOrganizer.exe.

Какие задачи решает

  • Прогнать аудит конфликтов между плагинами в xEdit
  • Подключить агента к живому MO2 и запускать лончеры из сессии
  • Найти запись по шаблону и прочитать её содержимое
  • Завести dev-log и changelog модпака на первом запуске
  • Свериться с базой знаний по моддингу Bethesda без запуска xEdit

Примеры запросов агенту

  • Настрой окружение для моддинга BGS в этой папке проекта.
  • Прогони аудит конфликтов по моему профилю MO2 и покажи проблемные записи.
  • Добавь в dev-log модпака запись про сегодняшнюю правку лоад-ордера.

Как установить bgs-modding-superpowers

Через маркетплейс плагинов

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install bgs-modding-superpowers@awesome-codex-plugins

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о bgs-modding-superpowers

Как установить bgs-modding-superpowers в Claude Code?

Через маркетплейс, двумя командами подряд: /plugin marketplace add hashgraph-online/awesome-codex-plugins, затем /plugin install bgs-modding-superpowers@awesome-codex-plugins.

Что делает bgs-modding-superpowers?

Добавляет MCP-серверы xedit и bgs_kb, ставит в MO2 control plane и подключает скиллы для первичной настройки, аудита конфликтов и документации модпака.

Что нужно для работы плагина?

Windows, Node 22+ и одна из целевых игр: Skyrim SE/AE, Fallout 4, Fallout 76 или Starfield. Отдельно задайте BGS_MO2_ROOT с путём до каталога с ModOrganizer.exe, иначе сервер xedit не найдёт установку MO2.

Исходный текст

bgs-modding-superpowers · MIT
# bgs-modding-superpowers

An agent plugin for Bethesda Game Studio modpack curation. Installs on OpenCode, Claude Code, and Codex. Ships xEdit and knowledge-base MCP servers, an MO2 control-plane installer, and skills that walk the agent through first-run setup, conflict audit, and project documentation.

## What's in v0.2

- **`xedit` MCP server** — nine intent tools (`xedit_session`, `xedit_list_capabilities`, `xedit_find_record`, `xedit_read_record`, `xedit_inspect_conflicts`, `xedit_inspect_conflicts_deep`, `xedit_find_records_by_pattern`, `xedit_create_child_record`, `xedit_navigate_ancestry`) plus the atomic `xedit_call` passthrough for the native xEdit daemon command set discovered at runtime via `system.capabilities`. Goes through a 7-stage harness pipeline (validate → state-check → rules → forward → envelope → audit).
- **`bgs_kb` MCP server** — local SQLite + FTS5 knowledge-base lookup (`bgs_kb_status`, `bgs_kb_query`, `bgs_kb_get`) over the bundled core BGS modding KB. Works without MO2 or xEdit running.
- **MO2 control plane** — C++ MO2 plugin DLL + Python loader + broker that lets the agent drive your MO2 instance (read profile state, run launchers, capture child PIDs). Deployed by `scripts/install-mo2-control-plane.ps1` into your own MO2.
- **xEdit hook bridge (retired)** — historical Delphi DLL retained at `tools/xedit-hook-bridge/dist/`; native `xEdit.exe -automation-serve` now handles unattended launches.
- **Skills**:
  - `using-bgs-modding-superpowers` — per-session bootstrap.
  - `setting-up-bgs-modding-environment` — first-run install orchestrator (MO2 detect → control plane → optional xEdit download → dev-log / changelog init → semantic smoke test).
  - `xedit-automation` + `xedit-conflict-audit` — the hub skill and the W2 conflict-audit workflow.
  - `writing-modpack-devlog`, `writing-modpack-changelog` — create and maintain your modpack project's documentation at runtime.

## Install

### OpenCode

Add to the `plugin` array of your `opencode.json`:

```json
{
  "plugin": ["bgs-modding-superpowers@git+https://github.com/BB-84C/bgs-modding-superpowers.git"]
}
```

Full instructions: [`.opencode/INSTALL.md`](.opencode/INSTALL.md).

For a project-local vendor install, use `npm install --prefix .opencode/vendor ...` and configure the plugin as `./.opencode/vendor/node_modules/bgs-modding-superpowers`. This path is resolved from the project configuration, so a shared OpenCode server does not depend on its own working directory.

### Claude Code

```text
/plugin marketplace add BB-84C/bgs-modding-superpowers
/plugin install bgs-modding-superpowers@bgs-modding-superpowers
```

The bundled `xedit` and `bgs_kb` MCP servers are declared in [`.mcp.json`](./.mcp.json) and resolve via `${CLAUDE_PLUGIN_ROOT}`.

### Codex

Start a Codex session and paste this prompt. Your Codex agent does the install for you:

> Install the bgs-modding-superpowers plugin from `https://github.com/BB-84C/bgs-modding-superpowers`. Run these two commands and report back what `codex mcp list` shows afterwards:
>
> ```
> codex plugin marketplace add BB-84C/bgs-modding-superpowers
> codex plugin add bgs-modding-superpowers@bgs-modding-superpowers
> ```
>
> Both `xedit` and `bgs_kb` MCP servers should appear in `codex mcp list` after install — Codex auto-imports them from the plugin's `.mcp.json`. If either is missing or any step fails, surface the exact error rather than working around it.

That's it. After install, restart any open Codex session so the new skills and MCP servers load.

**Manual install** (same two commands, run yourself):

```text
codex plugin marketplace add BB-84C/bgs-modding-superpowers
codex plugin add bgs-modding-superpowers@bgs-modding-superpowers
```

**Update later** with:

```text
codex plugin marketplace upgrade bgs-modding-superpowers
```

The repo carries the materialized plugin tree at `plugins/bgs-modding-superpowers/` (Codex's marketplace schema requires the subdirectory layout). Source-of-truth files at the repo root are mirrored there by `scripts/build-portable-plugin.ps1` on every release.

## First run

Start any session in your modpack project directory and ask:

> Set up the BGS modding environment.

The `setting-up-bgs-modding-environment` skill will detect MO2, install the control plane, optionally fetch xEdit from [BB-84C/TES5Edit](https://github.com/BB-84C/TES5Edit), and initialize your dev-log + release-changelog.

You can install MO2 yourself, ask the agent to install it (explicit consent), or run in "no MO2" mode for documentation-only work.

## Requirements

- Windows. The MO2 control plane and xEdit hook bridge are Windows-only by design (modpack work is Windows-anchored).
- A target game: Skyrim SE/AE, Fallout 4, Fallout 76, or Starfield. Skyrim LE and Oblivion can work but are untested.
- Node 22+ (the bundled MCP servers run on Node).

## Pointing the xEdit MCP at your own MO2 install

Out of the box the `xedit` MCP server has no idea where your MO2 install lives. Tell it via the `BGS_MO2_ROOT` env var on the MCP server entry in your harness config; the value is the absolute path to the directory containing `ModOrganizer.exe`.

Examples:

- OpenCode (`~/.config/opencode/opencode.json`, harness MCP block — set the env on the `xedit` server entry):

  ```json
  {
    "mcp": {
      "xedit": { "env": { "BGS_MO2_ROOT": "D:\\Starfield MO2" } }
    }
  }
  ```

- Codex (`~/.codex/config.toml`, after `codex plugin add`):

  ```toml
  [mcp_servers.xedit.env]
  BGS_MO2_ROOT = "D:\\Starfield MO2"
  ```

- Claude Code: edit the materialized plugin's `.mcp.json` env block, or set the env var in the shell that launches Claude Code.

Once set, the launcher defaults to `<BGS_MO2_ROOT>/tools/xEdit/xEdit.exe` and resolves `plugins.txt` from `<BGS_MO2_ROOT>/profiles/<profile>/`. Per-call overrides (`xedit_start({ moRoot, launcherPath, ... })`) win over the env var. The `setting-up-bgs-modding-environment` skill detects your MO2 install during first-run and walks you through wiring the env var.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Internal design docs and plans live under [`docs/internal/`](docs/internal/).

## License

MIT. See [LICENSE](LICENSE).

© awesome-bgs-mod-master contributors · MIT · hashgraph-online/awesome-codex-plugins

Похожие плагины

Все плагины по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
Cities2 MCP and Modding Toolkit mayor-modder Локальный MCP-сервер Cities2 MCP and Modding Toolkit для вопросов о Cities: Skylines II и разработки модов. Подключает вики, исследовательские отчёты и энциклопедию игры. CX Codex +1 ★ 12звёзд репо unity-modding JosiahSiegel Скилл unity-modding помогает спроектировать моддинг Unity: загрузку ассетов, Lua-скрипты, менеджер модов и интеграцию со Steam Workshop. CX Codex +1 132установок reverse-engineering rehan-remade Скилл reverse-engineering учит агента разбирать игровой код и форматы данных для моддинга. Декомпилирует .NET, IL2CPP, Java и нативный код, читает память процесса и дампит GPU-кадры. CX Codex +1 2 200установок mod-any-game rehan-remade Скилл mod-any-game для создания модов к ПК-играм: от разведки движка и резервных копий сейвов до генерации ассетов и сборки первого рабочего прототипа. CX Codex +1 2 100установок minecraft-modding Jahrome907 Скилл minecraft-modding пишет и правит код модов Minecraft под NeoForge, Fabric 26.x, 1.21.x и Forge 1.20.1. Определяет платформу по gradle.properties и build.gradle перед тем, как трогать код. CX Codex +1 966установок console-sound Jake Schincariol Скилл console-sound для Claude Code извлекает аудиодорожки из файлов PS2 и добавляет в них собственные записи. Он работает с форматами VAG и SPU2 ADPCM, преобразуя их в WAV для редактирования. CX Codex +1 ★ 449звёзд репо

Из того же набора391

Весь набор →
casefile Плагин casefile ведёт журнал уязвимостей для CTF, аудитов и bug bounty с автоматической проверкой PoC в Docker. CX Codex ★ 1 596звёзд репо bringyour-migration-auditor Плагин bringyour-migration-auditor проверяет проект после переноса с Claude на Codex: охват AGENTS.md и CLAUDE.md, хуки, MCP-конфиг, скиллы и ссылки на секреты. Пригодится до первой правки кода агентом. CX Codex ★ 1 596звёзд репо boss Организует разработку через девять ролей от сбора требований до деплоя. Фиксирует артефакты каждого шага в папку .boss/ и проверяет контракты качества. CX Codex ★ 1 596звёзд репо bindry Собирает Bindry Binder в навыки с фиксацией версии или живой загрузкой через MCP. Подключает инструкции по задаче. CX Codex ★ 1 596звёзд репо babok_analyst Плагин babok_analyst ведёт бизнес-анализ по стандарту BABOK v3 через 9 этапов с подтверждением человека на каждом шаге. CX Codex ★ 1 596звёзд репо aw1-circuit-breaker Плагин aw1-circuit-breaker проверяет AST и аргументы вызовов инструментов до выполнения Python. Он пригодится, чтобы блокировать динамический запуск кода, shell-вызовы и сетевые подключения. CX Codex ★ 1 596звёзд репо auto-pilot Плагин auto-pilot превращает короткий запрос в Codex в разбор по одному вопросу, фиксирует договорённости в файлах проекта и даёт вернуться к работе в новой сессии. CX Codex ★ 1 596звёзд репо atomlane Плагин atomlane для Claude Code безопасно запускает параллельно сборки, тесты и фоновые задачи агента, проверяя зависимости. При риске конфликта выполняет шаги по очереди. CX Codex ★ 1 596звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой