Nexa AI Chat

Nexa AI Chat - это не просто очередной чат-бот, а полноценный ИИ-агент для Майнкрафт. По факту, мод (или плагин для Paper) внедряет в игру умного напарника, который сидит в чате и готов помочь в любую секунду. Устал гуглить команды или координаты? Просто спроси Nexa. Он контекстно понимает окружение, знает твое здоровье, биом и инвентарь, поэтому его ответы реально полезны.

Зачем нужен этот проект

В ванильном Minecraft часто не хватает интерактива. С этим модом ты можешь попросить агента найти деревню, поменять погоду на ясную или выдать эффект скорости. Причем он работает как на клиентах, так и на серверах. Если ты держишь сервер на BungeeHost, плагин установится буквально в 1 клик, а игрокам даже не придется ничего качать - весь функционал работает через серверный чат.

Основные фишки

• Прямой чат с Nexa: пишешь /nexa <сообщение> и общаешься.
• Режимы агента: Ask-before-act (спроси-прежде-делать) - показывает превью действия и ждет подтверждения. И Autonomous - сам выполняет разрешенные шаги, но в рамках лимитов.
• Серверные ограничители: лимиты запросов на игрока и глобальный кулдаун на инструменты. Спасает от спама.
• Кастомизация: можно задать свое имя ассистенту и промпт для его характера.
• Клиентский GUI: нажми N или юзай /nexa-gui, чтобы открыть настройки (только для клиентов на Fabric/Forge/NeoForge).
• Встроенные инструменты: анализ скриншотов, получение инфы об окружении и вызов серверных команд.

Команды и настройка

Короче, управление всем хозяйством происходит через группу команд /nex-config. Вот основные:

• /nexa <message> - чат с Nexa.
• /nexa confirm / /nexa cancel - подтвердить или отменить queued-действия.
• /nex-config mode <ask|autonomous> - выбрать режим работы.
• /nex-config limits maxrequests <1..15> - лимит запросов (для админов).
• /nex-config limits cooldown <seconds> - кулдаун на инструменты (для админов).
• /nex-config custom name <name> / /nex-config custom prompt <prompt> - настроить имя и характер ИИ.

BYOK (Bring Your Own Key) - своя нейронка

Это киллер-фича. Каждый игрок может юзать свой собственный API-ключ или даже локальную нейросеть. Управляется через /nex-byok. Поддерживаются Google Gemini, OpenAI, Ollama (локально), LM Studio и кастомные OpenAI-compatible эндпоинты.

Совет от опытного игрока: Если играешь на слабом ПК и хочешь юзать локальную LLM через Ollama, не ставь тяжелые модели типа 70B. Система просто зависнет. Бери квантованные модели вроде Q4_K_M, они потребляют меньше памяти и нормально отвечают в чат.

Инструменты Nexa (Function Calling)

Nexa может вызывать встроенные тулзы. Зависит от прав.

Доступно всем:

• getPlayerState - инфа о игроке (позиция, здоровье, режим игры).
• getInventorySummary - анализ инвентаря и брони.
• getEnvironmentInfo - время, погода, биом.
• getNearbyEntities - поиск мобов и игроков в радиусе 48 блоков.
• saveLocation / listSavedLocations - сохранение и просмотр кастомных точек.
• analyzeScreenshot - делает скриншот экрана и анализирует его визуально (нужен клиентский мод).

Требует админку (nexa.admin):

• locate - поиск структур (деревни, крепости) или биомов.
• teleport - телепортация по координатам.
• timeSet - установка времени (день/ночь).
• weather - смена погоды.
• giveEffect - выдача эффектов с настройкой длительности.
• spawnEntity - спавн мобов (до 20 штук за раз).

Права и установка

Для гранулярной настройки прав на серверах Minecraft используется LuckPerms. Ноды: nexa.use (для всех) и nexa.admin (для админов). Если LuckPerms нет, права откатываются на ванильные OP или Creative в одиночке.

Версии и загрузчики:

• Fabric, Forge, NeoForge для Minecraft 26.2.
• Paper для Minecraft 26.1.2 - 26.2+.
• Для работы требуется Java 25.

Скачайте мод Nexa AI для Майнкрафт, закиньте jar-файл в mods или plugins (если Paper), и запустите игру. Серверная часть работает даже без клиентского мода, но если поставить мод на клиент, откроется GUI по кнопке N и заработает анализ скриншотов.

Важный нюанс: Если держишь сервер на BungeeHost, обязательно настрой кулдауны на инструменты. Иначе игроки зафлудят запросы и забьют лимиты дефолтного API, из-за чего Nexa просто перестанет отвечать. Используй /nex-config limits cooldown.