К диалогу
CCG · Бюро по борьбе с гулямиДело № SSS-001

Объект

chestor_bot

RPG-бот в Telegram по «Токийскому гулю». Гули с голодом, кагуне и смертью, честный боевой движок и своя экономика.

Среда обитания
Telegram-чаты, вебхук на chestor.site
Язык
Python 3.11–3.14
Фреймворк
selfrotgram (с сентября 2026), до этого aiogram 3
Хранилище
PostgreSQL 16, 22 миграции Alembic
Юзернейм прод-бота
@chestor_chat_bot

Версия 1.0.0 — игровой цикл закрыт.

SSSОсобо опасен

00 · Как начать

Как поиграть в «Токийского гуля» в Telegram

Ничего устанавливать не нужно: игра целиком живёт в Telegram.

  1. Открой бота

    Найди @chestor_chat_bot в Telegram и отправь /start. Играть можно в личке или в групповом чате — добавь бота в чат, и играть будут все.

  2. Стань гулем

    Напиши «растить кагуне» — родишься гулем. Тип кагуне выпадет случайно: укаку, коукаку, ринкаку или бикаку.

  3. Выживай и дерись

    «голод» — насколько ты голоден, «сожрать человека» — поесть раз в сутки, «бить моба» — первый бой, «дуэль» — бой с другим гулем.

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

    Полный список — в канале @CheStorCommands или по команде /help.

01 · Жизненный цикл

Голод → смерть → регенерация → прокачка → бои

В 1.0.0 круг замкнулся: каждая механика толкает к следующей, а смерть — не конец, а перезапуск генетической лотереи.

голодсмертьрегенерацияпрокачкабои1.0.0цикл закрыт
ТирГолодЛовкость, скорость, регенСила и кагуне
Смертельный голод0–24%×0.1×0.5
Сильный голод25–49%×0.6×1.6
Лёгкий голод50–74%×0.9×1.1
Не голоден75–100%×1.0×1.0
  • Голод тает сам: ориентир — 4 раза в сутки по 4%, полностью голодным гуль станет через неделю реального времени.
  • «Падающие» статы — ловкость, скорость, регенерация. «Растущие» — сила и кагуне: голод злит.
  • Последний тир осознанно ломает рост: неделями голодающий гуль теряет контроль над RC-клетками. Это коллапс, а не адреналин.
  • Ушёл в минус — смерть. Переживает её только счётчик смертей.

02 · Кагуне

Четыре типа, одна лотерея

Какухо — орган, управляющий RC-клетками. Где он — такой и стиль боя.

Укаку

какухо: плечи

Скорость и частые лёгкие удары. Минус — низкая выносливость.

скорость ×1.8

Коукаку

какухо: лопатки

Мощный физический удар. Минус — низкая скорость.

сила ×1.6, скорость ×1.3

Ринкаку

какухо: поясница

Выносливость и регенерация, явных слабостей почти нет.

ловкость ×1.3, регенерация ×1.8, скорость ×1.5, здоровье ×1.5

Бикаку

какухо: копчик

Понемногу всех усилений сразу — универсал.

сила ×1.5, ловкость ×1.4, регенерация ×1.4, скорость ×1.4, здоровье ×1.4

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

03 · Бои

Движок, который не врёт

Бой симулируется по раундам, а не решается одной формулой: лог событий потом можно отрисовать хоть текстом, хоть анимацией.

01

Чистый домен

Боевой движок не знает ни про базу, ни про Telegram: на входе статы, на выходе лог событий. Текст в чате — лишь один способ этот лог отрисовать.

02

Ограниченное число раундов

Старая версия умела зависнуть навсегда, если оба гуля были запредельно ловкими. Теперь бой — фиксированное число раундов, победитель без нокаута определяется по остатку HP.

03

Уклонение 5–95%

Шанс увернуться зажат между полом и потолком и считается парно, относительно соперника. Неуязвимых билдов нет.

04

Физика или кагуне

Первый удар всегда физический, дальше шанс физического падает на 10 п.п. за удар — бой скатывается в кагуне. Поднятое кагуне блокирует 45–75% физики.

05

Засада на охоте

«Сожрать человека» можно раз в сутки: +5–25% к голоду. Иногда из темноты выходит другой гуль — и ужин приходится отбивать.

06

Моб раз в 10 минут

Статы моба — твои, умноженные на случайное 0.5–2. Голодный встречает моба опаснее, чем по профилю: это стимул есть, а не баг.

прогресс += 1% × (сила соперника / своя сила)

Уровень хранится в процентах, а не в сыром опыте: равный соперник даёт 1%, вдесятеро слабее — 0,1%. Фармить своего твинка бессмысленно, а сильного — выгодно.

04 · Экономика

CheSton и RC-клетки

CheSton

Обычные деньги: кофе, сломанные пальцы («щёлк»), викторина, мобы, лотерея. Тратятся на статы и рост кагуне.

RC-клетки

Не валюта, а избыток RC в теле. Добываются поеданием побеждённых гулей и изредка с мобов. Нужны для новых типов кагуне и какуджи.

05 · Команды

Как с ним разговаривать

Большинство команд — обычные слова без слеша: в чате это читается как речь, а не как терминал.

Стать гулем

  • растить кагунеродиться гулем или прокачать кагуне
  • профильстаты, кагуне, счётчики
  • распрофильрасовый профиль, /race_profile
  • /kaguneсправка по типам кагуне

Выжить

  • голодтир голода и эффективные статы
  • регенсколько до полного здоровья
  • сожрать человекараз в сутки, иногда с засадой
  • боевая мощьстаты вне боя и в бою

Драться

  • бить мобабой с мобом, коротко «бм»
  • дуэльбой с другим гулем
  • качатьсякупить статы (в личке)

Деньги

  • щёлксломать палец за CheSton
  • пить кофекофе из Антейку за CheSton
  • балбаланс; «топ бал» — самые богатые
  • перевестиперевод CheSton, он же /transfer
  • депнутьлотерея: депнуть красный 500

Развлечься

  • /quizвопрос из Ghoul Quiz API
  • вордлиwordle, он же /wordle
  • /animeгифки из аниме
  • /helpвсе команды

06 · Переписка

Как это выглядит в Telegram

Рождение
растить кагуне
chestor_bot
🐣 Добро пожаловать в пищевую цепочку, Гость. Ты больше не человек — ты гуль. Кагуне: Ринкаку.
пить кофе
chestor_bot
☕️ Антейку наливает — ты пьёшь. Чёрный, как твоё будущее. 💸 CheSton: +40 ☕️ Всего выпито: 1
Ужин с засадой
сожрать человека
chestor_bot
🐺 Облом: на твоего человека уже слюни пускает другой гуль. Мочи его!
chestor_bot
──── Раунд 1 ──── 🔸 Гость наносит удар — 34 урона 🐺 Моб промахивается ❤️ Моб: 120 → 86 (-34 урон)
chestor_bot
🍽 Мясо свежее, крики вкусные. 🍖 Голод: +18%, теперь 81% 🥩 Съедено людей: 1
Голод
голод
chestor_bot
🍖 Голод: 42% (сильный голод) 📉 Падающие статы (ловкость/скорость/регенерация/здоровье) сейчас: ×0.6 📈 Растущие статы (сила/кагуне) сейчас: ×1.6
chestor_bot
🍖 Голод 25%. Кишки уже урчат — иди жри человека.

Реплики — дословно из текстов бота, числа в них условные.

07 · Под капотом

Цифры и стек

версия
1.0.0
тестов на настоящем Postgres
659
коммитов
~360
миграции Alembic
22
строк
~42 тыс.
  • Тесты поднимают одноразовый Postgres в Docker и подменяют Telegram фейковым HTTP-сервером.
  • Тексты бота — YAML с горячей перезагрузкой и сгенерированным типизированным деревом: опечатка в ключе не доживает до прода.
  • Дизайн-документы живут рядом с кодом: BATTLE_DESIGN, BATTLE_ENGINE, ECONOMY, REGENERATION.
  • В сентябре 2026 бот целиком переехал с aiogram 3 на selfrotgram.

Python 3.11–3.14selfrotgramSQLAlchemy 2 asyncPostgreSQL 16Alembicdependency-injectorDocker Composeежедневные бэкапы в облако

08 · Вопросы

Частые вопросы

Где поиграть в «Токийского гуля» в Telegram?

В chestor_bot — текстовой RPG по «Токийскому гулю» прямо в Telegram. Откройте @chestor_chat_bot и отправьте /start или добавьте бота в свой групповой чат.

Что можно делать в игре?

Стать гулем с одним из четырёх типов кагуне, следить за голодом и есть людей, драться с мобами и с другими гулями в дуэлях, копить CheSton и RC-клетки, прокачивать статы и уровень. Если голод уйдёт в минус, гуль умрёт и родится заново.

Нужно ли что-то устанавливать?

Нет. Игра целиком внутри Telegram: достаточно написать боту.

На каком языке бот?

На русском.

Кто сделал chestor_bot?

CheStor (Self), бэкенд-разработчик на Python. Бот написан на его собственном фреймворке selfrotgram, исходники открыты на GitHub.