SecondBrain

SecondBrain

Мод на Fabric, который добавляет в ваш мир Minecraft умных NPC. Создавайте персонажей, похожих на игроков, управляемых LLM, которые отвечают на ваши сообщения в чате и выполняют базовые действия игрока.

Этот мод полностью работает на стороне сервера. Для настройки его также нужно установить на клиент.

Требования

• Версия Minecraft: 1.20.1/1.21.1
• Запущенный сервер Ollama ИЛИ приложение Player2 ИЛИ ключ OpenAi

Установка мода

1. Скачайте мод:

   • Возьмите последнюю версию мода SecondBrain со страницы Modrinth.

2. Установите мод:

   • Поместите secondbrain.jar в папку mods на вашем сервере и клиенте Minecraft fabric.

3. Запустите Minecraft:

   • Запустите клиент Minecraft и сервер — и всё готово!

Использование с Ollama/OpenAi

Примечание: игрок должен быть оператором, чтобы выполнять следующие команды

GUI

• Откройте gui командой /secondbrain и создавайте/призывайте, убирайте/удаляйте или редактируйте там NPC.
• Там же редактируется базовая конфигурация.

Команды (Устарело)

Внимание: эта команда использует настройки ollama/openai по умолчанию!

1. Призыв NPC:

   • ~~Используйте команду `/secondbrain add <openai|ollama>(сейчас поддерживается только ollama), чтобы создать NPC. (Пример:/secondbrain add sailex428 OLLAMA)~~

2. Удаление NPC:

   • ~~Используйте команду `/secondbrain remove `, чтобы убрать NPC из игрового мира.~~

Взаимодействие с NPC:

• Просто пишите в чат, чтобы взаимодействовать с NPC.

Настройка Ollama

Ollama (локальная LLM)

1. Скачайте Ollama:

   • Зайдите на сайт Ollama и скачайте установщик для вашей операционной системы.

2. Установите и запустите Ollama:

   • Следуйте инструкциям по установке.
   • Запустите Ollama и убедитесь, что она работает в фоне.

3. Подключите к моду:

   • Через gui создайте/отредактируйте NPC и впишите адрес вашего сервера ollama (полный url с http://...; если вы запускаете ollama на своём локальном ПК, можно просто оставить уже вписанный)

Настройка OpenAi (платно)

1. Создайте API-ключ

   • Зайдите на сайт OpenAi, зарегистрируйтесь/войдите и создайте API-ключ
   • Скопируйте созданный ключ

2. Используйте ключ в моде

   • Откройте GUI и создайте NPC с типом LLM OPENAI, затем вставьте ключ в поле Key. (Ключ никогда не будет передан другим клиентам, у которых есть доступ к GUI, в том числе и вашему клиенту. Он сохранится в конфиг-файле secondbrain на сервере)

Использование с приложением Player2

Мод автоматически синхронизирует выбранных персонажей из приложения player2 с NPC в вашем одиночном мире. Если вы обновили описание/имя в приложении player2, синхронизировать эти изменения можно командой /secondbrain player2 SYNC С помощью этого мода нельзя менять какие-либо настройки персонажа.

Взаимодействие с NPC

• Пишите сообщения в чат или напрямую конкретному NPC
• Зажмите клавишу alt (win) или opt (macOS), чтобы говорить напрямую с LLM/AI
• Включите Text-To-Speech для любого NPC в gui настроек, чтобы слышать вывод LLM/AI

Настройка Player2 (бесплатно, с ограничениями)

1. Скачайте приложение Player2

   • Зайдите на сайт player2 и скачайте приложение для вашей операционной системы.

2. Запустите приложение и выберите персонажей

   • Запустите скачанное приложение и выберите персонажей, которых хотите использовать как NPC

Лицензия

Этот проект распространяется под лицензией LGPL-3.0

Отказ от ответственности

Благодарности

Этот проект использует компоненты из следующих проектов:

• fabric-carpet
• automatone
• player2

Спасибо разработчикам этих проектов за их потрясающую работу!