AI Chatbot (АИ чатбот)

Мод для Майнкрафт для серверов, который добавляет в чат ИИ-помощника. Он отвечает на вопросы игроков на основе правил, лора и сведений, которые задаёт владелец сервера, а не на основе заранее заполненной информации.

Возможности

• Игроки задают вопрос сообщением !ai <вопрос>; префикс можно изменить через askPrefix.
• Помощник использует сведения из server-info.md и файлов Markdown в папке kb/, поэтому ему можно передать правила, команды, описание игровых механик и лор сервера.
• Есть приветствия при входе игроков, режимы общения friendly и trashtalk, настройка имени, цвета и жирности сообщений.
• Сохраняется контекст диалогов отдельных игроков и всего сервера, включая перезапуски.
• Помощник может выдавать предметы по запросу. Эту функцию включает itemGiving.enabled; для неё задаются лимиты itemGiving.maxPerDay, itemGiving.maxQuantity и itemGiving.maxEquipmentQuantity.
• Вопросы нескольких игроков объединяются в один запрос к ИИ, а при недоступности выбранной модели используются другие модели из списка ai.models.
• Приветствия и ответы можно дублировать в канал Discord через входящий вебхук.

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

Заполните server-info.md краткими сведениями о сервере, а дополнительные материалы поместите в kb/ в виде файлов .md. Эти данные перечитываются при каждом вопросе.

Для управления настройками в игре доступны команды:

• /mcaichatbot config — список изменяемых параметров и их значений.
• /mcaichatbot get <key> и /mcaichatbot set <key> <value> — просмотр и изменение параметра.
• /mcaichatbot models list|add|remove <id> — просмотр и редактирование списка моделей.
• /mcaichatbot reload — повторное чтение config.yml, server-info.md и kb/.

После изменения через set, add или remove настройки перечитываются автоматически. Ключ ai.apiKey меняется только в config.yml и не выводится командами.

Настройки

Основные параметры находятся в config.yml: botName, chatStyle, personality, askPrefix, batchWindowMs, maxAsksPerWindow, askCooldownSeconds, maxAskSubparts и broadcastReplies.

Для выдачи предметов используется блок itemGiving. Discord-вебхук задаётся в discord.webhookUrl; пустое значение оставляет пересылку выключенной.

Требования и совместимость

Мод работает на серверах Paper, Fabric, Forge и NeoForge. Для генерации ответов нужен собственный ключ API совместимого ИИ-провайдера: по умолчанию настроен Groq, также поддерживаются совместимые с OpenAI API сервисы, OpenRouter, Anthropic и локальный Ollama.

Текст вопросов игроков и указанный владельцем контекст сервера отправляются выбранному ИИ-провайдеру для создания ответа. Для команд администратора на Paper требуется право mcaichatbot.reload; на Fabric, Forge и NeoForge нужен уровень прав 4.