PlayerActionLogger (PAL)

PlayerActionLogger (PAL)

PAL записывает в структурированный файл то, что делает ваш игрок, — файл рассчитан на чтение LLM, чтобы она могла комментировать вашу игру в реальном времени. В комплекте идёт опциональный Python-бот, который озвучивает комментарии вслух. Мод только клиентский: работает в одиночной игре и на любом сервере, серверу он не нужен, и он записывает только вашего игрока. Если вы делаете с ним видео, пожалуйста, укажите этот проект.

Как выглядит лог

Каждое событие — одна строка JSON с уровнем, чтобы читатель мог отличить чрезвычайную ситуацию от фонового шума:

В этом весь смысл уровня: он позволяет комментатору прервать себя ради Creeper и молчать на двухсотом блоке камня.

Что отслеживается

• Жизненные показатели — здоровье, голод, броня, опыт, эффекты состояния и моменты, когда что-то из этого становится опасным
• Бой — кого вы убили, кто убил вас, полученный урон и откуда он пришёл
• Добыча — найденные руды, итоги сессий, что вы на самом деле прокопали
• Строительство и контейнеры — установка блоков, сундуки, рабочие станции, крафт
• Опасность — приближающиеся враждебные мобы, лава, долгое падение, утопление
• Мир — биом, измерение, время суток, погода, высота
• Прогресс — достижения, повышения уровня, ванильная статистика
• Чат — что говорите вы, что говорят другие, какие команды вы выполняете

Живое состояние, а не только история

Помимо лога, мод каждую секунду перезаписывает player_state.json — лог говорит, что произошло, а этот файл — что верно прямо сейчас: Жизненные показатели, позиция, снаряжение с прочностью, весь инвентарь и ваша ванильная статистика. Это значит, что читатель может ответить на вопрос «сколько раз я умирал от лавы» или «что у меня в руках», не пересматривая весь лог.

Бот-компаньон (опционально)

Мод полезен сам по себе — всё, что умеет читать JSONL, может его использовать. Но в репозитории также есть Python-бот, который читает лог, отправляет его в Gemini и озвучивает ответ вслух, с локальной веб-панелью: Живые показатели, ваш инвентарь, отрисованный настоящими иконками предметов (включая предметы из модов — текстуры читаются из jar-файлов, которые у вас уже есть), лента событий, квоты API и запуск/остановка комментатора. Работает только на 127.0.0.1.

Версии

У сборки для NeoForge нет зависимостей — она использует собственные события NeoForge, так что встаёт прямо в модпак, ничего за собой не таща. Все сборки — один и тот же мод с одним и тем же номером версии: один набор функций, какой бы jar вы ни взяли.

Как использовать

1. Установите Fabric (или NeoForge для сборки под NeoForge) для вашей версии Minecraft.
2. На Fabric установите Fabric API.
3. Положите подходящий jar в mods/ — имя файла подскажет, для какой игры и загрузчика он.
4. Играйте. Запись начинается, как только вы заходите в мир. Куда попадают файлы: <ваша папка minecraft>/logs/player_actions/ — session.log для событий, player_state.json для живого снимка.

Зачем

Мод был сделан для LLM-комментариев — чтобы что-то реагировало на вашу игру, пока вы играете, — но лог это обычный JSONL без чего-либо специфичного для ИИ, так что он так же хорошо подойдёт для отслеживания игрового процесса, статистики или чего угодно ещё, что хочет знать, что вы делали. Исходники, Python-бот и баг-трекер: https://github.com/gigachadfr/PAL