Issues для Minecraft: баг-репорты и идеи прямо в игре

Мод Issues для Minecraft: игроки пишут баги и идеи командами в чате, а админы читают отчёты и ведут разбор с Claude. Установка и настройка.

Issues: обратная связь от игроков без выхода из Minecraft

Каждый админ сервера Minecraft знает эту боль: игрок нашёл баг, но поленился зайти на форум или в Discord, и информация потерялась. Мод Issues решает проблему радикально — жалобы и предложения отправляются прямо из чата, а сервер сам сохраняет их в аккуратный журнал. Никаких веб-панелей, тикетов и потерянных сообщений.

Дополнение работает только на стороне сервера и совместимо с ванильными клиентами: игрокам ничего устанавливать не нужно. Поддерживаются актуальные версии Minecraft на загрузчике Fabric — проверьте страницу проекта для точного списка совместимых релизов.

Как игроки отправляют отчёты

Всё устроено предельно просто. В чате доступны две команды:

  • /bug <что случилось> — сообщить о поломке: зависший механизм, пропавший предмет, странное поведение моба.
  • /idea <что хотелось бы> — предложить изменение или новую фичу.

Длина отчёта ограничена размером обычного сообщения в чате, а отправлять их можно не чаще, чем раз в несколько секунд — спам-фильтр встроен. Каждый отчёт автоматически сохраняется вместе со временем отправки, ником игрока, его координатами и блоком, на который он смотрел. Это бесценно при разборе: не нужно расспрашивать, где именно всё сломалось.

Чтение отчётов администрацией

Команда /issues [count] доступна операторам и выводит последние сообщения — по умолчанию пять, максимум пятьдесят. Данные пишутся в файл server-issues.jsonl в папке сервера: одна строка JSON на отчёт, файл только дописывается и никогда не перезаписывается. Даже при краше потеряется максимум один отчёт, а читать журнал можно любым редактором или скриптом. Дублирующая строка попадает и в лог сервера.

Если вы ищете способ скачать Issues для Minecraft без возни с ручной сборкой, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений мод Issues находится в пару кликов, а версии подбираются автоматически под ваш сервер.

Режим Maintainers: разбор с Claude

Самая необычная часть мода — опциональная интеграция с Claude Code. Она выключена, пока сервер явно её не настроит. Суть в том, что назначенные игроки могут разбирать отчёты, общаясь с ИИ прямо из игры.

Основные команды

  • /maintain unlock <пароль> — разблокировка в начале визита; пять неверных попыток за десять минут блокируют имя.
  • /maintain start [номера] — новая сессия по конкретным отчётам, например /maintain start 12 14.
  • /claude <сообщение> — диалог с текущей сессией; ответы приходят в чат, а серые строки показывают выполненные команды и изменённые файлы.
  • /maintain sessions, /maintain join <id>, /maintain leave — список сессий и переключение между ними.
  • /maintain link — ссылка на сессию в браузере, действует сутки.

Сессия продолжает работать, даже когда за ней никто не следит. Claude читает отчёты, логи и историю изменений, сообщает в чат своё мнение и ждёт разрешения действовать. Правки выкатываются только по команде мейнтейнера: замена файлов перезапускает сервер и отключает всех игроков. Если Claude запрашивает разрешение или выбор, варианты появляются в чате кликабельными кнопками.

Настройка и безопасность

Конфигурация лежит в config/server-issues.json: блок paude содержит url, tokenFile (или token), project и browserUrl для команды /maintain link. Файл перечитывается при изменении. Важно понимать: сервер в offline-mode принимает любой ник, поэтому защита держится исключительно на пароле, а мейнтейнер получает права пользователя, от которого запущен сервер. Выдавайте доступ только тем, кому доверили бы шелл на этой машине.

Обработка крашей

После падения сервер при запуске фиксирует краш как баг-репорт от «сервера» с указанием причины — он появится в /issues наравне с остальными. Учитывается и запуск, завершившийся без корректного выключения, например от OOM-killer. Поведение задаётся параметром onCrash:

  • report — только запись отчёта.
  • investigate — Claude изучает краш-репорт и логи, но ничего не меняет без команды.
  • fix — при очевидной причине в одном моде Claude сам готовит и применяет небольшое исправление с перезапуском.
  • off — ничего не делать.

Краши в пределах часа объединяются в одну сессию, так что зацикленное падение разбирается как единая проблема. Тексты инструкций для ИИ можно заменить своими файлами в config, подставив переменные вроде {server} и {reports}.

Стоит ли ставить

Issues — редкий пример мода, который экономит время и игрокам, и администрации. Простые команды убирают барьер между находкой бага и его исправлением, журнал в JSONL удобен для автоматизации, а связка с Claude превращает разбор отчётов в живой диалог. Если вы хотите установить Issues для Minecraft на Fabric-сервер, начните с базовых команд /bug и /idea — они работают сразу, без какой-либо конфигурации.