# minecraft-testing

Скилл minecraft-testing пишет и запускает автотесты для модов и плагинов Minecraft на JUnit, MockBukkit, NeoForge GameTests и Fabric GameTests.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 386 установок · ★ 211 у репозитория
- Автор: Jahrome907
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/Jahrome907/minecraft-agent-skills/tree/HEAD/plugins/minecraft-codex-skills/skills/minecraft-testing/SKILL.md
- Обновлён: 2026-10-30
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/minecraft-testing

## Что делает

Скилл берёт на себя выбор подхода к тестированию: чистые юнит-тесты на JUnit Jupiter для логики и NBT-сериализации, MockBukkit для событий, команд и инвентаря Bukkit/Paper-плагинов, GameTests у NeoForge и Fabric для проверки блоков, сущностей и мира прямо в игровом окружении. Внутри — готовые примеры кода для каждого случая: настройка `build.gradle.kts`, паттерны setUp/tearDown для MockBukkit, тесты на события (`PlayerJoinEvent`, `BlockBreakEvent`), команды плагина, инвентарь и планировщик.

Есть встроенный валидатор `./scripts/validate-test-layout.sh --root <project>`: он проверяет статические зависимости, метаданные и структуру тестового layout перед тем, как копировать его в реальный проект, но не компилирует проект и не доказывает, что Game Test реально запустится. Для 26.x проектов скилл требует Java 25, для legacy 1.21.x — Java 21, а для Forge 1.20.1 — Java 17; версии и API разных линий смешивать нельзя. Скилл не занимается реализацией самой игровой механики и не публикует релизы — для этого в наборе есть отдельные скиллы `minecraft-modding`, `minecraft-plugin-dev` и `minecraft-ci-release`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-testing -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/minecraft-testing/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/minecraft-testing/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-testing -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/minecraft-testing/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-testing -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Jahrome907/minecraft-agent-skills plugins/minecraft-codex-skills/skills/minecraft-testing
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/minecraft-testing/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-testing -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Jahrome907/minecraft-agent-skills --path plugins/minecraft-codex-skills/skills/minecraft-testing
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/minecraft-testing/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-testing -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Jahrome907/minecraft-agent-skills/tree/HEAD/plugins/minecraft-codex-skills/skills/minecraft-testing/SKILL.md

## Когда брать
- написать юнит-тесты для NBT-сериализации и игровой логики без запуска Minecraft
- проверить обработку событий Bukkit/Paper-плагина через MockBukkit
- протестировать команды и права доступа плагина
- покрыть тестами взаимодействие блоков и сущностей через NeoForge или Fabric GameTests
- проверить layout тестов перед переносом в проект

## Примеры запросов агенту
- Напиши юнит-тест для CooldownManager на JUnit Jupiter
- Настрой MockBukkit-тест для события PlayerJoinEvent в моём Paper-плагине
- Проверь layout тестов через validate-test-layout.sh перед тем, как копировать его в проект

## Похожие
- [minecraft-bukkit-pro](https://affpapa.org/nevibecode/skills/minecraft-bukkit-pro.md) — скилл · 131 установка
- [minecraft-plugin-development](https://affpapa.org/nevibecode/skills/minecraft-plugin-development.md) — скилл · 485 установок
- [minecraft-mcp](https://affpapa.org/nevibecode/mcp/minecraft-mcp.md) — MCP-сервер · ★ 26 у репозитория
- [create-simulated-aeronautics-mod](https://affpapa.org/nevibecode/skills/create-simulated-aeronautics-mod.md) — скилл · 398 установок
- [game-development](https://affpapa.org/nevibecode/plugins/game-development.md) — плагин · ★ 42780 у репозитория
- [code-testing-extensions](https://affpapa.org/nevibecode/skills/code-testing-extensions.md) — скилл · 4600 установок

Из того же набора: [jahrome907/minecraft-agent-skills](https://affpapa.org/nevibecode/by/jahrome907/minecraft-agent-skills.md) — 13 карточек

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