🎲 QuestHub — гайд по боту

QuestHub — Telegram-бот для настольной ролевой игры Dungeons & Dragons 5-й редакции: создаёт персонажей, бросает кубики, ищет заклинания, собирает партии и помогает мастеру вести игру. Всё — кнопками в Telegram.

1. Для новичков

D&D за 5 минут

Dungeons & Dragons — игра-история, которую вы рассказываете вместе. Один участник — мастер (DM): он описывает мир, ведёт врагов и решает, что происходит. Остальные — игроки: каждый управляет своим героем, персонажем.

Персонаж — это раса (эльф, дварф, человек…), класс (воин, волшебник, плут…) и шесть характеристик: Сила, Ловкость, Телосложение, Интеллект, Мудрость, Харизма. Из характеристик получаются модификаторы (например, +2).
Бросок к20. Когда исход неясен, вы бросаете двадцатигранную кость (d20, «к20») и прибавляете модификатор. Если результат не меньше сложности, которую назвал мастер, — получилось.
Преимущество и помеха. В удачной ситуации бросают два к20 и берут больший результат (преимущество), в неудачной — меньший (помеха).
Хиты — запас здоровья. Опустились до 0 — персонаж без сознания.
Бой идёт по очереди: в начале все бросают инициативу (к20 + Ловкость), и ходят от большего результата к меньшему. Один круг ходов — раунд.
Заклинания бывают заговорами (их можно творить сколько угодно) и заклинаниями 1–9 кругов (тратят ячейки).
Опыт и уровни. За приключения мастер даёт опыт; набрав порог, персонаж получает новый уровень — больше хитов и новые умения.

Первый персонаж за 3 нажатия

Откройте бота и отправьте /start. Появится главное меню.
Нажмите Персонажи → Создать нового.
Выберите класс (например, Воин), затем расу (Человек) и пол (Мужской / Женский). Остальное — характеристики, снаряжение, имя, предысторию — бот заполнит сам и покажет карточку персонажа.

Не понравился результат — нажмите Перегенерировать в карточке.

Первая игра

Есть знакомый мастер и группа в Telegram? Попросите его привязать партию к группе (см. раздел для мастера) и напишите в группе /join — выберите персонажа кнопкой.
Ищете игру? Партии → Найти партию: задайте фильтры или нажмите Войти через сид, если мастер дал вам сид партии.
Во время игры откройте персонажа → 🎲 Броски или пишите /roll d20+3. Заклинания — /spell щит.

2. Что умеет бот

🧙 Персонажи: создание за три вопроса по правилам SRD 5.1, карточка с характеристиками, инвентарём, заметками, заклинаниями, чертами; правка имени, возраста, предыстории, языков.
⬆️ Повышение уровня по правилам SRD 5.1: хиты (бросок или среднее), бонус мастерства, умения класса и архетипа, увеличение характеристик или черта, новые заклинания и заговоры, ячейки.
🎲 Броски: /roll с любым выражением и кнопки проверок, спасбросков, навыков, оружия и инициативы прямо из листа персонажа — с преимуществом и помехой.
📖 Заклинания: поиск по русскому и английскому названию (опечатки прощаются), карточка с временем, дистанцией, компонентами. Описания всех заговоров — на русском, остальных пока на английском.
👥 Партии: создание, поиск по фильтрам и сиду, открытые и закрытые партии, привязка группового чата, вступление командой /join, передача роли мастера.
🎖 Мастеру: начисление опыта и уровней персонажам партии с уведомлением в чат.
⚔️ Трекер инициативы и хитов в чате партии: очередь ходов, раунды, урон и лечение кнопками.
📜 Лист персонажа в Mini App — страница прямо внутри Telegram: полный лист и «Игра с открытым листом» — текущие хиты, ячейки и ресурсы класса, экономия хода, короткий и долгий отдых, броски одним нажатием. Открывается и из чата партии: /sheet или «мой лист» → 📜 Мой лист. В шапке — аватар персонажа (🖼 Аватар в карточке).

3. Игрокам: все меню и кнопки

Главное меню

Открывается по /start и кнопкой Главное меню из любого раздела:

Персонажи · Профиль · Партии · 📖 Заклинания · 📜 Листы персонажей* · 📘 Гайд по боту*

* Эти две кнопки появляются, когда у бота включён сайт (HTTPS).

Персонажи

Персонажи → Список персонажей | Создать нового | Главное меню

Создать нового → класс (12 кнопок: Следопыт, Варвар, Бард, Плут, Друид, Колдун, Монах, Паладин, Жрец, Чародей, Воин, Волшебник) → раса (Дварф, Эльф, Полурослик, Человек, Драконид, Гном, Полуэльф, Полуорк, Тифлинг) → пол → карточка. Назад на каждом шаге возвращает на шаг раньше.
Список персонажей → кнопка с именем → карточка персонажа. Если персонажей много, листайте стрелками.

Карточка персонажа

Кнопка	Что внутри
Инвентарь	Опыт, Золото, Предметы, Амуниция. У предмета: Изменить название, Изменить описание.
О персонаже	Имя (Изменить имя / Изменить фамилию), Возраст, Предыстория, Языки (Удалить язык).
Заметки	Свои записи: Изменить название, Изменить содержание, Удалить.
Заклинания	Заклинания персонажа и Изменить: ➕ Добавить заклинание, а у каждого — Изменить название, Изменить описание, Удалить (подробнее — ниже).
Черты и способности	Черты расы и класса: Изменить название, Изменить описание, Удалить.
Уровень	Текущий уровень, опыт и порог следующего; ⬆️ Повысить уровень, когда опыта хватает.
🎲 Броски	Броски из листа персонажа (ниже).
🖼 Аватар	Портрет персонажа: пришлите фото — бот покажет его здесь и в шапке Mini App. 🔄 Заменить, 🗑 Удалить, ← К персонажу (подробнее — ниже).
📜 Лист персонажа*	Mini App с полным листом.
Удалить	Удаление (спросит Да / Нет; удалённого не вернуть).
Перегенерировать	Создать персонажа заново с теми же классом, расой и полом.
Назад	К списку персонажей.

Повышение уровня (пошагово)

Опыт обычно начисляет мастер партии, а уровень игрок повышает сам — с выбором.

Карточка → Уровень. Если опыта достаточно, есть кнопка ⬆️ Повысить уровень.
Хиты: 🎲 Бросить к10 (кость зависит от класса) или Среднее: 6. К результату прибавляется модификатор Телосложения.
Архетип (на уровне, где класс его выбирает, например, 3-й у воина): кнопка с названием архетипа; листайте ◀️ ▶️.
Увеличение характеристик (4-й, 8-й… уровни): +2 к одной, +1 к двум или Черта: …; затем отметьте характеристики (например, Сила 16→18). ↩️ Другой вариант — вернуться к выбору.
Заклинания, заговоры, воззвания, метамагия, боевой стиль, компетентность — если классу они положены, бот попросит выбрать нужное количество из разрешённого списка.
Проверка: бот покажет, что изменится. ✅ Подтвердить — сохранить, 🔄 Заново — выбрать иначе, ✖️ Отмена — выйти без изменений.
Готово: «🎉 Уровень повышен!». Если опыта хватает ещё — ⬆️ Ещё уровень; иначе К уровню / К персонажу.

Броски

Карточка → 🎲 Броски:

Режим сверху: Обычный · Преимущество · Помеха (действует на броски к20, выбранный отмечен ●).
⚡ Инициатива +2, 🎲 d20.
Группы: Проверки, Спасброски, Навыки, Оружие — в каждой кнопки с готовым бонусом; ⬅️ Назад к группам, ⬅️ К персонажу к карточке.
Любое выражение — командой: /roll 2d6+3, /roll d20+5 пре (преимущество), /roll d20 пом (помеха), /roll 1d8+1d6 # урон (подпись после #). Можно писать «к» вместо «d». /roll без аргументов — просто к20.

Заклинания

📖 Заклинания в главном меню или /spell → напишите название (по-русски или по-английски): огненный шар, щит, fireball. Сразу с названием: /spell огненный шар.
Бот покажет до 8 вариантов кнопками («Огненный шар · 3 кр.»). Нажмите — придёт карточка: круг, школа, ритуал/концентрация, время накладывания, дистанция, компоненты, длительность, классы и описание. 🔎 Искать ещё — новый поиск.

Заклинания персонажа: добавить, изменить, удалить

Карточка персонажа → Заклинания — список с описаниями → Изменить.
Появятся кнопки с названиями заклинаний (листайте ⬅️ ➡️, если их много) и ➕ Добавить заклинание.
Добавить: напишите название, затем описание (или «-», чтобы оставить без описания). Бот ответит «✅ Заклинание добавлено» и покажет его.
Изменить: нажмите заклинание → Изменить название или Изменить описание → отправьте новый текст (для описания «-» — убрать его). Бот ответит «✅ Сохранено». Время накладывания, дистанция, компоненты, круг и прочие поля при этом сохраняются.
Удалить: заклинание → Удалить → Да. Удалённое не вернуть.
Отмена во время ввода — вернуться без изменений; Назад — на шаг выше, до карточки.

Заклинания, выученные при повышении уровня, бот добавляет сам; их тоже можно переименовать или удалить вручную (удалённое при подсчёте лимита класса больше не учитывается).

Вступление в партию

Вы уже в группе партии (самый простой путь):

Напишите в группе /join.
Бот покажет ваших персонажей кнопками — нажмите нужного (кнопки работают только для вас). Нет персонажей — бот даст кнопку 🧙 Создать персонажа: она откроет личный чат с ботом; создайте персонажа и снова напишите /join в группе.
Открытая партия принимает сразу. Закрытая — в группе появится заявка с кнопками ✅ Принять / ❌ Отклонить для мастера.
Если уровень персонажа не подходит под уровень партии, бот предупредит: «⚠️ персонаж 2 ур., партия «Сложный» (10–15)». Это не запрет — решает мастер (в открытую партию вы всё равно вступите, но лучше уточнить у мастера).
У онлайн-партии со ссылкой на созвон бот пришлёт её вам в личку после вступления или одобрения (в общем чате и в поиске ссылки нет).

Вы не в группе: Партии → Найти партию → фильтры (Тип, Формат, Город, Уровень, Количество игроков, Название) → Поиск партий, или Войти через сид → партия → Выбрать персонажа → персонаж. Для открытой партии бот пришлёт ссылку Присоединиться к партии в группу; для закрытой — отправит карточку мастеру и сообщит его решение.

Напоминание о партии: /remind и «напомни»

В чате партии: /remind или сообщение, начинающееся с «напомни» (можно «бот, напомни» или «@бот напомни …»). Бот ответит: название, формат — ссылка на созвон (онлайн) или город (оффлайн), уровень с диапазоном, мастер, принятые игроки и их персонажи. Время сессии бот не хранит — договаривайтесь в чате.
Ссылку на созвон бот показывает, только если спросил мастер или принятый игрок; остальным — «ссылку видят только участники». Если спросил участник, ответ со ссылкой виден всему чату партии.
В личке: /remind или просто «напомни» — сводка по всем партиям, где вы мастер или принятый игрок (до 5). Во время ввода (например, названия партии) слово «напомни» считается ответом, а не командой.
Сообщение «@другой_бот напомни» или «кто-нибудь напомни…» бот не перехватывает.

Аватар персонажа

Карточка персонажа → 🖼 Аватар. Если аватара ещё нет, бот попросит картинку.
Пришлите фото (обычной отправкой) или картинку файлом — JPEG, PNG или WebP, до 5 МБ. Бот возьмёт фото в лучшем качестве.
Сервер обрежет картинку по центру в квадрат 512×512 (поворот с телефона учитывается) и сохранит. Готово: бот пришлёт аватар с кнопками 🔄 Заменить · 🗑 Удалить · ← К персонажу.

Аватар виден в шапке Mini App на обеих вкладках (🎲 Игра и 📜 Лист) и на экране 🖼 Аватар в боте. Сама текстовая карточка персонажа остаётся текстом.
Аватар видите только вы: публичной ссылки на картинку нет, Mini App получает её по подписи Telegram. Метаданные снимка (геометки, модель телефона) удаляются.
Удалили персонажа — удаляется и аватар. Картинки входят в ночной бэкап сервера.
Передумали посреди загрузки — Отмена или /start.

Профиль

Профиль → Изменить данные (Изменить возраст) · Удалить профиль · Статистика.

Лист персонажа (Mini App)

📜 Листы персонажей в главном меню или 📜 Лист персонажа в карточке открывают страницу прямо в Telegram: характеристики с модификаторами, спасброски, все навыки с бонусами (★ — владение, ★★ — компетентность), инициатива, пассивная внимательность, хиты, опыт до следующего уровня, оружие, заклинания, черты, инвентарь, языки, заметки и предыстория. Видны только ваши персонажи — Telegram подтверждает, кто вы. Лист открывается на вкладке 🎲 Игра (см. ниже), полный лист — вкладка 📜 Лист.

Лист из чата партии: /sheet и «мой лист»

В чате партии: /sheet — или сообщение «лист», «мой лист», «лист персонажа» (можно «бот, мой лист» или «@бот мой лист»). Бот ответит кнопкой 📜 Мой лист: она открывает Mini App сразу на листе вашего персонажа в этой партии.
Кнопка общая для всего чата, но каждый, кто её нажмёт, видит только своего персонажа — Telegram подтверждает, кто нажал. Если у вас нет персонажа в партии, откроется список ваших персонажей (вступить — /join).
Та же кнопка есть под сообщением «К партии присоединился новый персонаж» и под ответом /remind в чате партии. В личке /remind показывает под каждой партией кнопку листа вашего персонажа.
В личке: /sheet или «мой лист» — кнопка со всеми вашими листами. Во время ввода текста (например, названия заклинания) слово «лист» считается ответом, а не командой.
Слово «лист» в обычной фразе («лист бумаги») и «@другой_бот лист» бот не перехватывает. Без прав администратора бот в группе видит только команды, ответы на свои сообщения и упоминания — тогда пишите /sheet, «@бот мой лист» или ответьте боту.
Если Mini App ещё не включено в настройках бота у @BotFather, кнопка откроет личку с ботом, и он пришлёт кнопку листа — ещё одно нажатие.

Игра с открытым листом

Держите Mini App открытым за столом: всё, что меняется по ходу игры, отмечается одним нажатием и сразу сохраняется на сервере. Закрыли и открыли снова, открыли с другого телефона — всё на месте. Бот остаётся «большим редактором»: имя, навыки, заклинания, новые предметы и повышение уровня — в боте.

Блок	Что делает
Хиты	Текущие / максимум и полоска. −1 +1, или введите число и нажмите Урон, Лечение, Врем. (временные хиты). Урон сначала снимает временные хиты. Лечение не поднимает выше максимума. «Максимум хитов» (под полоской) меняет поле «Хиты» листа в боте.
Спасброски от смерти	Появляются при 0 хитов: отметьте Успехи/Провалы или нажмите 🎲 — приложение бросит к20 само (10+ успех, 1 — два провала, 20 — встаёте с 1 хитом). Урон при 0 хитов добавляет провал; урон, равный максимуму хитов сверх нуля, — мгновенная смерть. Три успеха — стабилизирован; любое лечение сбрасывает отметки.
Ход	Фишки Действие, Бонусное, Реакция, Рывок и (если атак больше одной) ⚔️ Атаки 0/2: нажатие тратит — фишка сереет, повторное нажатие возвращает. Движение: остаток футов из скорости персонажа, −5/−10, ↺ — сброс; «Рывок» удваивает движение. 🔄 Новый ход возвращает всё и считает раунды; Конец боя обнуляет счётчик раундов.
Ресурсы	Считаются автоматически по классу и уровню (правила SRD 5.1). Кружки: закрашенный — есть, нажмите, чтобы потратить; пустой — нажмите, чтобы вернуть. Большие запасы (например «Наложение рук») — счётчиком −1/+1. Под названием — когда восстанавливается.
Свои счётчики	Внизу «Ресурсов»: название, максимум и когда восстанавливается (долгий, короткий отдых или вручную) → +. Для черт, магических предметов с зарядами, стрел и т.п. ✕ — удалить.
Броски	Режим Обычно / Преимущество / Помеха (действует на к20). Кубики к4–к20 и к100, своё выражение (`2d6+3`, `1к8-1`), и готовые броски листа: инициатива, атака и урон каждым оружием, проверки, спасброски, навыки. Результат — крупно, с историей последних бросков. Бросает приложение (честный генератор), в чат ничего не уходит — покажите экран мастеру или бросайте `/roll` в чате.
Отдых	☕ Короткий отдых — восстанавливает ресурсы «короткого отдыха». Во время него тратьте кости хитов: 🎲 Потратить — сервер бросает кость хитов класса + модификатор Телосложения и лечит. 🌙 Долгий отдых — хиты до максимума, временные хиты и спасброски от смерти сбрасываются, все ячейки и ресурсы восстанавливаются, возвращается половина костей хитов (минимум одна), истощение −1. Оба отдыха сбрасывают ход. Перед отдыхом приложение переспрашивает.
Состояния	14 состояний SRD (ослеплён, отравлен, сбит с ног…) и Концентрация — нажатие включает/выключает. Истощение 0–6.
Монеты и опыт	пм, зм, эм, см, мм: −1/+1 или сумма + монета + Потратить/Получить. Золотые — это «Золото» листа в боте. Опыт — Добавить; когда опыта хватает на новый уровень, появится подсказка и кнопка Открыть бота — повышение делается в боте (Персонажи → персонаж → ⬆️ Повысить уровень).
Предметы	Количество каждого предмета инвентаря и снаряжения: −1/+1 (выпили зелье, потратили болт). Это те же предметы, что в боте; добавить новый или удалить — в боте.

Ресурсы по классам (появляются с нужного уровня):

Класс	Ресурсы	Восстановление
Все заклинатели	Ячейки 1–9 кругов по таблице класса	долгий отдых
Колдун	Ячейки договора (все одного круга); Таинственный арканум 6–9 кругов — по 1	ячейки — короткий, арканум — долгий
Варвар	Ярость (2–6 раз; на 20 уровне без ограничений — счётчик не показывается)	долгий
Бард	Вдохновение барда = модификатор Харизмы (мин. 1), кость к6–к12	долгий, с 5 уровня — короткий
Жрец	Божественный канал (с 2 ур.: 1, с 6: 2, с 18: 3)	короткий
Друид	Дикий облик — 2 раза (2–19 ур.)	короткий
Воин	Второе дыхание (1), Всплеск действий (1, с 17 ур. — 2), Упорный (с 9 ур.); Мастер боевых искусств — кости превосходства (4/5/6, к8 → к10 → к12)	Упорный — долгий, остальное — короткий
Монах	Очки ци = уровень (с 2 ур.)	короткий
Паладин	Божественное чувство (1 + Харизма), Наложение рук (запас 5 × уровень хитов), Божественный канал (с 3 ур.)	канал — короткий, остальное — долгий
Плут	Удача (20 ур.)	короткий
Чародей	Единицы чародейства = уровень (с 2 ур.)	долгий
Волшебник	Магическое восстановление (1 раз в день, на коротком отдыхе)	долгий

Атак за действие «Атака»: воин — 2 с 5 ур., 3 с 11, 4 с 20; варвар, монах, паладин, следопыт — 2 с 5 ур.; остальные — 1. Классы и архетипы вне SRD (и всё, чего нет в таблице) — заводите «своими счётчиками».

Что видит бот. Хиты (максимум), золото, опыт и количество предметов — общие поля листа: изменения сразу видны в боте и наоборот. Текущие хиты из Mini App подхватывает трекер инициативы, когда вы жмёте 🎲 Вступить после /init. Если в боте открыта старая карточка — откройте персонажа заново. Вернулись в Mini App из бота — лист обновится сам.

Безопасность: Mini App не хранит ни паролей, ни ключей — каждый запрос подписан Telegram, сервер проверяет подпись и даёт менять только ваших персонажей. Слишком частые нажатия (больше ~3 в секунду подряд минуту) сервер временно отклонит — подождите минуту.

4. Мастеру

Создать партию

Партии → Создать партию.
Заполните кнопки: Тип (Открытая — игроки входят сразу, Закрытая — по вашему одобрению), Формат (Онлайн/Оффлайн; для оффлайна нужен Город), Уровень (Лёгкий, Средний, Сложный, Социальный), Количество игроков, Название, Описание.
Для Онлайн появится кнопка 🔗 Ссылка на созвон (необязательно): пришлите адрес http:// или https:// (Discord, Zoom, Meet, Телемост…) или нажмите Без ссылки. Не ссылку бот не примет и попросит ещё раз. При смене формата на Оффлайн ссылка удаляется.
Создать партию → проверьте карточку → Создать партию. Бот покажет сид — короткий код партии — и кнопку Копировать сид.

Что делает каждый параметр и что бот проверяет — в разделе «Параметры партии».

Ссылка на созвон

Изменить или убрать: Мои партии (мастер) → партия → 🔗 Ссылка на созвон → новая ссылка или «-», чтобы убрать. Кнопка есть только у онлайн-партий.
Ссылку видят только вы и принятые игроки: в личке при принятии и по /remind. В поиске партий и по сиду её нет.

Подключить групповой чат

Создайте группу в Telegram и добавьте туда бота.
Сделайте бота администратором группы («Управление группой» → «Администраторы» → «Добавить администратора»). Без этого бот ответит подсказкой и ничего не привяжет: права нужны, чтобы видеть сообщения и присылать заявки.
Напишите в группе /bind СИД — или /start, а затем сид отдельным сообщением.
Привязать может мастер партии или администратор/владелец группы (админ — только если мастер тоже состоит в группе). К чату привязана одна партия: новая привязка отвязывает старую.

В привязанном чате игроки открывают свои листы кнопкой 📜 Мой лист — по /sheet («мой лист»), под объявлением о новом персонаже и под /remind (подробнее).

Заявки игроков

В группе (/join): у закрытой партии под заявкой — ✅ Принять / ❌ Отклонить; нажать их может только мастер. Принятый персонаж появляется в чате карточкой. Когда мест не осталось, бот напишет «Набор игроков в партию завершился», и новые /join получат отказ.
Из поиска (игрок не в группе): заявка приходит вам в личку с кнопками Одобрить заявку / Отклонить заявку; одобренный игрок получает одноразовую ссылку в группу (и ссылку на созвон, если она есть).
Если уровень персонажа вне диапазона партии, в заявке будет пометка «⚠️ персонаж 2 ур., партия «Сложный» (10–15)». Принять всё равно можно — решаете вы.

Опыт и уровни

Партии → Мои партии (мастер) → партия. Видны персонажи, их уровень, опыт и пометка «⬆️ может повысить уровень».
Выберите персонажа или 👥 Вся партия.
✨ Начислить опыт → отправьте число (например, 300), или ⬆️ Дать уровень — опыт поднимется ровно до порога следующего уровня.
В чат партии придёт «🎖 Мастер выдал награду». Сам уровень игрок повышает в карточке → Уровень.

🔄 Обновить — перечитать партию, К списку — к партиям.

Передать роль мастера

В группе: ответьте командой /master на любое сообщение нового мастера. Он увидит 👑 Принять / Отказаться — нажать может только он.
В личке: Мои партии (мастер) → партия → 👑 Передать мастера → игрок партии. Предложение придёт ему в личку.
Пока новый мастер не принял, партия остаётся у вас. Предложение действует 24 часа.

Трекер инициативы и хитов

В группе партии мастер пишет /init. Появится сообщение «⚔️ Трекер инициативы» с кнопками.
Игроки жмут 🎲 Вступить: бот бросает к20 + инициатива их персонажа из партии и берёт хиты из листа.
Мастер добавляет противников: /init add Гоблин +2 7 (бонус +2 — бот бросит к20+2; хиты 7), /init add Орк 14 15 (готовая инициатива 14), /init add Волк +2 11 x3 (три волка: «Волк 1», «Волк 2», «Волк 3»).
▶️ Начать бой, затем ⏭ Следующий ход — бот отметит текущего ▶️ и упомянет игрока, чей ход. После последнего участника начинается новый раунд.
Хиты текущего участника — кнопками -5 ❤️ -1 ❤️ +1 ❤️ +5 ❤️; любого — командой /hp Гоблин -5 (урон) или /hp Гоблин +3 (лечение). Число без знака — урон. Игрок может менять хиты своему персонажу: /hp -4.
🗑 Убрать текущего или /init del Гоблин — убрать участника; ⏹ Завершить или /init end — закончить бой.

Кнопки хода, хитов и завершения работают только у мастера, который начал бой. Имя можно писать началом: /hp гоб 3.

Параметры партии

Что задаётся при создании (и в фильтрах поиска), на что влияет и что бот проверяет сам.

Параметр	На что влияет	Что проверяет бот
Название	Карточка партии, напоминания, поиск по названию (по части слова, без учёта регистра и ё/е).	Должно быть текстом; пробелы по краям убираются.
Формат: Онлайн / Оффлайн	Фильтр поиска. У оффлайна — город, у онлайна — необязательная ссылка на созвон.	Для Оффлайн обязателен город. Ссылка на созвон бывает только у Онлайн: при смене на Оффлайн она удаляется.
Город	Поиск по городу (по части названия) и напоминание для оффлайн-партий.	Нужен только оффлайн-партии; у онлайн-партии город сбрасывается.
Ссылка на созвон	Приходит принятым игрокам в личку и показывается участникам по `/remind`.	Только http:// или https://, без пробелов, до 500 символов. Не видна в поиске и по сиду. Менять может только мастер.
Уровень: Лёгкий / Средний / Сложный / Социальный	Фильтр поиска и предупреждение при вступлении. Диапазоны уровней персонажа: Лёгкий 1–5, Средний 5–10, Сложный 10–15, Социальный — без ограничений.	Не запрещает вступление: игрок и мастер видят «⚠️ персонаж N ур., партия «X» (lo–hi)», решает мастер.
Тип: Открытая / Закрытая	Открытая — персонаж добавляется сразу (через `/join` в группе или из поиска — со ссылкой-приглашением в группу). Поэтому открытой партии из поиска нужен привязанный чат: без него вступить нельзя, а мастеру придёт напоминание привязать группу. Закрытая — каждую заявку принимает или отклоняет мастер.	Принять/отклонить заявку может только мастер. Один игрок — один персонаж в партии.
Количество игроков	Сколько персонажей можно принять; фильтр поиска (точное число).	Когда мест не осталось, набор закрывается: партия пропадает из поиска (active=false), бот пишет «Набор игроков в партию завершился», новые `/join` получают отказ.
Сид	Короткий код партии: им привязывают чат (`/bind СИД`) и находят партию (Войти через сид).	Создаётся ботом автоматически, уникален. Ссылку на созвон по сиду не узнать.
Описание	Показывается в карточке партии в поиске и при вступлении.	Свободный текст, бот его не проверяет.

Время сессии бот пока не хранит — договаривайтесь в чате партии; /remind об этом напомнит.

5. Все команды

Команда	Где	Что делает
`/start`	личка	Главное меню (и регистрация).
`/start`	группа	Привязать партию: бот спросит сид.
`/help`	везде	Список команд и ссылка на этот гайд.
`/roll 2d6+3`, `/r`	везде	Бросок кубиков; `пре`/`пом` — преимущество/помеха, `# подпись`.
`/spell название`, `/spells`	везде	Поиск заклинания.
`/bind СИД`	группа	Привязать партию к чату (мастер или админ группы).
`/join`	группа	Вступить в партию своим персонажем.
`/master`	группа, ответом	Передать партию автору сообщения.
`/init`, `/initiative`	группа	Начать бой или показать трекер заново.
`/init add Имя [+бонус\|инициатива] [хиты] [x3]`	группа	Добавить противника (мастер).
`/init del Имя`, `/init end`, `/init help`	группа	Убрать участника, закончить бой, подсказка.
`/hp [Имя] ±N`	группа	Урон или лечение в бою.
`/remind`	группа партии	Сводка партии: формат, ссылка на созвон (участникам) или город, уровень, мастер, состав.
`/remind`	личка	Сводка по всем вашим партиям (мастер или принятый игрок).
«напомни», «бот, напомни», «@бот напомни»	группа партии	То же, что `/remind`. «@другой_бот напомни» бот игнорирует.
«напомни» (целиком сообщение)	личка	То же, что `/remind`, если вы не на шаге ввода текста.
`/sheet`	группа партии	Кнопка 📜 Мой лист: каждый открывает лист своего персонажа этой партии в Mini App.
`/sheet`	личка	Кнопка Mini App со всеми вашими листами.
«лист», «мой лист», «лист персонажа», «бот, мой лист», «@бот мой лист» (целиком сообщение)	группа партии, личка	То же, что `/sheet`. В личке — если вы не на шаге ввода текста; «@другой_бот лист» бот игнорирует.

Без команды, кнопками в личке: Персонажи, Профиль, Партии (создать, найти, войти через сид, мои партии мастера), 📖 Заклинания, 📜 Листы персонажей. Если бот получил текст, которого не ждал, он подскажет, что делать (обычно — /start).

6. Частые вопросы и подводные камни

Я вводил имя (или повышал уровень), а бот перестал реагировать на ответ

Незаконченный шаг — ввод текста, мастер повышения уровня, поиск заклинания, выбор фильтров — хранится в памяти бота и теряется при его перезапуске (например, после обновления). Отправьте /start и повторите действие. Сохранённые данные (персонажи, партии, опыт) не теряются.

Нажимаю «Изменить» в заклинаниях — ничего не происходит

Так было до обновления 24.10.2026: редактирования заклинаний в боте не было. Теперь оно есть (см. «Заклинания персонажа: добавить, изменить, удалить»). Если кнопка из старого сообщения не отвечает — бот перезапускался: отправьте /start и откройте персонажа заново.

Бот пишет «⚠️ персонаж 2 ур., партия «Сложный» (10–15)» — меня не возьмут?

Это только подсказка: уровень персонажа не попадает в диапазон партии (Лёгкий 1–5, Средний 5–10, Сложный 10–15, Социальный — любой). Бот не запрещает вступление: заявку в закрытую партию мастер может принять, в открытую вы вступаете сразу. Решает мастер.

Где ссылка на созвон онлайн-партии?

Её видят только мастер и принятые игроки: бот присылает её в личку после принятия, а в любой момент — /remind (или «напомни») в чате партии или в личке. В поиске и по сиду ссылки нет. Если пишет «ссылку мастер пока не указал» — попросите мастера добавить её: Мои партии (мастер) → партия → 🔗 Ссылка на созвон.

Бой в трекере пропал

Трекер инициативы тоже живёт в памяти: после перезапуска бота или 12 часов без действий бой нужно начать заново командой /init. Хиты в трекере — боевые и не меняют лист персонажа.

Бот в группе отвечает «сделайте бота администратором»

Для привязки партии бот должен быть администратором группы. Остальные команды (/roll, /spell) работают и без этого, но без прав администратора бот может не видеть обычные сообщения (например, сид после /start) — используйте /bind СИД одной командой.

/join пишет «К этому чату ещё не привязана партия»

Мастер или администратор группы должен сначала выполнить /bind СИД.

/join пишет «Набор игроков завершён»

В партии заняты все места («Количество игроков» при создании). Одним игроком в партии может быть только один персонаж; мастеру персонаж в своей партии не нужен.

Не могу повысить уровень

Нужен опыт до порога следующего уровня — его начисляет мастер (✨ Начислить опыт или ⬆️ Дать уровень). Кнопка ⬆️ Повысить уровень появляется только тогда. Заменять уже выученные заклинания при повышении бот пока не умеет; классы и архетипы вне SRD 5.1 показываются только названием.

Почему описание заклинания на английском?

Переведены описания всех заговоров; у заклинаний 1–9 кругов пока английский текст SRD 5.1. Название, время, дистанция, компоненты и длительность — по-русски у всех.

Где взять сид партии?

Он показывается при создании партии (кнопка Копировать сид) и в Мои партии (мастер) рядом с названием.

Привязал новую партию — старая перестала получать уведомления

К одному чату привязана одна партия. Для второй партии создайте отдельную группу.

Mini App: потратил ячейку/ресурс по ошибке

Нажмите на пустой кружок — ресурс вернётся. Фишку хода — нажмите ещё раз. Хиты — Лечение на то же число.

Mini App: нет ресурса моего класса или архетипа

Автоматически считаются ресурсы SRD 5.1 (см. таблицу в «Игре с открытым листом»). Для остального добавьте «свой счётчик» с максимумом и типом отдыха. Если ресурс зависит от уровня — проверьте, что уровень в листе правильный.

Mini App: «Слишком много нажатий»

Сервер ограничивает частоту изменений. Подождите минуту и продолжайте — уже сделанные изменения сохранены.

Кнопка «Лист персонажа» не открывается в группе

Кнопки Mini App из меню бота Telegram открывает только в личке. В чате партии напишите /sheet (или «мой лист») — бот ответит кнопкой 📜 Мой лист, которая работает и в группе и открывает лист именно вашего персонажа (такая же кнопка — под объявлением о новом персонаже и под /remind). Если кнопка открыла личку с ботом — нажмите там 📜 Мой лист: значит, владелец бота ещё не включил Mini App в @BotFather. Бот молчит на «мой лист»? Без прав администратора он видит только команды и обращения к себе — напишите /sheet или «@бот мой лист».

Аватар: «Нужна картинка JPEG, PNG или WebP» / «Файл больше 5 МБ»

Подходят фото и картинки-файлы JPEG, PNG, WebP до 5 МБ (GIF, HEIC, PDF и видео — нет). Проще всего отправить картинку как обычное фото: Telegram сам её сожмёт. Слишком большое разрешение (больше ~16 Мп для PNG/WebP) тоже не примем — уменьшите картинку.

Аватар не появился в Mini App

Закройте и откройте лист заново (или вернитесь в Mini App из бота — он обновится сам). Аватар показывается только владельцу персонажа.

Предложение стать мастером «устарело»

Предложение действует 24 часа и пропадает при перезапуске бота. Попросите мастера отправить /master ещё раз.

Бот написал «Сервер QuestHub сейчас не отвечает»

Сервер на минуту недоступен (например, обновляется). Повторите действие чуть позже.

7. Схема меню

/start → Главное меню
- Персонажи
  - Создать нового → класс → раса → пол → карточка
  - Список персонажей → персонаж → карточка
    - Инвентарь → Опыт · Золото · Предметы · Амуниция
    - О персонаже → Имя · Возраст · Предыстория · Языки
    - Заметки · Черты и способности
    - Заклинания → Изменить → ➕ Добавить заклинание · заклинание → Изменить название · Изменить описание · Удалить
    - Уровень → ⬆️ Повысить уровень → хиты → (архетип) → (характеристики/черта) → (заклинания…) → ✅ Подтвердить
    - 🎲 Броски → режим · инициатива · d20 · Проверки · Спасброски · Навыки · Оружие
    - 🖼 Аватар → прислать фото · 🔄 Заменить · 🗑 Удалить · ← К персонажу
    - 📜 Лист персонажа (Mini App, аватар в шапке): вкладки 🎲 Игра (хиты, ход, ресурсы, броски, отдых, состояния, монеты и опыт, предметы) и 📜 Лист
    - Удалить · Перегенерировать
- Профиль → Изменить данные · Удалить профиль · Статистика
- Партии
  - Создать партию → параметры → Создать партию → сид
  - Найти партию → фильтры / Войти через сид → партия → Выбрать персонажа → заявка
  - Мои партии (мастер) → партия → персонаж / 👥 Вся партия → ✨ Начислить опыт / ⬆️ Дать уровень; 🔗 Ссылка на созвон (онлайн); 👑 Передать мастера
- 📖 Заклинания → название → результат → карточка
- 📜 Листы персонажей · 📘 Гайд по боту
Групповой чат партии
- /bind СИД (мастер или админ) → партия привязана
- /join → персонаж → открытая: сразу в партии · закрытая: ✅ Принять / ❌ Отклонить (мастер)
- /master ответом → 👑 Принять (новый мастер)
- /init → 🎲 Вступить · ▶️ Начать бой · ⏭ Следующий ход · ±❤️ · 🗑 · ⏹; /init add, /hp
- /sheet / «мой лист» → 📜 Мой лист → Mini App на вашем персонаже (та же кнопка — под объявлением о вступлении и под /remind)