Во время игры на полигоне всегда есть момент, когда игрок подходит с лицом человека, у которого наконец-то созрел правильный вопрос, а у мастера в этот момент в голове план полигона, в одной руке рация а в другой чужой реквизит. Ответ на вопрос при этом лежит где-то в мастерятнике и в голове трёх разных людей. Из этих мест его надо достать быстрее, чем игрок успеет придумать свою версию событий.
Я сделал для этого помощника. Он стоит на точке, может в библиотеке, может в мастерятнике, может в таверне. А может и одновременно во всех трех местах. Пускает по слову и отвечает персонажем, читая только те материалы, которые этому гостю положены. Если в материалах пусто, он молчит. Молчание на полигоне тоже полезная реплика. Иногда даже лучшая.
Программа называется Baza. Потому что в обычной жизни это локальная база знаний: Markdown на диске, поиск по смыслу, отдельный индекс. Игровой режим - та же кухня, только вместо рабочих заметок в базе мир игры, а вместо "найди рабочий документ" - "поговори с трактирщицей о чем шепчут ее гости".
Зачем вообще компьютер на полигоне
Игра на полигоне предполагает постоянное передвижение, работать ногами, голосом и частенько весь в грязи. Это хорошо, весело и захватывающе. Плохо другое: документы не ходят ногами. Они лежат. Игрок доходит до библиотеки, когда дошёл, а не когда мастер свободен. Мастер в этот момент свободен теоретически где-то за холмом, в соседней локации или еще не материализовался в этом мире.
Классика:
"Подожди, я найду файл".
Красивая импровизация, которая через час спорит с другим документом у другого игрока..
Десять одинаковых конвертов, из которых один уже вскрыли не тем пальцем.
И многое другие моменты, которые потом пересказывают в байках с полигона.
Хотелось сделать некий артефакт, который сам разговаривает с игроками, а мастер не обязан стоять рядом.
Как это выглядит для игрока
На точке стоит устройство. На экране - страж. Он не обязан быть милым. Он обязан спросить слово. Изначально была идея, что при загрузе каждому игроку будет явлено его тайное слово - и по нему система определяет кто перед ней. Но это может быть и QR-код, если игра по киберпанку, а может быть и изображение. В наш век с помощью ИИ сделать простенькую систему распознавания не представляется сложным. Я сам пробовал для одного проекта - работает. И не обязательно это будет экран монитора. Колонку и микрофон с камерой можно вынести и заантуражить как угодно. Хоть под светящегося идола. Или магический куб. Ну или таки монитор компьютера.
Пытаемся три раза авторизоваться - и добро пожаловать, путник. Или Ваша Светлость. Или Миледи. Система не только определяет кто пришел, но и как обращаться к игроку.
В классическом варианте библиотеки все материалы собраны в одной точке. Мне же показалось, что можно развить эту идею. Что-то подскажет библиотекарь, а что-то может на ушко шепнуть владелица таверны. Поэтому сделал персонажей-хранителей знаний. И если таких персонажей несколько, то привратник спросит к кому именно ты идешь. И вот ты уже беседуешь с хранителем.
Спросить можно текстом в чате. Можно голосом. Можно голосом с субтитрами. У каждого персонажа прописан свой голос. Привратник говорит с тобой спокойным мужским, а владелица таверны женским и задорным.

Пока персонаж думает, на экране честно написано, что он копается в архивах. Потому что он и правда копается. Архив лежит рядом, может на локальном компе, а может где-то в сети. Если в сети, то ГМ может во время игры еще и подкидывать материал. При загрузке он автоматически индексируется, о самом механизме ниже.
Если спросить то, чего в записях нет, персонаж не сочиняет биографию короля "для атмосферы", или не придумывает несуществующие факты. Он отказывает в роли, говорит честно, что нет информации. Можно в настройках написать примеры отказа заранее: коротко, по-человечески и без ощущения, что вас только что обслужил call-центр.


Что делает мастер до игры
Мастер собирает все материалы в одну папку.
В папке:
Роли, локации, команды;
Игроки с тайными словами;
Персонажи NPC с манерой речи и запретами;
Материалы мира — обычные текстовые страницы.
У любого материала есть допуск. Всей игре. Только ведьмакам. Только тем, кто в конкретной локации. Только этому отряду. Только вот этому человеку. Если допуск пустой - материал общий. Если мастер написал "не для всех" и никого не назвал — лист не видит никто. Это не загадка. Это сургуч. Зачем не знаю, но так можно.
Чтоб для каждой игры не делать отдельный проект заранее заложил возможность использовать на нескольких играх. Все управляется в админке системы. Создаешь уникальную игру - и уже конкретно для нее заполняешь материалы. Поиск происходит только в рамках конкретной игры.

Немного техники.
Под капотом это локальный RAG.
Текст лежит в Markdown. При индексации документы режутся на куски, куски получают вектор и попадают в Postgres с pgvector. Рядом живёт обычный поиск по словам. Для поиска заранее сделал настройку.

Игрок пишет что-то NPC, и система:
Строит поисковый запрос из последнего сообщения (с учётом контекста диалога)
Ищет релевантные фрагменты в pgvector
Фильтрует по ACL — об этом ниже
Отсеивает по темам (elbow-cut на RRF-скорам)
Подает в roleplay-движок
Простой промпт "отвечай от лица NPC" не работает — нейросеть начинает выдавать себя. Поэтому сделал валидатор.
Валидатор проверяет пять вещей в строгом порядке приоритета:
Role drift — не звучит ли ответ не как тот персонаж?
AI reveal — нет ли упоминаний бота/нейросети/ИИ?
Табу — не использованы ли запрещённые слова из карточки?
Целостность — не обрезан ли ответ?
Grounding — все ли факты взяты из контекста (не выдуманы)?

Дополнительно сделал простенькую защиту на prompt injection, но мне кажется что игроки не будут маяться таким. Иначе не интересно и выход из роли.
ACL: библиотекарь-секьюрити
Самая интересная часть. Документы в игре — это Markdown-файлы с YAML-frontmatter. И каждый файл может иметь уровень доступа:
---
title: Устав ордена огня
game: vedmak
access:
all: false
roles: ["рыцарь", "маг"]
locations: ["каэд-вен"]
teams: ["орден-огня"]
players: [42, 107]
---
Текст устава...Это значит, что LLM физически не может увидеть документ, к которому у персонажа нет доступа. Не потому что "мы попросили не упоминать", а потому что чанк отфильтрован на уровне поиска до того, как попал в промпт.
Стек
Компонент | Технология |
|---|---|
API | FastAPI (async) |
БД | PostgreSQL (отдельная на workspace) |
Векторный поиск | pgvector (RRF-ранжирование) |
LLM | GigaChat / YandexGPT (через API) |
STT/TTS | Yandex SpeechKit |
Аутентификация | JWT в httponly-куке |
Документы | Markdown + YAML frontmatter |
ORM | SQLAlchemy (async) |
UI | HTML/CSS/JS (Bootstrap) |
Ролевая логика | Python, чистый код |
Что это даёт на практике
Сюжетная интеграция документов. Документы - не просто справочник, а часть мира. NPC отвечает, опираясь только на то, что его персонаж знает.
Геймификация входа. Тайное слово + привратник создают атмосферу, а не просто "введите логин/пароль".
Granular access control. Документы привязаны к ролям, локациям, фракциям и конкретным игрокам. RAG-поиск учитывает это на уровне чанков.
Качество ответов. Actor-Validator loop реально работает — нейросеть не выдаёт себя и не выдумывает факты.
Зачем это мастеру
Потому что мастерская группа конечна, а вопросы игроков - нет.
Система держит на точке ту информацию, которую можно заранее разложить по материалам: слухи, донесения, описания мест, письма с допуском. Мастер остаётся нужен там, где нужна живая реакция, конфликт и решение "а вот сейчас у вас действительно будет очень интересно".
В итоге получается странная, но полезная вещь: на полигоне появляется пост, который не устаёт, не путает акт первый со вторым и не выдаёт чужой конверт из вежливости. Он умеет меньше человека. Именно поэтому ему можно доверить часть рутины.
Игрок называет слово, говорит с персонажем, уходит. Следующий подходит со своим словом. Где-то за холмом мастер всё еще с планом, рацией и чужим реквизитом. Но ответы на вопросы он уже не ищет.
Планы на будущее
Персонажа-рассказчика для narration (описание мира, событий)
Систему инвентаря и квестов (привязка материалов к статусу игрока)
Портреты NPC через
portrait_ref(сейчас зарезервировано)Экспорт игровых сессий в PDF (летопись приключений)

Комментарии 0