# minecraft-server-admin

Скилл minecraft-server-admin для Claude Code ведёт Java-серверы Minecraft: Paper, Purpur, Folia, Velocity, Fabric и NeoForge. Разбирает падение TPS, отказ прокси и ошибки запуска версии.

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

## Что делает

Скилл закрывает инфраструктуру и живую эксплуатацию: выбор стека, тюнинг, бэкапы, прокси, разбор инцидентов. Внутри таблица деплоя — небольшой SMP на Paper, Purpur когда нужны игровые ручки в конфиге, Folia только после проверки плагинов на совместимость с региональными потоками, Velocity когда одного процесса мало, Fabric или NeoForge когда требование идёт от модов. Код плагинов и модов вне его области, как и WorldEdit, EssentialsX, датапаки.

Тюнинг идёт по шагам: снять базу (`tps`, `mspt`, `spark healthreport`), прогнать `spark profiler --timeout 180`, найти узкое место, менять по одной группе настроек и проверять результат. Прокси-часть расписывает forwarding: `velocity.toml` на прокси, `online-mode=false` на бэкенде и общий секрет строкой в `config/paper-global.yml`.

Ломается всё чаще на Java: Paper 26.1+ требует Java 25, а 1.21.x живёт на Java 21, поэтому смену версии начинают с проверки сборки и списка плагинов. Перед окном раскатки или инцидентом скилл велит открыть `references/deployment-checklists.md`.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/minecraft-server-admin/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-server-admin
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-server-admin -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-server-admin/SKILL.md

## Когда брать
- выбрать между Paper, Purpur, Folia и Velocity под нагрузку сервера
- снять профиль Spark и найти, что просаживает MSPT
- настроить forwarding между Velocity и Paper-бэкендом
- откатить пачку плагинов после регрессии на проде
- подобрать JDK под версию сервера

## Примеры запросов агенту
- Сервер на Paper лагает при онлайне 25 человек — сними профиль и скажи, что менять первым.
- Поставь Velocity перед двумя Paper-бэкендами, секрет возьми из `forwarding.secret`.
- Распиши окно раскатки обновления плагинов с откатом и проверками после старта.

## Похожие
- [minecraft-bukkit-pro](https://affpapa.org/nevibecode/agents/minecraft-bukkit-pro.md) — субагент · ★ 42780 у репозитория
- [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 у репозитория
- [mc-asset — Minecraft Pixel Asset Engine](https://affpapa.org/nevibecode/mcp/mc-asset-minecraft-pixel-asset-engine.md) — MCP-сервер · ★ 5 у репозитория
- [Minecraft Wiki](https://affpapa.org/nevibecode/mcp/minecraft-wiki.md) — MCP-сервер
- [Minecraft](https://affpapa.org/nevibecode/mcp/minecraft.md) — MCP-сервер

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

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