넘버 매치 게임 소스코드: Tenguin 구조와 수정법
짝짓기 규칙, 부스터, 빌드 없이 고치는 설정 파일, 그리고 TypeScript 소스가 필요한 부분을 정리했습니다.
넘버 매치 게임 소스코드는 레벨 맵, 부스터, 일일 콘텐츠를 갖춘 완성형 '10 만들기' 퍼즐이 필요하고, 매칭 엔진을 직접 짜기보다 가격과 브랜딩만 조정하고 싶을 때 좋은 선택입니다. Tenguin이 바로 그런 패키지입니다. 같은 숫자끼리, 또는 합이 10인 두 숫자를 짝지으며 일러스트로 그린 열 가지 섬 테마를 지나가고, 정가는 $39입니다.
이 글은 폴더를 직접 열어 볼 사람을 위한 안내입니다. 코드가 적용하는 규칙, 설정 파일에 있는 것, 소스가 필요한 것, 운영 중인 사이트에서 문제를 일으킬 수 있는 설정을 설명합니다. 결론만 원한다면, 상업적인 수정 대부분은 텍스트 파일 하나와 페이지 새로고침으로 끝납니다.
넘버 매치 게임 소스코드가 이미 처리하는 규칙
플레이어는 타일 하나를 탭하고, 이어서 다른 타일을 탭합니다. 두 숫자가 같거나 합이 10이면 짝이 사라집니다. 두 타일은 위아래, 좌우, 대각선으로 놓여 있어도 되고, 사이에 이미 비워진 칸이 있어도 되며, 한 줄의 끝과 다음 줄의 시작에 걸쳐 있어도 됩니다.
한 줄을 모두 비우면 Avalanche(눈사태)가 일어나고, 연속으로 짝을 지으면 점수 배수가 올라갑니다. 더 이상 짝이 없으면 Snowfall(눈 내리기)이 보드에 남은 숫자를 아래쪽에 복사합니다. 레벨마다 최대 별 세 개를 받습니다.
줄을 넘어가는 짝과 빈칸 처리는 넘버 매치 엔진이 정확해야 하는 검사입니다. 플레이어가 보기에 맞는 짝이면 코드에서도 맞아야 합니다. 이 검사들은 제공되는 게임에 이미 들어 있습니다.
부스터, 일일 콘텐츠, Relax 모드
부스터 다섯 가지는 단계적으로 열리기 때문에, 초반 레벨이 자연스럽게 플레이 방법을 가르칩니다.
- Hint(힌트)
- Undo(되돌리기, 레벨 3부터)
- Snowfall: 남은 숫자의 복사본으로 보드를 다시 채웁니다.
- Peck(쪼기): 타일 하나를 없앱니다(레벨 8부터).
- Wild(와일드): 어떤 숫자와도 짝이 되는 눈송이(레벨 12부터)
오늘 날짜로 만들어지는 일일 챌린지, 일일 미션, 챕터 보물상자가 플레이어를 다시 찾아오게 합니다. Relax 모드에는 별점도 시간 압박도 없고 Snowfall이 무제한이어서, 그냥 타일을 비우고 싶은 플레이어에게 맞습니다.
펭귄 의상은 목도리, 모자, 색상, 효과의 네 종류입니다. 게임에서 번 코인으로 사며, 일부 레벨에서는 의상이 열립니다. 실제 돈은 쓰이지 않습니다.
다운로드 구성
- 그래픽, 폰트, 오디오 파일, 런타임 의존성이 로컬로 들어 있는, 바로 호스팅할 수 있는 game/ 폴더
- 설정과 서드파티 라이선스 고지가 포함된 읽기 쉬운 소스코드
- 자동 테스트 49개
- 14개 언어로 된 구매자용 오프라인 그림 가이드(스크린숏은 영어)
인터페이스는 14개 언어를 지원합니다. 영어, 포르투갈어, 스페인어, 프랑스어, 독일어, 이탈리아어, 네덜란드어, 폴란드어, 터키어, 러시아어, 인도네시아어, 일본어, 한국어, 중국어 간체입니다. 기술 스택은 TypeScript, JavaScript, HTML5이며 소스 빌드에는 Vite를 씁니다. 파일 형식은 HTML, CSS, JavaScript, JSON, TypeScript, WebP, PNG, MP3입니다.
상품 페이지를 볼 때 알아 둘 점이 있습니다. 일러스트 패널은 홍보용 그림이고, 스크린숏 갤러리가 실제 게임 화면입니다. 외관은 스크린숏과 데모로 판단하세요.
설정 파일: 빌드 없이 수정하기
대부분의 설정은 index.html 옆의 텍스트 파일 tenguin.config.js에 있습니다. 값을 바꾸고 파일을 올린 뒤 새로고침하면 됩니다. Node.js도 빌드도 필요 없습니다. 들어 있는 항목은 다음과 같습니다.
- 페이지 제목과 로고 경로
- 강조 색상
- 기본 언어
- 시작 코인
- 승리, 별, Relax 보상
- 부스터 가격과 의상 가격
이것으로 흔한 요구 두 가지가 해결됩니다. 화면에 귀사 브랜드를 넣는 것, 그리고 대상 사용자에 맞게 경제를 조정하는 것입니다. 플레이어가 부스터가 너무 비싸다고 느끼면 코드가 아니라 숫자 하나를 바꾸면 됩니다.
주의할 설정이 하나 있습니다. 바로 저장 키입니다. 출시 전에 정하고 이후에는 그대로 두세요. 운영 중인 사이트에서 바꾸면 모든 플레이어의 진행 상황이 사라집니다.
TypeScript 소스가 필요한 부분
레벨 배치, 대사, 게임 속 그래픽, 새 음성 클립은 소스 에디션에서 바꾸고 Node.js 22.13 이상으로 다시 빌드합니다. Node는 게임을 호스팅할 때가 아니라 다시 빌드할 때만 필요합니다.
레벨 맵에는 일러스트로 그린 섬 테마가 열 가지 있습니다. 열 번째 이후에는 기존 테마를 재사용하는 생성 레벨로 진행이 이어집니다. 열한 번째 테마를 추가하려면 소스에 새 그래픽과 새 맵 위치가 필요하므로, 설정 변경이 아니라 그래픽 작업에 약간의 코드 작업을 더한 일로 계획하세요.
소스를 수정할 때마다 테스트 49개를 돌리세요. 수정이 다른 곳의 규칙을 망가뜨렸는지 가장 빨리 확인하는 방법입니다.
- 패키지를 백업합니다.
- 소스에서 수정합니다.
- 테스트를 실행합니다.
- 빌드한 뒤 서버의 game/ 폴더를 전체 결과물로 교체합니다.
- 휴대폰과 데스크톱 브라우저에서 몇 레벨을 플레이해 봅니다.
호스팅, 임베드, 접근성
game/ 폴더의 내용을 정적 HTTP(S) 호스팅에 올리면 됩니다. 하위 폴더도 괜찮습니다. PHP나 데이터베이스는 필요 없습니다. file://로 디스크의 파일을 바로 여는 방식은 지원하지 않으니 웹 서버에서 테스트하세요.
게임은 컴퓨터, 태블릿, 휴대폰의 최신 Chrome, Edge, Firefox, Safari에서 실행됩니다. 플레이어는 귀사 주소에서 게임을 불러오며, 설치형 오프라인 앱이 아닙니다. 설정에는 큰 타일, 고대비, 차분한 모드, 지원 휴대폰의 진동이 있어서, 대상 사용자에 어르신이나 어린이가 있다면 도움이 됩니다.
패키지에는 네이티브 앱 프로젝트도, 연동된 광고 제공업체도 없습니다. 둘 중 하나가 필요하거나 귀사 서버에 게임을 설치하고 싶다면 프로젝트별로 견적을 드립니다.
제한 사항과 라이선스 한눈에 보기
Tenguin에는 클라우드 저장, 온라인 계정, 서버 리더보드, 실제 결제, 연동된 광고 제공업체가 없으며, 네이티브 앱, 호스팅, 맞춤 개발도 포함되지 않습니다. 진행 상황은 브라우저의 로컬 저장소에 남습니다. 한 번 구매하면 최종 제품 하나(귀사 제품 또는 고객사 제품 하나)에 쓸 수 있는 영구적·비독점 라이선스를 받으며, 플레이어는 무료로 또는 광고 수익화와 함께 이용할 수 있습니다. 해당 제품 안에서 코드, 그래픽, 오디오를 수정하고 우리 브랜드를 귀사 브랜드로 바꿀 수 있지만, 템플릿이나 소스, 에셋을 단독으로 재판매하거나 공유할 수는 없습니다. 지원 기간은 6개월이며 결제 시 연장하면 12개월입니다. 정가는 $39이며, 2026년 11월 30일까지 블랙 프라이데이 프로모션으로 모든 템플릿이 15% 할인되어 Tenguin은 $33.15입니다. 12월 1일부터는 정가로 돌아갑니다.
자주 묻는 질문
넘버 매치 게임의 규칙은 무엇인가요?
Tenguin에서는 두 타일의 숫자가 같거나 합이 10이고, 그 사이에 비워진 칸만 있으면 두 타일이 사라집니다. 짝은 세로, 가로, 대각선이 될 수 있고, 한 줄의 끝에서 다음 줄의 시작으로 이어질 수도 있습니다.
게임을 빌드해야 하나요?
아니요. game/ 폴더 내용을 HTTP(S) 호스팅에 올리면 됩니다. 빌드는 소스를 바꿀 때만 필요합니다.
다시 빌드하지 않고 바꿀 수 있는 것은 무엇인가요?
제목, 로고 경로, 강조 색상, 기본 언어, 시작 코인, 보상, 부스터 가격, 의상 가격이며 모두 tenguin.config.js에 있습니다.
레벨은 몇 개인가요?
레벨은 열 가지 섬 테마로 이루어진 맵을 따라 이어집니다. 열 번째 테마 이후에는 생성 레벨과 재사용 테마로 게임이 계속됩니다.
경품 이벤트에 써도 되나요?
권하지 않습니다. 일일 콘텐츠는 기기 시계를 쓰고 기록은 로컬에 저장되므로, 경품을 정하는 공정한 기준이 되지 못합니다.
태블릿에서도 작동하나요?
네. 컴퓨터, 태블릿, 휴대폰의 최신 브라우저에서 실행되며, 설정에 큰 타일 옵션이 있습니다.
어울리는 곳, 그리고 비교해 볼 퍼즐 두 가지
넘버 매치 게임은 캐주얼 게임 포털, 교육 성격의 사이트, 매일 다시 찾을 이유가 있는 편안한 퍼즐을 원하는 브랜드에 잘 맞습니다. 10 만들기 규칙은 설명하기 쉽고, 부스터가 천천히 열려 플레이하면서 자연스럽게 익힐 수 있습니다.
비교하자면, Gridspark는 번개 ZAP 기술과 시드 기반 일일 챌린지가 있는 8×8 블록 퍼즐로 정가 $29입니다. Bodoku는 성의 여섯 구역에 180개 레벨이 있는 유령 논리 퍼즐로 정가 $59입니다. 둘 다 14개 인터페이스 언어를 지원합니다.
한 주문에 템플릿 두 개는 라이선스마다 5%, 세 개는 10%, 네 개는 15%, 다섯 개 이상은 20% 할인됩니다.