AI NPCs

Модификация AI-NPC Launcher представляет собой специальную систему запуска и управления AI-NPC клиентом, позволяющую создавать виртуальных персонажей в Minecraft с впечатляющим функционалом. Эти NPC-персонажи способны свободно перемещаться по игровому миру, добывать ресурсы, атаковать противников, сбрасывать предметы и вести содержательные диалоги с реальными игроками.

Видео демонстрации мода скоро появится!

[tard64_7edzM]

Необходимые требования

Версия Minecraft: 1.20.4/1.21.2/1.21.3 (поддержка версии 1.20.1 готовится) Зависимости: FabricAPI и Java 17/21 Дополнительно: Работающий Ollama сервер или ключ OpenAI API (инструкции представлены ниже)

Сборка системы

1. Скачивание модификации

• Получите актуальную версию mod файла AI-NPC Launcher с официальных источников разработчика

2. Установка компонентов

• Разместите файл AI-NPC Launcher в папке mods на сервере Fabric

Локальная игра:

Установите дополнения custom-lan и cloth-config для корректной работы Откройте сетевую игру на порту 25565 через параметры custom-lan

Автономный NPC: Активируйте offline-mode и установите isOnline в false Онлайн NPC: Включите online-mode и поставьте isOnline в true (понадобится вход под аккаунтом Minecraft при создании NPC)

Многопользовательская игра / выделенный сервер:

Автономный режим: Перейдите к файлу server.properties, укажите онлайн-режим как выключенный и установите параметр isOnline в значение false Онлайн режим: Активируйте online-mode в server.properties и установите параметр isOnline как true. Потребуется указать учетные данные для входа в config/ai-npc-launcher/auth-config.properties

Для нескольких учетных записей разделяйте данные точкой с запятой

(Понадобится перезагрузка сервера после изменения параметров)

3. Запуск игры Подключитесь к серверу через клиент Minecraft - система готова к работе!

Управление персонажами

Основные команды (требуют операторских прав):

Конфигурационные настройки

• Используйте /setconfig <параметр> <значение> для кастомизации свойств
• Примеры параметров для задания значений: настройка безголового режима запуска npc.is_headless npc.llm.ollama.url # укажите адрес для локального сервера npc.server.port # выбор порта соединения

Создание персонажей

• Выполните команду /npc add <имя> <статус онлайн> <модель> <LLM тип>
• Пример создания: /npc add персонаж1 истина ollama gemma2
• Для онлайн персонажей укажите существующее имя игрока из аккаунта Minecraft

Удаление игровых объектов

• Используйте /npc remove <имя_персонажа> для удаления конкретного NPC

Взаимодействие с персонажами Общайтесь с ними через общий игровой чат!

Подключение интеллектуальной системы

Вариант 1: Ключ OpenAI API

Процесс настройки включает регистрацию аккаунта на платформе OpenAI, пополнение баланса и создание уникального API ключа. Указанные аутентификационные данные нужно внести в файл конфигурации.

Вариант 2: Локальный сервер Ollama

Ollama представляет собой открытую платформу для запуска языковых моделей прямо на локальном устройстве без необходимости во внешних API.

Этапы настройки Ollama: Получите дистрибутив оффициальном сайте Ollama Выполните установку по инструкциям для вашей операционной системы Загрузите рекоммендуемую языковую модель (например, gemma2) и модель эмбэдов nomic-embed-text Убедитесь, что сервер запущен в фоновом режиме Вызовите команду создания персонажа с указанием ollama в качестве источника LLM При необходимости задайте пользовательский адрес сервера через команду настройки npc.llm.ollama.url

Проект находится в активной стадии разработки. В будущем планируется расширить возможностя NPC.