Руководство

Исходный код игры Number Match: как устроен Tenguin и что менять

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

Основной арт Tenguin: пингвин в красном шарфе машет со льдины рядом с плитками с числами 3 и 7.

Исходный код игры Number Match стоит покупать, если нужна готовая головоломка на сумму десять с картой уровней, бустерами и ежедневным контентом, а вы предпочитаете менять цены и брендинг, а не писать движок сопоставления с нуля. Tenguin как раз такой пакет: игроки соединяют одинаковые числа или два числа, которые в сумме дают десять, на десяти иллюстрированных островных темах. Обычная цена — $39.

Это руководство для того, кто откроет папку с файлами. Здесь описано, какие правила применяет код, что хранится в конфиг-файле, что требует исходников и какие настройки могут навредить на живом сайте. Если нужна только суть: большинство коммерческих правок — это один текстовый файл и перезагрузка страницы.

Правила, которые исходный код игры Number Match уже выполняет

Игрок нажимает одну плитку, затем другую. Пара исчезает, если числа равны или в сумме дают десять. Плитки могут стоять друг над другом, рядом, по диагонали, с пустыми клетками между ними или на стыке конца одной строки и начала следующей.

Очистка целой строки запускает «Лавину», а серия подряд повышает множитель очков. Когда пар не остаётся, «Снегопад» копирует оставшиеся на поле числа вниз. На каждом уровне можно получить до трёх звёзд.

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

Проверить правила в демо Tenguin

Бустеры, ежедневный контент и режим отдыха

Пять бустеров открываются по этапам, поэтому ранние уровни учат игру постепенно:

  • Подсказка.
  • Отмена, с 3 уровня.
  • Снегопад, который заполняет поле копиями оставшихся чисел.
  • Клевок, который убирает одну плитку, с 8 уровня.
  • Wild, снежинка, которая подходит к любому числу, с 12 уровня.

Ежедневное задание, составленное по сегодняшней дате, ежедневные миссии и сундуки глав дают игрокам причину возвращаться. Режим отдыха без звёзд, без спешки и с неограниченным «Снегопадом» для тех, кто просто хочет убирать плитки.

Наряды для пингвина делятся на четыре категории: шарфы, шапки, цвета и эффекты. Их покупают за монеты, заработанные в игре, а некоторые уровни открывают наряд. Реальные деньги не участвуют.

Что входит в загрузку

  • Готовая папка game/ для размещения на хостинге, с локальной графикой, шрифтами, аудиофайлами и зависимостями среды выполнения.
  • Читаемый исходный код с конфигурацией и уведомлениями о лицензиях сторонних компонентов.
  • 49 автоматических тестов.
  • Иллюстрированное офлайн-руководство для покупателя на 14 языках, со скриншотами на английском.

Интерфейс доступен на 14 языках: английском, португальском, испанском, французском, немецком, итальянском, нидерландском, польском, турецком, русском, индонезийском, японском, корейском и упрощённом китайском. Стек: TypeScript, JavaScript и HTML5, для сборки из исходников используется Vite. В файлах есть HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG и MP3.

Одна деталь, которую стоит знать, глядя на страницу товара: иллюстрированные панели — это рекламная графика, а галерея скриншотов показывает реальную игру. Оценивайте внешний вид по скриншотам и демо.

Конфиг-файл: правки без сборки

Большинство настроек хранятся в tenguin.config.js, текстовом файле рядом с index.html. Измените значение, загрузите файл и перезагрузите страницу. Ни Node.js, ни этапа сборки не нужно. В файле есть:

  • Заголовок страницы и путь к логотипу.
  • Акцентный цвет.
  • Язык по умолчанию.
  • Стартовые монеты.
  • Награды за победу, за звёзды и в режиме отдыха.
  • Цены бустеров и нарядов.

Это покрывает две частые задачи: свой бренд на экране и экономику, настроенную под аудиторию. Если игрокам кажется, что бустеры дорогие, меняется число, а не код.

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

Что требует исходника TypeScript

Раскладку уровней, диалоги, графику внутри игры и новые голосовые фрагменты меняют в редакции с исходниками, а затем пересобирают с Node.js 22.13 или новее. Node нужен не для размещения игры, а только для пересборки.

Карта уровней состоит из десяти иллюстрированных островных тем. После десятой прогресс продолжается сгенерированными уровнями с повторным использованием существующих тем. Добавление одиннадцатой темы — это новая графика и новые позиции на карте в исходниках, то есть работа художника плюс немного кода, а не настройка.

Запускайте 49 тестов после каждого изменения исходников. Так быстрее всего увидеть, не сломала ли правка какое-то другое правило.

  1. Сделайте резервную копию пакета.
  2. Внесите изменение в исходники.
  3. Запустите тесты.
  4. Соберите игру и замените размещённую папку game/ полным результатом сборки.
  5. Сыграйте несколько уровней на телефоне и в браузере на компьютере.

Размещение, встраивание и доступность

Загрузите содержимое game/ на статический HTTP(S)-хостинг, при желании в подпапку. PHP и база данных не нужны. Открытие файлов с диска через file:// не поддерживается, поэтому тестируйте через веб-сервер.

Игра работает в актуальных версиях Chrome, Edge, Firefox и Safari на компьютере, планшете или телефоне. Игроки загружают её с вашего адреса; это не приложение для офлайн-установки. В настройках есть крупные плитки, высокий контраст, спокойный режим и вибрация на телефонах, которые её поддерживают. Это полезно, если в аудитории есть пожилые игроки или дети.

В пакете нет проекта нативного приложения и не подключён рекламный провайдер. Если нужно одно из этого или чтобы игра была установлена на вашем сервере, мы оцениваем такую работу по каждому проекту.

Запросить расчёт индивидуальной работы

Ограничения и лицензия в одном абзаце

В Tenguin нет облачных сохранений, онлайн-аккаунтов, удалённых таблиц лидеров, покупок за реальные деньги и подключённого рекламного провайдера; нативные приложения, хостинг и индивидуальная разработка не входят в состав. Прогресс хранится в локальном хранилище браузера. Одна покупка даёт бессрочную неэксклюзивную лицензию на один конечный продукт — ваш или одного клиента, — который игроки могут использовать бесплатно или с монетизацией через рекламу. Внутри этого продукта можно менять код, графику и аудио и заменить наш бренд на свой, но нельзя перепродавать или передавать шаблон, его исходники или ассеты отдельно. Поддержка длится 6 месяцев, или 12, если при оплате выбрано продление поддержки. Обычная цена — $39. До 30 ноября 2026 года акция «Чёрная пятница» даёт скидку 15% на каждый шаблон, поэтому Tenguin стоит $33,15, а с 1 декабря цены возвращаются к обычным.

Прочитать условия лицензии и поддержки

Часто задаваемые вопросы

Каковы правила игры Number Match?

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

Нужно ли собирать игру?

Нет. Загрузите содержимое game/ на HTTP(S)-хостинг. Сборка нужна только если вы меняете исходники.

Что можно менять без пересборки?

Заголовок, путь к логотипу, акцентный цвет, язык по умолчанию, стартовые монеты, награды, цены бустеров и нарядов — всё это в tenguin.config.js.

Сколько уровней?

Уровни идут по карте из десяти островных тем. После десятой темы игра продолжается сгенерированными уровнями и повторно использованными темами.

Можно ли провести с ней конкурс с призами?

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

Работает ли игра на планшетах?

Да. Игра работает в актуальных браузерах на компьютерах, планшетах и телефонах; в настройках есть опция крупных плиток.

Для кого подходит и два пазла для сравнения

Игра Number Match подходит casual-порталам, образовательным сайтам и брендам, которым нужна спокойная головоломка с ежедневным поводом вернуться. Правило «сделай десять» просто объяснить, а бустеры открываются достаточно медленно, чтобы учить по ходу игры.

Для сравнения: Gridspark — блочная головоломка 8×8 с ходом-молнией ZAP и ежедневным заданием, одинаковым для всех игроков, $29 по обычной цене. Bodoku — логическая головоломка с призраками, 180 уровней в шести крыльях замка, $59 по обычной цене. В обеих 14 языков интерфейса.

Посмотреть Gridspark, блочную головоломку

Посмотреть Bodoku, логическую головоломку

Два шаблона в одном заказе дают скидку 5% на каждую лицензию, три — 10%, четыре — 15%, пять и больше — 20%.

Получить исходный код Tenguin Number Match