ガイド

JavaScriptで作る神経衰弱ゲーム:ソースコードの仕組み

シャッフルされたペア、三つの状態を持つめくりのロック、一致判定、勝利条件を短いコードで。完成したテンプレートに何が加わるかも。

グリッドに並んだメモリーカードの一枚をめくるパンダのPolarzinho。ライオンとキリンのペアが表向きになり、上空にはコードの括弧が浮かんでいる。

JavaScriptの神経衰弱ゲームには四つのものが必要です。すべての絵柄が二つずつ現れるシャッフル済みのデッキ、三つの状態を持つめくりのステートマシン(カードが表向きなし、一枚表向き、二枚表向きで盤面がロック)、そろったペアを開いたままにする判定、そしてペアが残っていないときに発動する勝利条件です。タイマーからめくりのアニメーションまで、ほかのすべては、この四つの部分の上に乗る見せ方です。

以下では、各部分に、この記事のために書いた素のJavaScriptの短いスニペットを付けます。これは教えるための例であり、私たちのテンプレートの中のコードではありません。そのあと、完成したゲームが何を加えているか、そしてソースコードを買ったほうが早い場合を見ていきます。

JavaScriptの神経衰弱の四つの部分

ペアからデッキを作る

一意の絵柄をそれぞれ複製し、すべてのカードに固有のキーを与えます。symbols = ['owl', 'fox', 'cat', 'bee'] のとき、この一行で八枚のカードができます: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のたびに加算すると、ずれていきます。一方、タイムスタンプなら正しいままです。

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="カード5、裏向き"、めくれたら "カード5、フクロウ" にします。
  • そろったカードは disabled 属性で無効にし、タブ順から外します。
  • 「ペアが見つかりました」や「一致しません」を <p aria-live="polite"> のようなライブリージョンで読み上げます。
  • 色に頼らないでください。形の違う絵柄を使い、そろったものは縁取りやチェックマークで示します。

一週末でできることと、数週間かかること

上で述べたすべては、テストを含めても一週末に収まります。プレイヤーやクライアントに渡せるゲームには数週間かかります。大半の作業は、ループの周りにあるからです:

  • レベルと難易度の上がり方。プレイテストで調整します。
  • カードの表、カードの裏、背景、インターフェースで統一された絵。高密度の画面でもくっきり見えること。
  • アニメーションとフィードバック:ペアのエフェクト、コンボ、勝ちと負けの画面。
  • 記録が欠けていたり壊れていたりしても対応できる保存。
  • 言語。長い単語でもレイアウトが収まること。
  • タッチの対象、縦と横、小さな画面。
  • ゲームが覚えている音楽と効果音のスイッチ。
  • サポートするすべてのブラウザと端末でのテスト。
Fireflipのレベル5:木の橋の上の十二枚のランタンカード。盤の上に +250 のスコアがポップアップし、ホタルのFlickが Lucky! と応援している。
Fireflip、Firefly Village:そろったペアが光り、横にはPeekとBeaconの能力があります。

買えるメモリーゲームのソースコード:Polarの四つのテンプレート

私たちは、同じ構成で異なるテーマの、完成した四つのメモリーゲームをHTML5テンプレートとして販売しています。執筆時点で、どれもバージョン1.0.0で、定価は49米ドルです。

  • Memory Mansion:居心地のいいハロウィンのお化け屋敷。決して怖くありません。小さなゴーストのWisp、PeekとCandleの能力、集める60のSpookies。
  • Jinglewood Memory:プレゼントタグのカードがあるクリスマスの村。トナカイのTinsel、PeekとNorth Starの能力、60のSnowpals。
  • Safari Memory:木製のサファリのカードと子どもの動物たち。ミーアキャットのKiko、PeekとCompassの能力、60のSafari Pals。
  • Fireflip:おとぎ話の村のランタンカード。ホタルのFlick、PeekとBeaconの能力、60のGlimmers。
Memory Mansionのレベル8:お化け屋敷のホールの20枚のカードの盤。そろったペアは表向き、左にゴーストのWisp、右にPeekとCandleのボタン。
Memory Mansion、Moonlit Manor:そろったペアは開いたままで光ります。横にはPeekとCandleの能力があります。

四つすべてに含まれるもの

  • 5つのワールドに60レベル。それぞれ独自のレベルマップと新しいルールがあります。吹き出しで示される要求、隣のペアがそろうまで保持されるカード、二枚を入れ替える突風、自分の影と組み合わせるキャラクター。
  • レベルごとに手数の上限と、最大三つの星。9つ星ごとに報酬のチェスト、+5手の救済、Collectionアルバム、カレンダーと連続記録のあるDailyボード。
  • 二つの能力:Peekは全部のカードを一瞬表示し、二つ目の能力はカードの相手がどこにあるかを示します。
  • 14のインターフェース言語。スマホ、タブレット、パソコンで、縦でも横でも。
  • HTML5、Canvas 2D、Web Audioを、読みやすい素のJavaScriptのモジュールと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ゲームを買う方法

変更や複数のライセンスが必要?見積もりを依頼