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 — они работают сразу, без какой-либо конфигурации.