HermesGod

HermesGod

Всеведущее ИИ-божество обитает в вашем мире Minecraft — оно видит всё, что делают игроки, динамично подшучивает над ними, помогает с ресурсами или просто болтает.

Что такое HermesGod?

HermesGod — это не бот и не NPC. Это божество мира — настоящий интеллект на базе LLM, который воспринимает весь ваш мир Minecraft и реагирует через серверные команды. Поговорите с ним. Разозлите его. Попросите помощи. Он ответит. Он работает на любой LLM, которую вы настроите (OpenAI, Anthropic, MiniMax, DeepSeek или любой API, совместимый с OpenAI).

Как это работает

HermesGod подключается к API LLM и передаёт ей полное состояние мира: позицию каждого игрока, здоровье, инвентарь, броню, биом, достижения, даже скорость и уровень освещения. ИИ думает на естественном языке, а затем выдаёт JSON-команды, которые выполняются на сервере. Это значит, что каждый ответ уникален — никаких скриптов, никаких захардкоженных пранков. ИИ решает, что делать, на лету.

Режимы

🌱 Eco Mode — Хранитель

Общайтесь с HermesGod в чате. Просите снаряжение, ресурсы, мобов или просто болтайте. Он умеет:

• Выдавать предметы и снаряжение
• Призывать мобов для тренировки
• Строить структуры вокруг вас
• Объяснять игровые механики
• Или просто говорить, ничего не делая

«Мне нужна железная броня» → Вы получаете железную броню «Научи меня PvP» → Появляется туториал + мобы для практики «Просто поболтаем» → Он говорит, команды не выполняются

👻 Prank Mode — Трикстер

ИИ молча подшучивает над игроками с динамической сложностью, которая растёт вместе с их прогрессом:

Уровень	Что происходит
1	Жуткие звуки, частицы портала, мерцающий свет, дезориентирующие телепорты
2	Засады монстров, кража предметов, негативные эффекты, тыква на голове
3	Ловушки с лавой, обсидиановые тюрьмы, клыки вызывателя, TNT, элитные мобы
4	Визеры, вардены, сброс в пустоту, полномасштабные вторжения

Сложность рассчитывается по дням в игре, броне, достижениям и измерению. Спидраннеры получают эскалацию быстрее. Новые игроки получают мягкие пугалки. ИИ помнит, что делал в прошлый раз (до 10 действий), чтобы не повторяться.

Другие режимы (в разработке)

В разработке...

Команды

Команда	Что делает
/hermesgod mode <eco/prank/disabled>	Переключить режим
`/hermesgod chat `	Поговорить с HermesGod из консоли
/hermesgod status	Показать текущий режим, статус API, последнее действие
`/hermesgod interval `	Задать фиксированный интервал размышлений для пранков (например, interval 60 = каждые 60с). Установите 0, чтобы отключить
`/hermesgod interval `	Случайный интервал между min и max секундами (например, interval 30 90)
`/hermesgod api `	Задать API-ключ прямо в игре
`/hermesgod url `	Задать URL эндпоинта API прямо в игре
`/hermesgod model `	Задать имя модели LLM
`/hermesgod maxtokens `	Задать максимум токенов на вызов API (1~32000)
/hermesgod reset	Очистить историю диалога
/hermesgod config	Просмотреть все текущие настройки
/hermesgod help	Показать все команды

---

Установка

1. Установите Minecraft Forge 1.20.1
2. Положите .jar в папку mods
3. Запустите игру — создастся config/hermesgod.json
4. Отредактируйте конфиг, указав свой API-ключ и эндпоинт:

{
  "apiEndpoint": "https://api.openai.com/v1/chat/completions",
  "apiKey": "sk-your-key-here",
  "modelName": "gpt-4o-mini",
  "currentMode": "eco"
}

5. Перезапустите и введите /hermesgod help Работает в одиночной игре и на выделенных серверах (только на стороне сервера — клиентам мод не нужен).

---

Конфигурация

Все настройки в config/hermesgod.json:

Настройка	По умолчанию	Описание
apiEndpoint	https://api.minimaxi.com/v1/chat/completions	API, совместимый с OpenAI
apiKey	""	Ваш API-ключ
modelName	MiniMax-M2.7-highspeed	Модель LLM
currentMode	disabled	Стартовый режим
chatEnabled	true	Разрешить взаимодействие через чат
prankIntervalMin	30	Мин. секунд между размышлениями о пранках (0 = выкл.)
prankIntervalMax	30	Макс. секунд между размышлениями о пранках
maxTokens	8000	Макс. токенов на вызов API
temperature	0.8	Креативность ИИ

---

Требования

• Minecraft 1.20.1 Forge (47.3.0+)
• Java 17+
• API-ключ выбранного вами провайдера LLM

---

Стоимость API

HermesGod обращается к API вашего провайдера LLM. В Eco-режиме — только когда игрок отправляет сообщение в чат. В Prank-режиме — каждые 30 секунд (настраивается). Используйте лёгкие модели вроде gpt-4o-mini или MiniMax-M2.7-highspeed, чтобы снизить затраты.

FAQ

В: Это чит-клиент? О: Нет. Это серверный мод, использующий OP-команды. Он не даёт ни одному игроку несправедливого преимущества. В: Можно ли использовать его на моём мультиплеерном сервере? О: Да. Установите на сервер. Нужен только один API-ключ. В: Почему ИИ не отвечает? О: Проверьте API-ключ, эндпоинт и интернет. Ошибки логируются в logs/latest.log. В: Можно ли добавить свои пранки? О: Система пранков управляется промптами. Отредактируйте HermesBrain.java, чтобы добавить свои описания трюков.

HermesGod наблюдает. HermesGod ждёт. HermesGod решает.