가이드

자바스크립트 메모리 게임: 소스 코드는 어떻게 작동하나

섞은 짝, 세 상태의 카드 뒤집기 잠금, 짝 확인, 승리 조건을 짧은 코드 조각으로 보여 주고, 완성된 템플릿에 무엇이 더 들어 있는지도 설명합니다.

카드 격자에서 카드를 뒤집는 판다 Polarzinho. 사자와 기린 짝이 앞면으로 보이고, 위에는 코드 괄호가 떠다님

자바스크립트로 만드는 메모리 게임에는 네 가지가 필요합니다. 기호마다 두 장씩 들어간 섞인 카드 덱, 세 가지 상태(열린 카드 없음, 한 장 열림, 두 장 열리고 판이 잠김)를 가진 뒤집기 상태 기계, 맞은 짝을 열린 채로 두는 확인 로직, 그리고 남은 짝이 없을 때 실행되는 승리 조건입니다. 타이머부터 뒤집기 애니메이션까지 나머지는 이 네 부분 위에 얹는 연출이에요.

아래에서는 각 부분을 이 글을 위해 새로 쓴 짧은 자바스크립트 조각으로 설명합니다. 이것은 설명용 예시이고, 저희 템플릿 안의 코드가 아닙니다. 그다음 완성된 게임에 무엇이 더 들어가는지, 그리고 메모리 게임 소스 코드를 사는 편이 언제 더 빠른지 살펴볼게요.

자바스크립트 메모리 게임의 네 부분

짝으로 덱 만들기

고유한 기호마다 카드를 한 장씩 더 만들고, 각 카드에 고유한 키를 줍니다. symbols = ['owl', 'fox', 'cat', 'bee']일 때 이 줄은 카드 8장을 만들어요: const deck = symbols.flatMap((s) => [s, s]).map((symbol, i) => ({ key: i, symbol, open: false, matched: false })); 짝을 찾을 때는 symbol을 비교하고, key로 각 카드를 화면의 요소와 연결하세요.

sort가 아니라 Fisher-Yates로 섞기

널리 쓰이는 deck.sort(() => Math.random() - 0.5)는 편향되어 있어요. sort는 일관된 비교를 기대하는데, 무작위 답이 나오면 어떤 순서는 다른 순서보다 훨씬 자주 나오고, 그 정도는 브라우저마다 달라요. Fisher-Yates는 끝에서부터 걸어가며 각 요소를 자기 자리 이하의 무작위 위치와 바꿔서, 모든 순서가 같은 확률을 갖게 해 줍니다:

for (let i = deck.length - 1; i > 0; i--) { const j = Math.floor(Math.random() * (i + 1)); [deck[i], deck[j]] = [deck[j], deck[i]]; }

i + 1이 중요해요. j가 i와 같아질 수 있어야 하고, 그렇지 않으면 어떤 카드도 제자리에 남을 수 없게 돼요.

뒤집기 잠금: 세 가지 상태

처음 만든 버전에는 거의 모두 세 번째 카드 버그가 있어요. 두 장이 틀려서 다시 닫히기 전에 플레이어가 세 번째 카드를 누르는 경우죠. 변수 두 개로 고칠 수 있어요. first는 앞면으로 열린 카드를 담고, lock은 틀린 짝이 닫히기를 기다리는 동안 true가 돼요. 그러면 세 가지 상태가 생겨요. 열린 카드 없음(first가 null), 한 장 열림(first가 설정됨), 두 장 열림(lock이 true). 클릭 핸들러는 다음과 같아요.

  1. 잠겨 있거나 이미 열린 카드를 누르면 무시하세요: if (lock || card.open) return;
  2. 카드를 여세요. 첫 번째 카드라면 기억해 두고 멈춥니다: card.open = true; if (!first) { first = card; return; }
  3. 두 번째 카드이므로 이동 횟수를 셉니다: moves++;
  4. 짝이 맞으면 두 장을 열린 채로 둡니다: if (first.symbol === card.symbol) { first.matched = card.matched = true; first = null; pairsLeft--; }
  5. 아니라면 판을 잠그고, 잠깐 뒤에 두 장을 닫습니다: lock = true; const a = first; first = null; setTimeout(() => { a.open = card.open = false; lock = false; render(); }, 800);
  6. 짝을 맞춘 뒤에는 승리를 확인하세요: if (pairsLeft === 0) showWin(moves, seconds());

first를 지우기 전에 a에 복사해 두세요. 제한 시간은 800밀리초 뒤에 실행되는데, 그때는 first가 이미 비어 있어야 하기 때문이에요. 게임을 시작할 때 pairsLeft = symbols.length로 설정하고, 바뀔 때마다 render()를 호출하세요.

이동 횟수, 시간, 뒤집기 애니메이션, 접근성

이동 횟수와 시간

이동은 두 번째 카드에서만 셉니다. 시계는 페이지가 로드될 때가 아니라 첫 번째 뒤집기에서 시작하세요: let start = null; 을 두고, 클릭 핸들러 안에서 start ??= performance.now(); 를 실행하며, 값을 읽을 때는 const seconds = () => Math.round((performance.now() - start) / 1000); 를 씁니다. 브라우저는 백그라운드 탭의 타이머를 늦추기 때문에, setInterval 틱마다 1씩 더하면 시간이 어긋나지만, 타임스탬프는 정확하게 유지돼요.

두 줄로 만드는 CSS 3D 뒤집기

규칙 두 개가 뒤집기를 만듭니다: .card { transition: transform 0.4s; transform-style: preserve-3d; } 그리고 .card.open { transform: rotateY(180deg); } 양면에 backface-visibility: hidden을 주고, 앞면은 transform: rotateY(180deg)에서 시작하게 하며, 판에 perspective: 800px을 추가하세요. 애니메이션을 끈 플레이어를 위해서는 @media (prefers-reduced-motion: reduce) { .card { transition: none; } } 를 쓰세요.

키보드와 화면 읽기 프로그램

  • 카드마다 <button>을 쓰세요. 그러면 추가 코드 없이 Tab, Enter, Space가 동작합니다.
  • 카드 상태에 따라 레이블을 바꾸세요. 숨겨져 있을 때는 aria-label="Card 5, face down", 열리면 "Card 5, owl".
  • 맞은 카드는 disabled 속성으로 비활성화해서 Tab 순서에서 빠지게 하세요.
  • "Pair found" 또는 "No match"는 <p aria-live="polite"> 같은 라이브 영역에 알리세요.
  • 색깔에만 의존하지 마세요. 모양이 다른 기호를 쓰고, 맞은 짝은 테두리나 체크 표시로 나타내세요.

주말이면 되는 일과 몇 주가 걸리는 일

위의 내용은 테스트를 포함해도 주말이면 충분해요. 플레이어나 고객에게 건넬 수 있는 게임은 몇 주가 걸리는데, 대부분의 작업은 게임 루프 주변에 있기 때문이에요.

  • 레벨과 난이도 곡선. 플레이테스트로 조정해야 합니다.
  • 카드 앞면, 카드 뒷면, 배경, 인터페이스의 일관된 아트. 밀도가 높은 화면에서도 선명해야 해요.
  • 애니메이션과 피드백: 짝 효과, 콤보, 승리와 패배 화면.
  • 기록이 없거나 손상되어도 대처하는 저장 기능.
  • 긴 단어도 레이아웃에 맞게 보이는 언어 지원.
  • 터치 영역, 세로와 가로 방향, 작은 화면.
  • 게임이 기억하는 음악과 사운드 끄기/켜기.
  • 지원하는 모든 브라우저와 기기에서의 테스트.
Fireflip 레벨 5: 나무 다리 위의 등불 카드 열두 장, 판 위로 튀어 오른 +250 점수, 반딧불이 Flick이 Lucky!를 외치는 화면
Fireflip, Firefly Village: 찾은 짝이 빛나고, 옆에는 Peek와 Beacon 능력이 있어요.

살 수 있는 메모리 게임 소스 코드: Polar 템플릿 네 개

같은 구조에 테마만 다른 완성된 메모리 게임 네 개를 HTML5 템플릿으로 판매합니다. 이 글을 쓰는 시점에 각각 버전 1.0.0이고, 정가는 US$ 49입니다.

  • Memory Mansion: 아늑한 할로윈 유령의 집이며 무섭지 않아요. 작은 유령 Wisp, Peek와 Candle 능력, 모을 Spookies 60개.
  • Jinglewood Memory: 선물 태그 카드가 있는 크리스마스 마을. 순록 Tinsel, Peek와 North Star 능력, Snowpals 60개.
  • Safari Memory: 나무 사파리 카드와 아기 동물. 미어캣 Kiko, Peek와 Compass 능력, Safari Pals 60개.
  • Fireflip: 동화 같은 마을의 등불 카드. 반딧불이 Flick, Peek와 Beacon 능력, Glimmers 60개.
Memory Mansion 레벨 8: 유령이 나오는 홀의 카드 20장 판, 맞은 짝은 앞면으로 열려 있고, 왼쪽에는 유령 Wisp, 오른쪽에는 Peek와 Candle 버튼
Memory Mansion, Moonlit Manor: 찾은 짝은 열린 채로 빛나고, 옆에는 Peek와 Candle 능력이 있어요.

네 개 모두에 들어 있는 것

  • 5개 월드에 60개 레벨. 각 월드는 고유한 레벨 지도와 새로운 규칙을 가져요. 말풍선으로 나타나는 요청, 옆 짝을 맞출 때까지 붙잡혀 있는 카드, 카드 두 장을 바꾸는 돌풍, 그리고 자기 그림자와 짝을 이루는 캐릭터.
  • 레벨마다 이동 제한과 최대 별 3개, 별 9개마다 보상 상자, +5 이동 구조, Collection 앨범, 달력과 연속 기록이 있는 Daily 판.
  • 능력 두 가지: Peek는 모든 카드를 잠깐 보여 주고, 두 번째 능력은 카드의 짝이 어디 있는지 보여 줘요.
  • 인터페이스 14개 언어, 휴대폰, 태블릿, 데스크톱에서 세로와 가로 방향 모두 지원.
  • HTML5, Canvas 2D, Web Audio를 읽기 쉬운 순수 자바스크립트 모듈과 CSS로 구현했고, 의존성, 빌드 단계 없이 규칙 테스트가 들어 있어요. 파일은 HTML, CSS, JavaScript, PNG, WebP, MP3, WOFF2이며, 바로 호스팅할 수 있는 game/ 폴더가 있어요.
  • 영어, 포르투갈어, 스페인어로 된 삽화 오프라인 구매 가이드와 단계별 맞춤 설정 가이드.
Jinglewood Memory 레벨 30: 눈 덮인 숲의 카드 20장 판. 카드 한 장이 자물쇠가 달린 얼음 블록에 갇혀 있음
Jinglewood Memory, Frosted Forest: 얼음에 갇힌 카드는 옆 짝을 맞추면 무료로 녹아요.

쉽게 바꿀 수 있는 것

CUSTOMIZATION.html은 화면의 각 부분을 어떤 파일이 그리는지, 카드 그림, 카드 뒷면, 배경, 마스코트를 어떻게 교체하는지, 레벨, 능력, 보상, 문구가 어디에 있는지 보여 줘요. 마스코트, Daily 판, Collection은 설정 파일 하나에서 끌 수 있고, 캐릭터 이름은 카드 세트 파일 하나에 있어서 이름을 바꾸거나 번역하기 쉬워요.

가격, 묶음 등급과 한계

묶음 할인은 주문의 모든 라이선스에 적용됩니다. 두 개는 5%, 세 개는 10%, 네 개는 15%, 다섯 개 이상은 20%예요. 프로모션은 결제 화면에 보이는 대로만 적용돼요. 이 에디션에는 네이티브 앱, 호스팅, 맞춤 개발, 온라인 멀티플레이어, 온라인 순위, 인앱 구매, 광고 SDK가 포함되지 않아요. 진행 상황은 플레이어의 브라우저에 저장됩니다.

구매자 체크리스트

  1. 플레이어가 쓰는 휴대폰과 컴퓨터에서 가로와 세로 방향 모두 데모를 해 보세요.
  2. 온라인 문서가 바꾸려는 내용을 다루는지 확인하세요.
  3. 테마를 먼저 고르세요. 아트를 바꾸는 일은 규칙을 바꾸는 일보다 작아요.
  4. 인터페이스 14개 언어가 독자층에 맞는지 확인하세요.
  5. 출시 전에 최종 주소를 정하세요. 브라우저 저장은 사이트 주소에 속해요.
  6. 최종 제품 수를 세세요. 라이선스 하나는 제품 하나를 위한 것입니다.
Safari Memory 레벨 57: 밤의 초원 위에 직사각형이 아닌 배치로 놓인 카드들. 동물과 짝을 이루는 어두운 실루엣 카드 포함
Safari Memory, Starry Plains: 각 Safari Pal을 그림자와 짝지으세요.

HTML5 퍼즐 게임 템플릿 전체 보기

자주 묻는 질문

카드 이미지를 바꿀 수 있나요?

네. 각 패키지의 맞춤 설정 가이드가 카드 그림, 카드 뒷면, 배경, 마스코트를 교체하는 방법을 보여 줘요.

서버가 필요한가요?

정적 호스팅만 있으면 됩니다. game/ 안의 내용을 아무 HTTP(S) 호스트에나 올리면 되고, 데이터베이스나 개발자 계정은 필요 없어요.

고객을 위해 사용할 수 있나요?

네. 구매 한 건은 영구적이고 비독점인 라이선스로, 최종 제품 하나(본인 또는 고객 한 명)를 위한 것입니다. 화이트 라벨도 허용돼요. 템플릿이나 코드를 그 자체로 재판매하거나 공유하는 것은 안 됩니다.

어떤 지원이 포함되나요?

구매일로부터 6개월이며, 결제 때 연장 옵션을 고르면 12개월입니다. 맞춤 설정과 새 기능은 따로 견적을 냅니다.

이 글의 코드 조각은 템플릿에서 가져온 것인가요?

아니요. 이 가이드를 위해 쓴 짧은 예시입니다. 각 템플릿은 자체 구조를 가지고 있으며, 그 내용은 템플릿의 문서에 설명되어 있어요.

직접 만들까, 살까?

배우거나 프로토타입을 만들려면 반복 구조를 직접 만들어 보세요. 위의 조각만으로도 충분합니다. 고객의 출시나 시즌 일정이 있다면, 템플릿이 레벨, 아트, 언어, 테스트를 제공해서 여러분의 시간을 브랜딩과 콘텐츠에 쓸 수 있어요.

Memory Mansion: 할로윈 메모리 게임, 데모와 라이선스

Jinglewood Memory: 크리스마스 메모리 게임, 데모와 라이선스

Safari Memory: 사파리 동물 메모리 게임, 데모와 라이선스

Fireflip: 동화 메모리 게임, 데모와 라이선스

사이트에 넣을 HTML5 게임 구매 방법

변경이나 여러 라이선스가 필요하신가요? 견적 요청하기