4.4 落ちものブロックゲームを作る

# 落ちものブロックゲーム

# 目標
プレイヤーは、画面上部から落下するブロックを左右移動・回転させて積み上げ、横一列を隙間なく埋めて消去する。ブロックが画面上部まで積み上がらないようにしながら、できるだけ多くの列を消して高得点を目指す。

# プログラム・ファイル名
fallingBlocks.html

# プロジェクト・フォルダ作成
- プログラム・ファイル名の拡張子を除いた主ファイル名と同じ名前のサブフォルダ「fallingBlocks」を作成し、以降の作業はサブフォルダで行う。
- すでにサブフォルダがあれば、そのサブフォルダに移動して以降の作業を進める。
- ユーザーが作成した既存ファイルや変更内容を、許可なく削除または上書きしない。

# ゲーム・ルール
## 勝敗条件
- ゲームクリア：合計30列を消去する。
- ゲームオーバー：新しいブロックを盤面内に配置できないほど、ブロックが画面上部まで積み上がる。
- 制限時間内に30列を消去できなかった場合もゲームオーバーとする。

## 盤面
- 盤面は横10マス、縦20マスとする。
- 盤面の上部中央付近から、ブロックを1個ずつ出現させる。
- 盤面の外へブロックを移動できないようにする。
- 盤面の床または固定済みブロックを突き抜けないようにする。

## ブロック
4個の正方形を組み合わせた、次の7種類のブロックを使用する。

```text
I  ■■■■

O  ■■
   ■■

T  ■■■
    ■

S   ■■
   ■■

Z  ■■
    ■■

J  ■
   ■■■

L    ■
   ■■■
```

- ブロックごとに識別しやすい異なる色を割り当てる。
- 出現順は、7種類を1個ずつまとめてシャッフルする「7個バッグ方式」とする。
- 7個をすべて出現させたら、再び7種類をシャッフルする。
- 同じ種類だけが不自然に連続しないようにする。

## 基本的な挙動・メカニクス
- 自動落下：操作中のブロックは一定時間ごとに1マス落下する。
- 左右移動：操作中のブロックを左右に1マスずつ移動できる。
- 回転：操作中のブロックを時計回りに90度回転できる。
- ソフトドロップ：下方向の操作中は通常より速く落下する。
- ハードドロップ：操作中のブロックを、着地可能な最下部まで即座に落下させる。
- 固定：ブロックが床または固定済みブロックの上に着地すると、その位置に固定する。
- 固定猶予：着地してから固定されるまで約0.5秒の猶予を設ける。
- 固定猶予中に左右移動または回転が成立した場合は、固定までの時間を再計算する。
- ライン消去：横一列の10マスがすべて埋まった場合、その列を消去する。
- 落下処理：列を消去した後、その列より上にあるブロックを消去した列数だけ下へ移動する。
- 複数ライン：一度に複数の列が完成した場合は、同時に消去する。
- 次ブロック：次に出現するブロックを画面に表示する。
- 最小構成とするため、ブロックのホールド機能、対戦機能、特殊ブロック、アイテムは実装しない。

## 回転時の処理
- 回転後にブロックが壁、床、または固定済みブロックと重なる場合、そのままでは回転させない。
- 回転できない場合は、左右に最大1マスずらして回転できるか確認する。
- 左右にずらしても配置できない場合は、回転前の状態へ戻す。
- O型ブロックは回転しても形状を変化させない。

## 得点
- 1列消去：100点 × 現在レベル
- 2列同時消去：300点 × 現在レベル
- 3列同時消去：500点 × 現在レベル
- 4列同時消去：800点 × 現在レベル
- ソフトドロップ：手動で1マス落下するごとに1点
- ハードドロップ：落下した距離1マスにつき2点
- 得点、消去した列数、現在レベルを常に画面へ表示する。

## レベルと落下速度
- ゲーム開始時はレベル1とする。
- 10列消去するごとにレベルを1つ上げる。
- レベル1では、約1秒ごとに1マス自動落下させる。
- レベルが上がるごとに、自動落下の間隔を短くする。
- レベルが上がっても、操作不能になるほど落下間隔を短くしない。
- レベルと落下間隔の関係を、プログラム内の定数として分かりやすく管理する。

# 制限時間
- 制限時間は3分（180秒）とする。
- 画面右下に残り時間を「分:秒」で表示する。
- 残り15秒以下では時間表示を赤色にする。
- 制限時間内に合計30列を消去するとゲームクリアとする。
- 制限時間内にクリアできなければゲームオーバーとする。
- 一時停止中は残り時間を減らさない。

# 操作方法
## キーボード
- Aキーまたは左矢印キー：ブロックを左へ1マス移動
- Dキーまたは右矢印キー：ブロックを右へ1マス移動
- Sキーまたは下矢印キー：ソフトドロップ
- Wキー、上矢印キー、またはXキー：時計回りに90度回転
- Spaceキー：ハードドロップ
- PキーまたはEscキー：一時停止／再開

## 画面タッチ
- 盤面を左へスワイプ：ブロックを左へ移動
- 盤面を右へスワイプ：ブロックを右へ移動
- 盤面を下へ短くスワイプ：ソフトドロップ
- 盤面を下へ大きく素早くスワイプ：ハードドロップ
- 盤面をタップ：ブロックを時計回りに90度回転
- スマートフォン用に「左」「右」「回転」「下」「即落下」の画面ボタンも表示する。
- スワイプと画面ボタンのどちらでも操作できるようにする。
- タッチ操作中にブラウザ画面が意図せずスクロールしないようにする。

# 画面構成要素
## ゲーム盤
- 画面中央に横10マス、縦20マスのゲーム盤を表示する。
- 各マスの境界が分かるように薄いグリッド線を表示する。
- 固定済みブロックと操作中のブロックを表示する。
- 盤面の縦横比を保ち、画面サイズに合わせて縮小する。

## 操作中ブロック
- 現在プレイヤーが操作しているブロック。
- 左右移動、回転、ソフトドロップ、ハードドロップができる。

## 固定済みブロック
- 着地して盤面に固定されたブロック。
- 横一列がすべて埋まると、その列を消去する。

## 次ブロック
- 次に出現するブロックを盤面の横に表示する。
- スマートフォンの狭い画面では、盤面の上部または下部に表示する。

## ステータス表示
- 現在の得点
- 現在のレベル
- 消去した列数
- クリアに必要な残り列数
- 残り時間

## 操作ボタン
- スマートフォン向けに、十分な大きさのタッチ操作ボタンを配置する。
- ボタンを押したときに、視覚的な反応を表示する。
- ボタンがゲーム盤やステータス表示と重ならないようにする。

# 画面構成
- 画面中央：落ちものブロックゲームの盤面
- 盤面周辺：次ブロック、得点、レベル、消去列数
- 画面右下：残り時間
- 画面上部：タイトル、バージョン、著作権者、ライセンス
- 画面下部：キーボードとタッチの操作方法
- スマートフォンの狭い画面でも操作できるレスポンシブ構成にする。
- ゲーム開始前に、ゲームの目的と主な操作方法を表示する。
- ゲーム開始前に「ゲーム開始」ボタンを表示する。
- ゲーム中に「一時停止」ボタンを表示する。
- ゲームクリア画面およびゲームオーバー画面には、今回の得点、消去列数、到達レベル、プレイ時間を表示する。
- ゲームクリア画面およびゲームオーバー画面には、それまでの成績を直近30回分表示する。
- 成績には、年月日時分、ゲームクリアまたはゲームオーバー、得点、消去列数、到達レベル、プレイ時間を含める。
- 成績が1画面に表示しきれない場合は、自動縦スクロールできるようにする。
- 結果画面の上段には「もう一度遊ぶ」「終了する」ボタンを常に表示する。
- 「終了する」ボタンを押した場合は、安全にゲームを停止して開始画面へ戻る。
- ブラウザのウィンドウやタブをプログラムから強制的に閉じない。

# データの記録
- ゲームの成績はブラウザのlocalStorageに保存する。
- 保存する成績は直近30回分とする。
- 31回目以降は、最も古い記録から削除する。
- localStorageを利用できない場合でもゲーム本体は続行できるようにする。
- localStorageを利用できない理由を画面へ表示する。
- 外部サーバーへ成績を送信しない。
- 個人情報を記録しない。

# エラー処理
- JavaScript実行中にシステムエラーが発生した場合は、ゲームのタイマーとアニメーションを停止し、処理を安全に終了する。
- エラー内容を、プレイヤーが確認できる形で画面に表示する。
- エラーが発生しても、ブラウザ全体が操作不能にならないようにする。
- 無効な入力やゲーム状態に合わない入力は受け付けない。
- 入力を受け付けなかった場合は、必要に応じて理由をメッセージで表示する。
- ゲーム開始前、ゲーム終了後、一時停止中は、ブロック操作を受け付けない。
- 同じゲームループやタイマーが重複して実行されないようにする。
- localStorageの読み書きで例外が発生した場合は、安全に処理を継続する。

# テスト観点・合格条件
- HTMLファイルをブラウザで直接開き、サーバーなしで動作すること。
- 横10マス、縦20マスの盤面が正しく表示されること。
- 7種類のブロックがすべて出現し、7個バッグ方式が正しく動作すること。
- ブロックを左右へ移動し、時計回りに回転できること。
- 壁、床、固定済みブロックを突き抜けないこと。
- ソフトドロップとハードドロップが正しく動作すること。
- 着地したブロックが固定されること。
- 横一列が埋まると、その列が消去されること。
- 1列から4列までの同時消去で、得点がルールどおり加算されること。
- 10列消去するごとにレベルが上がり、落下速度が速くなること。
- 合計30列を消去するとゲームクリアになること。
- 新しいブロックを配置できない場合にゲームオーバーになること。
- 制限時間が0になるとゲームオーバーになること。
- 残り15秒以下で時間表示が赤色になること。
- 一時停止中にブロックと制限時間が進まないこと。
- 「もう一度遊ぶ」で盤面、得点、レベル、消去列数、時間が初期化されること。
- 成績がlocalStorageへ保存され、直近30回分だけ表示されること。
- キーボード操作とタッチ操作の両方が動作すること。
- PCとスマートフォン相当の画面幅で、表示や操作部分が重ならないこと。
- JavaScriptの構文エラーや未処理の例外がないこと。
- インターネット通信が発生しないこと。
- Codexが可能な範囲でテスト用の内部状態またはデバッグ機能を利用し、ゲームクリアとゲームオーバーを含む合計5回のプレイテストを行うこと。
- テストのために追加したデバッグ機能は、配布版では無効化または削除すること。
- 前提条件および制約条件が守られていること。
- テスト結果を、実施内容、期待結果、実際の結果、合否が分かる形式でユーザーに報告すること。
- 実際に確認できなかった項目を「合格」と推測して報告しないこと。

# 前提条件
- タイトルは「落ちものブロックゲーム」とする。
- バージョン番号、著作権者、MIT Licenseであることを画面に表示する。
- 仕様で分からないことがあり、その違いが実装結果へ大きく影響する場合は、ユーザーに質問すること。
- 安全かつ合理的に判断できる軽微な事項は、判断内容を明記して作業を進めること。
- HTML、CSS、JavaScriptを1つのHTMLファイルに記述すること。
- JavaScriptを使った1本のプログラム・ファイルにすること。
- クライアントPCのブラウザで動作すること。OSやブラウザの種類は問わない。
- スマートフォンでも利用できること。
- HTTPサーバーやNode.jsなどのサーバー技術は使用せず、ブラウザの機能だけで完結すること。
- Canvas APIまたはHTML要素を利用してゲーム画面を描画すること。
- コーディングは「Airbnb JavaScript Style Guide」に可能な限り準拠すること。
- 実装上、ブラウザ環境や単一HTMLファイルという条件と競合する規則がある場合は、その理由をコメントまたはREADME.txtに記載すること。
- プログラムファイルにコメントとして、プログラムの名称、バージョン、目的、動作環境、著作権表示および使用条件、インストール方法、お問い合わせを記載すること。
- ゲーム名、画面デザイン、説明文は独自のものとし、第三者の商標、画像、音声、プログラムコードを無断で使用しないこと。
- 外部の画像、フォント、音声などの素材を使用せず、必要な表示はHTML、CSS、JavaScriptで作成すること。

# 制約条件
- インターネットとのデータ送受信は行わないこと。
- CDNを含む外部ライブラリは使用せず、標準のHTML、CSS、JavaScriptだけで実装すること。
- 外部画像、外部フォント、外部音声、アクセス解析、広告、Cookieを使用しないこと。
- プログラムがMIT Licenseおよび第三者の権利に違反していないこと。
- ユーザーの許可なく、プロジェクトフォルダ外のファイルを変更しないこと。
- ユーザーの許可なく既存ファイルを削除しないこと。
- Gitの履歴を破壊する操作を行わないこと。

# 合格判定
- すべての実装とテストが完了したら、テスト結果を一覧で表示する。
- 合格項目、不合格項目、未確認項目を明確に区別する。
- 不合格項目がある場合は、原因と修正方針を表示する。
- 未確認項目がある場合は、未確認の理由とユーザーによる確認方法を表示する。
- テスト結果を表示した後、合格としてよいかユーザーに質問する。
- ユーザーが合格と回答するまでは、Gitへの最終コミットと配布用ZIPファイルの作成を行わない。
- ユーザーが不合格と回答した場合は、指摘内容を修正して再テストする。

# 簡易取扱説明書の作成
1）HTMLファイルと同じ場所に、簡易取扱説明書「README.txt」を作成する。
2）説明書には、各項目を「# 項目名」と表記して次を含める。
- プログラムの名称
- バージョン
- 目的
- ゲーム・ルール
- 動作環境
- 著作権表示および使用条件
- インストール方法
- 使い方
- 操作方法
- 成績の保存
- 既知の制限
- 変更履歴
- お問い合わせ
3）インストール方法には、ZIPファイルを展開し、fallingBlocks.htmlをブラウザで直接開く手順を記載する。
4）使い方には、ゲーム開始、一時停止、再開、再プレイ、終了の手順を記載する。
5）キーボード操作と画面タッチ操作を両方記載する。

# 著作権表示および使用条件
このプログラムは OpenAI社の Codex によって作成し、作者が動作を確認しました。 このプログラムは外部とのデータ通信を行いません。

本アプリケーションはMIT Licenseです。 商用を含む無償利用が可能です。自由に改造できます。 再配布の際は、下記の著作権表記、URLおよび本使用条件を必ず明記してください。

Copyright by (c)studio pahoo https://www.pahoo.org/

MITライセンスについては、下記のリンク先を参考にしてください。 http://ja.wikipedia.org/wiki/MIT_License http://www.opensource.org/licenses/mit-license.php

なお、本アプリケーションの利用または改造によって生じた得失については一切関知いたしません。また、二次利用先の組織・企業・団体の目的・内容・活動については一切関知いたしません。

# お問い合わせ
ぱふぅ家のホームページ https://www.pahoo.org/

- サイト案内
  - お問い合わせ

# プロジェクト・プロンプトの保存
- このプロンプトを、プロジェクトフォルダ内の「PROMPT.md」に保存する。
- 実装中にユーザーと合意して仕様を変更した場合は、PROMPT.mdにも変更内容を反映する。
- PROMPT.mdに記載されたバージョン番号と、プログラムおよびREADME.txtのバージョン番号を一致させる。

# リソース管理
1）作業開始前に、今回の作業が次のどれに該当するかユーザーに質問する。
- 新規作成（評価用）
- 新規作成（配布用）
- メジャーバージョンアップ
- マイナーバージョンアップ
- 不具合修正
2）回答に従い、バージョン番号を次のルールで決定する。
- 新規作成（評価用）：バージョン0.1.0
- 新規作成（配布用）：バージョン1.0.0
- メジャーバージョンアップ：現在のバージョン番号の整数部分を1増やし、小数部分を0にする。
- マイナーバージョンアップ：現在のバージョン番号の小数第1位を1増やし、それより下の桁を0にする。
- 不具合修正：現在のバージョン番号の小数第2位を1増やす。
3）バージョンアップの場合は、既存のバージョン番号をプログラムファイル、README.txt、PROMPT.mdまたはGit履歴から確認する。
4）既存のバージョン番号を確認できない場合は、推測せずユーザーに質問する。
5）決定したバージョン番号を、fallingBlocks.html、README.txt、PROMPT.md、ゲーム画面、配布用ZIPファイル名のすべてに反映する。
6）ユーザーがテスト結果を合格と判定した後、fallingBlocks.html、README.txt、PROMPT.mdをGitへコミットする。
7）Gitリポジトリが存在しない場合やコミットできない場合は、勝手に新規リポジトリを作成せず、理由をユーザーに報告して指示を求める。
8）コミットメッセージには、プログラム名、バージョン番号、変更区分が分かる内容を使用する。

# 配布ファイルの作成
1）ユーザーがテスト結果を合格と判定した後、次の3ファイルを1つのZIPファイルに圧縮する。
- fallingBlocks.html
- README.txt
- PROMPT.md
2）ZIPファイル名は「fallingBlocks_バージョン番号.zip」とする。
例：
```text
fallingBlocks_0.1.0.zip
fallingBlocks_1.0.0.zip
```
3）ZIPファイル内に一時ファイル、テスト用ファイル、Git管理ファイル、デバッグ専用ファイルを含めない。
4）ZIPファイルを作成した後、内容物とファイル名が正しいことを確認する。
5）完了後、作成したZIPファイルの絶対パスをユーザーに伝える。