Жёлтый картридж
Сборник игр на двоих в Telegram (бот @yellow_cartridge_bot), сделанный как Telegram Mini App.
В сборнике игры: платформер «Прыг-Скок», танковая дуэль «Танкодром» (web/tanks/), игра с бомбами «Бомбодром» (web/bombs/, одиночная и дуэль онлайн), «Тир» (web/range/: прицел ведётся наклоном телефона по гироскопу или пальцем и мышью) и словесная головоломка «Слово дня» (web/word/, сейчас скрыта).
Вся графика и звуки нарисованы и сгенерированы в коде, файлов из чужих игр здесь нет;
откуда взят каждый файл и библиотека, записано в ASSETS.md.
Задачи проекта и правила для PR — в docs/TZ.md. Код распространяется по лицензии MIT (LICENSE).
«Прыг-Скок»
- Восемь миров по четыре уровня, перед каждым заставка «МИР N-M»; большой герой остаётся большим при переходе.
Раскладка всех 32 уровней повторяет классические уровни приставки блок в блок: земля, кирпичи, блоки с бонусами,
трубы, враги, лифты, лозы, облака, бонусные комнаты, контрольные точки и время на таймере. Карты собраны
в
web/worlds.js; каждый уровень — основная трасса и его подземные комнаты, облака и выходы как отдельные участки.
- Замки: лава с огненными шарами, огненные вертушки, мост с большим жуком-боссом и рычаг, который обрушивает мост.
- 4-4 и 7-4 — лабиринты: на развилке неверный путь возвращает назад (в 7-4 правильные пути «низ, середина, верх»
и «верх, середина, верх»). В 8-4 дальше ведут только нужные трубы, к одной из них — по скрытому блоку.
- Под водой (2-2, 7-2) каждое нажатие A — гребок вверх; в 2-3 и 7-3 из воды выпрыгивают рыбы.
- После 8-4 игра пройдена.
- Трубы зоны перехода в 1-2 ведут сразу в начало мира 2, 3 или 4, в 4-2 — в мир 5, 6, 7 или 8.
- Лоза: вырастает из кирпича, если ударить его снизу; ↑ и ↓ — лезть, ← → или A — спрыгнуть. Наверху облака с монетами
и облачной лодкой, которая везёт героя, когда он на неё встанет; упав с облаков, герой возвращается на уровень дальше.
- Пушки стреляют пулями в сторону героя, если он не стоит рядом; на пулю можно прыгнуть сверху.
- Потеря жизни: уровень начинается заново, а если пройдена середина — с середины.
Когда жизни кончились, можно купить ещё одну жизнь за жетоны или звёзды и продолжить с того же места, иначе игра начинается с 1-1.
- Жуки-враги: на них можно прыгать сверху. Растения не вылезают из трубы, пока герой стоит рядом; их можно сбить огнём.
- Ягода делает героя большим: он ломает кирпичи и переживает одно касание врага.
- Счёт, монеты, жизни, таймер и рекорд (хранится на устройстве).
- Управление как на старом восьмибитном джойстике: крестовина ▲ ▼ ◀ ▶ (▼ — присесть и залезть в трубу), A (прыжок), B (бег, а с огненной силой ещё и выстрел), ТУРБО A и ТУРБО B. Клавиатура: стрелки, A: Z/пробел, B: X/Shift, турбо A: A, турбо B: S.
- Внутри Telegram: разворот на весь экран и вибрация при прыжках и ударах.
«Слово дня»
- Одно слово из 5 букв на всех в день (своё на русском и на английском, кнопка RU/EN), 6 попыток, подсказки цветом.
Новое слово в 00:00 UTC.
- Слово выбирает сервер и сам проверяет попытки (
bot/word.js): ответ не попадает в игру, пока она не закончена.
- Очки дня: 6 с первой попытки … 1 с шестой; серия дней подряд. Очки за неделю — в таблице игры в «◆ Жетоны» и в призах недели.
- «Поделиться» отправляет в любой чат сетку цветных квадратиков без спойлера и ссылку
t.me/<бот>?startapp=ref_<id>-word:
друг сразу попадает в игру на то же слово, а приглашение засчитывается.
- Таблица чата: кто открыл игру по ссылке из группового чата, видит результаты этого чата за сегодня и очки за неделю.
- Задания и магазин (темы плиток) — по общей схеме жетонов, кнопка «◆».
Структура
web/ — сборник (статический сайт): меню и «Прыг-Скок» (index.html, menu.js, game.js), «Танкодром» в web/tanks/.bot/ — бот и сервер рекордов, см. bot/README.md.web/lib/phaser.min.js — движок Phaser 3.80.1 (лицензия MIT, web/lib/phaser-LICENSE.md)..github/workflows/pages.yml — публикация папки web/ на GitHub Pages при пуше в main.
Запуск локально
cd web
python3 -m http.server 8000
Откройте http://localhost:8000.
Подключение к Telegram
- В настройках репозитория: Settings → Pages → Source: GitHub Actions.
- После пуша в
main игра будет доступна по адресу https://admin2vitaplus.github.io/tg-mario/.
- В @BotFather:
/mybots → ваш бот → Bot Settings → Menu Button → укажите этот адрес.
Либо /newapp, чтобы у игры была своя ссылка t.me/<бот>/<имя>.
Токен бота в репозиторий не кладётся. Если понадобится серверная часть, токен хранится в .env (он в .gitignore) или в секретах хостинга.
