Добро пожаловать в Верхнюю Сибирь. Вы оказались на улице, не имея представления о своей личности и целях. Снег бьёт в лицо, ветер тащит вперёд. Первым шагом является получение паспорта — без него вы лишь неприкаянный человек без имени и прав.
Никто не помнит, как оказался здесь. Это не потеря памяти — это природа города. Верхняя Сибирь сама решает, где вам стоять.
!паспорт — получить документы нового жителя
!баланс — проверить счёт в банке
!работа — список доступных вакансий
!магазин — открыть городской магазин
Без паспорта вы не существуете в базе данных города. Счёт не открыт. Работа недоступна. Кражу вас поймают немедленно. Паспорт — первый и обязательный шаг.
Паспорта выдаются исключительно в холле мэрии. Обратитесь к регистратору или мэру — они имеют право оформить документы. Самостоятельно получить паспорт невозможно.
Регистратор вводит команду в канале мэрии. Формат строгий — любое отклонение приводит к отказу системы.
!паспорт дать @житель ИмяБезПробелов Возраст Фото
Имя — без пробелов, произвольное игровое имя.
Возраст — целое число от 18 до 70.
Фото — прямая ссылка на изображение (.jpg, .jpeg, .png или .gif).
В момент выдачи паспорта система автоматически открывает личный счёт. Начальный баланс — 0 ₽ наличкой и 0 ₽ в банке. Первые средства необходимо заработать самостоятельно.
Паспорт действителен 60 дней с момента выдачи. По истечении срока он считается просроченным. Владелец получит уведомление заблаговременно.
Просроченный паспорт не аннулируется автоматически, однако ряд действий становится недоступен. Для продления обратитесь к регистратору или мэру в канале мэрии.
!паспорт обновить @житель
Свой паспорт или паспорт другого жителя можно запросить к просмотру. Владелец паспорта вправе отказать.
!паспорт посмотреть — свой паспорт
!паспорт посмотреть @житель — чужой паспорт
У каждого зарегистрированного жителя есть два счёта: наличка и банк. Наличка — средства при себе, доступны немедленно, но уязвимы для кражи. Банк — защищённый счёт, который не может быть ограблен, однако для использования требует снятия.
Валюта города — рубль (₽). Проверка баланса:
!баланс или !баланс @житель — показывает оба счёта.
Раз в сутки каждый житель может получить 200 ₽ наличными. Бонус начисляется немедленно. Повторный вызов в тот же день будет отклонён.
!дейли
Передать наличку другому жителю можно напрямую. Перевод осуществляется только из наличных — банковские средства необходимо предварительно снять.
!деньги передать @житель <сумма>
Топ богатейших жителей города формируется по совокупному балансу (наличка + банк). Страницы переключаются аргументом.
!топ или !топ <страница>
Профиль отображает баланс жителя и статистику: количество краж, ограблений, штрафов. Можно просматривать свой или чужой.
!профиль или !профиль @житель
Подработка — основной легальный способ заработка в городе. Система назначает случайную вакансию в соответствии с полом жителя и генерирует короткую историю о рабочей смене.
Вознаграждение — от 500 до 1500 ₽ наличными. Сумма случайна при каждом вызове.
!работа
После каждой смены необходима пауза. Повторная подработка доступна через 24 часа. Попытка вызвать команду раньше отображает оставшееся время ожидания.
Перечень мест подработки зависит от пола жителя. Среди мужских вакансий: завод, склад, бригада по ремонту, библиотека, кофейня, парикмахерская. Список женских вакансий аналогичен по объёму. Все вакансии равнозначны по оплате — специализация влияет только на повествование.
Банковский счёт защищён от кражи. Перевести наличные на банк — депозит; снять обратно — снятие. Вместо точной суммы можно указать all — система переведёт весь доступный остаток.
!деп <сумма|all> — внести наличку в банк
!снять <сумма|all> — снять с банка в наличку
Штраф выписывается сотрудником правоохранительных органов. При получении штрафа система предлагает два варианта: оплатить немедленно или отложить в долг. Если наличных недостаточно для полной оплаты — часть вносится сразу, остаток записывается в долг.
!штрафы — список неоплаченных штрафов
!штрафы оплаченные — история оплаченных
!штрафы оплатить <номер> — погасить конкретный штраф
Неоплаченные штрафы формируют долг. Долг не начисляет процентов и не аннулируется автоматически — он числится до момента погашения. Общая сумма задолженности отображается в нижней части списка штрафов.
Если наличных не хватает на погашение — пополните счёт подработкой или переводом, затем оплатите штраф.
Каждая структура города ведёт отдельный бюджет: мэрия, полиция, больница, прокуратура. Внести средства в бюджет своей структуры могут главы ведомств. Снять средства из любого бюджета — исключительное полномочие мэра.
!бюджет — просмотр состояния всех бюджетов
!бюджет внести <сумма> [структура] — внести средства
!бюджет снять <сумма> <структура> — снять средства (только мэр)
Кража — единственный незаконный способ получить чужие деньги. Жертвой может стать любой зарегистрированный житель с ненулевым наличным балансом.
!украсть @житель
При каждой попытке система бросает вероятность. С шансом 40% кража проваливается — бот генерирует короткую историю о неудаче. С шансом 60% попытка успешна: похищается от 10% до 50% наличных жертвы.
Украденное немедленно поступает на наличный счёт грабителя. Оба участника получают запись в статистике.
Для совершения кражи необходим действующий паспорт. Без него система немедленно отклоняет попытку — грабителя «поймают».
После успешного ограбления жертва получает защиту на 6 часов: повторное нападение в этот период невозможно. Грабитель не может пытаться снова в течение того же времени. На себя нападать нельзя.
Полиция вправе выписать штраф за любое нарушение порядка, включая кражу. Штраф назначается вручную сотрудником правоохранительных органов. Механика кражи не предусматривает автоматического штрафа — только потерю кулдауна при провале.
Бот написан на Python 3.10+. Основные зависимости: discord.py (асинхронный фреймворк), aiosqlite (асинхронная работа с SQLite), Pillow (рендер карты боёв), python-dotenv (переменные окружения).
База данных — SQLite, файл city.db. Хранится рядом с точкой входа. Все операции асинхронные через aiosqlite.
Бот использует систему когов (cogs) — каждый функциональный модуль вынесен в отдельный файл в директории cogs/. Все коги регистрируются через setup(bot) и загружаются при старте.
Upper_Siberia_test.py — точка входа, инициализация БД, загрузка когов
config_command_names.py — все алиасы команд и тексты страниц !help
utils.py — вспомогательные функции, константы
embed_generation.py — фабрики embed-сообщений
map_render.py — рендер тактической карты (Pillow)
| Таблица | Назначение | Ключевые поля |
|---|---|---|
| accounts | Финансовые счета жителей | discord_id, cash, bank, last_daily |
| passports | Паспортные данные | discord_id, name, age, photo_url, issued_at, issued_by_id |
| fines | Штрафы (оплаченные и нет) | discord_id, user_fine_n, amount, reason, issued_by, paid |
| stats | Статистика жителей | discord_id, rob_count, robbed_count, fines_count |
| levels | Уровни и XP | discord_id, xp |
| inventory | Инвентарь | discord_id, item_key, quantity |
| rob_cooldowns | Защита жертв ограбления | discord_id, last_robbed_at |
| sidejob_cooldowns | Кулдаун подработки | discord_id, last_used_at |
| budgets | Бюджеты структур | structure, balance |
| budget_log | Лог бюджетных операций | structure, action, amount, actor_id, acted_at |
| mutes | Активные мьюты | discord_id, guild_id, unmute_at, saved_roles |
| mute_history | История мьютов | discord_id, issued_by_id, reason, duration_sec, muted_at |
| passport_request_cooldowns | Защита от повторных запросов паспорта | pair_key, denied_at |
1. Выбрать или создать подходящий ког в cogs/.
2. Добавить алиасы в config_command_names.py — список ALIASES.
3. Импортировать список алиасов в kog через from config_command_names import ...
4. Декорировать функцию: @commands.command(aliases=ALIAS_LIST).
5. При необходимости добавить запись в HELP_PAGES в том же конфиге.
6. Перезапустить бота — изменения применяются автоматически.
Конфигурация хранится в файле .env рядом с точкой входа. Загружается через python-dotenv.
DISCORD_BOT_TOKEN — токен бота
ADMIN_ROLE_IDS — ID ролей администраторов через запятую
MAYOR_ROLE_ID — ID роли мэра
PASSPORT_CHANNEL_ID — ID канала мэрии для паспортных операций