Skip to content

About

Python port of the cult DOS quest Heroes of Math and Mechanics (Герои Мата и Меха)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

mmheroes (Python Port)

Порт культового DOS-текстового квеста «Герои Мата и Меха» (Heroes of Math and Mechanics, оригинальная версия на Borland Pascal 7.0, 2001 г.) на чистый Python 3 с поддержкой терминального интерфейса (curses / ANSI 16 цветов CGA).

Все тексты, механики зачетной недели, персонажи, перемещения одногруппников, сны, экзамены и пасхалки бережно сохранены в неизменном виде.

Screenshot

Запуск игры на Python

Требования

  • Python 3.8 или новее.
  • На Linux и macOS используются стандартные библиотеки (curses).
  • На Windows при установке автоматически используется windows-curses.

Запуск напрямую без установки

python3 -m mmheroes

Установка в окружение

pip install .
mmheroes

Параметры командной строки

mmheroes [-h] [-v] [--god] [-r] [--load FILE] [--save FILE] [--scores] [--reset-scores] [--headless]

Параметры:
  -h, --help      Справка по командам.
  -v, --version   Версия программы.
  --god           Разрешить выбор GOD-режима при старте.
  -r, --random    Быстрый старт со случайными характеристиками студента.
  --load FILE     Загрузить прогресс игры из JSON-файла.
  --save FILE     Сохранить прогресс игры в JSON-файл при выходе.
  --scores        Показать таблицу рекордов и выйти.
  --reset-scores  Сбросить рекорды к исходным значениям.
  --headless      Режим работы без curses (для тестов и автоматизации).

Управление в игре

  • Стрелки Вверх / Вниз: выбор пункта меню или диалога.
  • Enter: подтвердить выбор.
  • Ввод текста: при вводе имени героя поддерживается полное редактирование строки (стрелки, Backspace, Delete, Home, End).
  • Ctrl+C: безопасный выход с корректным сбросом цветов терминала.

Архитектура проекта

mmheroes/
├── __init__.py        # Метаданные пакета
├── __main__.py        # CLI точка входа (argparse, обработка сигналов)
├── storage.py         # Сохранение и загрузка игры и таблицы рекордов в JSON
├── game/
│   ├── data.py        # Константы, цитаты, реплики, тексты снов, предметы
│   ├── state.py       # Датаклассы Hero, Subject, Timesheet, GameState
│   └── logic.py       # Игровой цикл, переходы между сценами, экзамены, перемещения
└── ui/
    ├── terminal.py    # Эмуляция CRT-терминала на curses (16 цветов CGA, getch)
    └── render.py      # Отрисовка экранов, расписания, характеристик, диалогов

Запуск тестов

Тестовый набор покрывает структуры данных, сериализацию, терминал, рендеринг экранов и игровую логику:

python3 -m unittest discover tests -v

Исходная информация (JS / DOS)

Оригинальная DOS-версия: http://mmheroes.chat.ru/hmm.htm Процесс декомпиляции JS-порта: https://sharpc.livejournal.com/75856.html

About

Python port of the cult DOS quest Heroes of Math and Mechanics (Герои Мата и Меха)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages