# minecraft-bukkit-pro

Субагент для разработки серверных плагинов Minecraft на Bukkit, Spigot и Paper. Пригодится, когда нужны события, команды, GUI или оптимизация тиков.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 41729
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/game-development/agents/minecraft-bukkit-pro.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/minecraft-bukkit-pro

## Что делает

Субагент разбирается в серверных API Minecraft: событийная архитектура с приоритетами листенеров, свои события, команды на Brigadier с автодополнением, инвентарные GUI с NBT, генерация мира и работа с чанками, кастомный ИИ сущностей. Отдельный пласт — внутренности NMS, маппинги Mojang, работа с пакетами и рефлексия для совместимости между версиями, а также `paperweight-userdev` для деобфусцированной разработки.

Производительность здесь не общий лозунг: агент смотрит на горячие события вроде `PlayerMoveEvent` и `BlockPhysicsEvent`, выносит I/O и запросы к базе в async, разбирается с загрузкой чанков и настройкой сборщика мусора. Профилировать советует до оптимизации, а не после. Ещё он умеет встраиваться в экосистему — Vault, PlaceholderAPI, ProtocolLib, базы через HikariCP, очереди сообщений, вебхуки, Docker.

Работает он по своим правилам: сначала ищет актуальные практики через веб-поиск, определяет тип сервера и только потом выбирает API. Тесты — MockBukkit для юнитов и реальный сервер для интеграции. Учтите: модель в конфигурации — `opus`, поэтому запуск на объёмных задачах обойдётся дороже, чем на дефолтной модели. Для Cursor и Codex файл субагента просто кладут в проект, без маркетплейса.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install game-development@claude-code-workflows
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/minecraft-bukkit-pro.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/minecraft-bukkit-pro.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/minecraft-bukkit-pro.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/game-development/agents/minecraft-bukkit-pro.md

## Когда брать
- написать плагин под Paper с событиями и своими листенерами
- сделать команду с автодополнением на Brigadier
- собрать инвентарный GUI с NBT-данными
- починить просадку TPS из-за горячих событий
- поддержать одну кодовую базу на Bukkit, Spigot и Paper

## Примеры запросов агенту
- Спроектируй плагин под Paper: событие входа игрока и выдача стартового набора
- Добавь команду `/kit` с автодополнением по названиям наборов
- Разберись, почему проседает TPS: посмотри горячие события и async-задачи

## Похожие
- [minecraft-plugin-development](https://affpapa.org/nevibecode/skills/minecraft-plugin-development.md) — скилл · 485 установок
- [minecraft-modding](https://affpapa.org/nevibecode/skills/minecraft-modding.md) — скилл · 737 установок
- [blockbench-modeling](https://affpapa.org/nevibecode/skills/blockbench-modeling.md) — скилл · 1300 установок
- [blockbench-animation](https://affpapa.org/nevibecode/skills/blockbench-animation.md) — скилл · 1100 установок
- [new-unity-project](https://affpapa.org/nevibecode/skills/new-unity-project.md) — скилл · 6400 установок

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 371 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md