bgs-modding-superpowers — плагин для Claude Code
Плагин bgs-modding-superpowers для сборки модпаков Bethesda: два MCP-сервера, аудит конфликтов в xEdit и управление MO2 прямо из сессии агента.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install bgs-modding-superpowers@awesome-codex-pluginsЧто делает 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