Плагин для серверов Майнкрафт, который добавляет NPC с диалогами на основе языковой модели. Игрок начинает разговор правой кнопкой мыши, пишет в чат, а персонаж отвечает в заданной роли и может выдавать награды только после выполнения условия.
Возможности
- NPC поддерживают пять типов общения: торг, убеждение, допрос, принятие задания и свободный разговор.
- Для задач плагин отдельно проверяет итог диалога. После успеха выполняются команды из
on-success, при неудаче — изon-failure: можно выдать предмет, снять валюту или назначить право. - Торговцы умеют обсуждать цену и сделки с несколькими предметами. При
intelligent-quantity: trueпеременная%quantity%хранит число предметов, а%outcome%— общую цену сделки. - Для предложений торговца можно включить кнопки принятия и отказа в чате.
- NPC запоминают прошлые разговоры с каждым игроком отдельно; память сохраняется после перезапуска.
- Настраиваются сложность задачи, лимит реплик, завершение общения после результата и журнал диалогов для каждого NPC.
- Поддерживаются встроенные NPC-жители и NPC из Citizens2 с обликом игрока, движением и дополнительной настройкой.
- PlaceholderAPI подставляет значения других плагинов в приветствие и поле
system-prompt; также доступны%npcspeak_active_npc%,%npcspeak_exchange_count_<id>%и%npcspeak_task_status_<id>%. - Vault позволяет проверять баланс и использовать экономику в требованиях и наградах.
- Есть фильтр запрещённых фраз, потоковый вывод ответа в строке быстрого доступа и редактор характера и задач прямо в игре.
Команды
/npcspeak spawn <id> [name]— создать NPC на своей позиции./npcspeak remove <id>— удалить NPC./npcspeak list— показать загруженных NPC./npcspeak info <id>— показать данные NPC и его задачу./npcspeak edit <id> <field> <value>— изменить характер NPC; поля:name,greeting,prompt,topic,avoid,memory,maxinteractions,lockaftertask,logconversations./npcspeak task <id> <subcommand>— настроить задачу. Подкоманды:info,clear,type,goal,check,maxexchanges,difficulty,intelligentquantity,require,onsuccess,onfailure./npcspeak example <type>— создать пример NPC:negotiator,persuader,interrogator,questилиfree./npcspeak memory list <id>и/npcspeak memory clear <id> <player|*>— просмотреть или очистить память NPC./npcspeak log <id> [player]— показать журнал разговоров./npcspeak reload— перечитать настройки NPC из файлов./npcspeak acceptи/npcspeak decline— принять или отклонить предложение торговца.
Права
npcspeak.admin— управление NPC и настройками; по умолчанию доступно операторам.npcspeak.interact— начало диалога с NPC; доступно всем игрокам по умолчанию.
Настройка
Файлы NPC находятся в plugins/NPCSpeak/npcs/<id>.yml, общий конфиг — config.yml. В backend выбирается ollama или openai; для совместимого API заполняются openai.url, openai.api-key и openai.model.
В задаче используются переменные %player%, %outcome% и %quantity%. В require можно указать проверку валюты или предметов перед выполнением on-success, например eco %outcome% или item minecraft:gold_ingot %outcome%.
Параметр npc-provider: citizens включает NPC из Citizens2, а streaming: true выводит создаваемый ответ в строке быстрого доступа. Настройки memory, conversation и moderation управляют памятью, временем ожидания, числом реплик и фильтром фраз.
Требования
Нужны Paper, Java 17 или новее и доступная языковая модель: локальная Ollama либо сервис или сервер с API, совместимым с OpenAI. PlaceholderAPI, Vault и Citizens2 подключаются при необходимости; без Citizens2 плагин использует NPC-жителей.
