NSR-AI (Эн эс ар АИ)

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

Возможности

• Работает с Gemini, Claude и OpenAI; для запросов можно задать несколько ключей и переключаться между моделями.
• База knowledge.json превращается в источник ответов для ИИ: он ищет подходящую информацию по смыслу вопроса.
• История разговора автоматически сжимается в краткую память, чтобы сохранялся контекст длинной беседы.
• Игроки могут сохранять разговоры, возвращаться к контрольным точкам и удалять их.
• Система питомцев связывает прирученного моба с ИИ: у питомца есть настроение, уровень связи, инвентарь, прозвище и временный доступ для друзей.
• Режим приватности скрывает имена игроков и IP-адреса перед передачей запроса внешнему поставщику ИИ.
• Дополнения подключаются через /aia и могут обрабатывать сообщения игроков и ответы ИИ.

Команды

Основные команды:

• /ai <сообщение> — начать или продолжить разговор с ИИ.
• /ai data <запрос> — поиск по базе знаний сервера.
• /ai settings — открыть настройки контекста и автоматического сжатия памяти.
• /ai cache <clear|refresh> — очистить или обновить текущую сессию.
• /ai memory <clear|refresh> — управлять памятью разговора.
• /ai opt <in|out> — включить или выключить режим приватности.
• /ai help — показать доступные команды.

Ключи и сохранённые беседы:

• /ai apikey — показать способ добавления ключа.
• /ai apikey list — вывести активные и сохранённые ключи.
• /ai apikey store <projectId> — сохранить ключ.
• /ai apikey model <key-id> <new-model> — выбрать модель для ключа.
• /ai apikey clear [all|key-id] — удалить ключ или список ключей.
• /ai chat save <chat-name> — сохранить разговор.
• /ai chat list [chat-name] — посмотреть сохранённые беседы и их точки восстановления.
• /ai chat resume <chat-name> [checkpoint#] — продолжить сохранённую беседу.
• /ai chat delete <chat-name> [checkpoint#|all] — удалить беседу или её точки восстановления.

Питомцы:

• /ai pet tame — связать с системой названного питомца, на которого смотрит игрок.
• /ai pet info [pet_name] — посмотреть характеристики питомца.
• /ai pet nickname <nickname> — задать прозвище.
• /ai pet inv [pet_name] — открыть инвентарь питомца.
• /ai pet inv allow <pet_name> <player_name> и /ai pet inv disallow <pet_name> <player_name> — выдать или отозвать доступ к инвентарю.
• /ai pet share <pet_name> [allow] [relationship] — создать временную связь с питомцем.

Для администрации доступны /ai admin <activation_code>, /ai add <keyword>, <message_content>, /ai remove <keyword>, /ai reload [f|features|nsr-ai|k|knowledge|c|config], /ai data all <page>, /ai cache <clear|refresh> <player|all>, /ai memory <clear|refresh> <player|all>, а для управления расширениями — /aia addon и /aia plugin.

Права

• nsr-ai.use — пользоваться командой /ai.
• nsr-ai.admin — административные команды ИИ.
• nsr-ai.reload — перезагрузка конфигурации.
• nsr-ai.pet — взаимодействие с питомцами.
• nsr-ai.aia — управление расширениями через /aia.

Настройка

В config.yml указываются ключи в списке api-keys, модель по умолчанию для Gemini, Claude и OpenAI, а также поставщик по умолчанию default-api-provider. В features.yml настраиваются цвета и префиксы сообщений, системная инструкция ИИ, лимит контекста global-max-context-tokens, автоматическое обновление памяти, переключатели команд и задержка между запросами chat-cooldown.

Требования

Для работы нужен ключ API одного из поставщиков: Gemini, Claude или OpenAI. Ключ сервера добавляется в config.yml после первого запуска; игроки также могут использовать собственные ключи через /ai apikey.