Tetris-Beginner-Assistance

GitHub – fiss-vinbows/Tetris-Beginner-Assistance: テトリス初心者用学習ツールの作成
テトリス初心者用学習ツールの作成. Contribute to fiss-vinbows/Tetris-Beginner-Assistance development by creating an account on GitHub.
テトリス開幕テンプレ練習シミュレーター
ブラウザで無料で遊べるテトリスシミュレーター。初心者向けの操作アシスト機能付きです。落下予測やホールド機能などをサポートし、テトリス初心者でも直感的に操作を学べます。通常モードと中あけRENモードを搭載しています。

経緯

テトリスが下手でいろんな動画を見ても一向にうまくならないし、ドネイトが全く作れない。
盤面が汚くて遅い。これでは楽しくない。
人から教わるのもいいがそんな伝手は無いし、時間やお金の問題もある。
よってAIに教師役となってもらうこととした。

構想

初心者のためのテトリスの最善手を提示するソフト。
ネクスト・ホールド・現状の 地形を鑑みた最善手をドットで表示し、人間が操作する。
Nintendo Switchなどのゲーム機からキャプチャボードでPC上表示されたテトリスの画面を認識し、最善手を提示する。思考AIはCold Clear 2を用いた。
プログラム記述はClaude Code(Opus)、問題定義と添削をCodex(Astra)が担った。
製作期間は2週間ほど

機能

開幕テンプレートとして迷走砲・はちみつ砲・山岳積み2号・オリーブ積みを採用している。
DT砲は七種一巡の思想に反したテンプレートだと感じているので搭載していない。

操作方法さえ理解していれば誰でもTDアタックができる

現状

20260913公開時はプロトタイプであり製作者の環境だけでなんとか動いている。
問題点としては
・既存のミノに干渉する(構造上置けない)
・イレギュラーが発生するとテンプレをやめようとする
・最善手ガイドをすでにおいているミノと誤認する
・最善手が一意に定まらない(振動)
・4列消しを軽視して3列消しを提示してしまう
・Tスピンドネイトを作ろうとしない
・2手目の方から置いたら最善手を変えてしまう
・20段目あたりの挙動がおかしくなる

今後搭載したいもの

・Cold Clear2以外のテトリスAIに切り替えられる機能
・テンプレ(中あけRENやDPCなど)の拡充


以下はAIが書いた説明文

Tetris-Beginner-Assistance(テトリス初心者補助ツール)は、キャプチャボードで取り込んだテトリスのゲーム画面をAIエンジン「Cold Clear 2」が解析し、次に置くべき最善手をドットで画面に表示するWindows用ツールです。開幕テンプレートを覚えられない初心者が、実際にプレイしながら手順を学べることを目的としています。

  • 公開日:2026年9月13日(プロトタイプ)
  • 対応OS:Windows11
  • 対応機種:Nintendo Switch(キャプチャボード経由)

Tetris-Beginner-Assistanceとは

テトリス初心者向けの「最善手ガイド」ツールです。ゲーム機の映像をキャプチャボードでPCに取り込み、画面を認識してCold Clear 2に盤面を渡し、返ってきた最善手をドットで重ねて表示します。

項目内容
対応OSWindows11
対応機種Nintendo Switch(キャプチャボード経由)
思考AICold Clear 2
開幕テンプレート迷走砲・はちみつ砲・山岳積み2号・オリーブ積み
開発ツールClaude Code(Opus)、Codex(Astra)
製作期間約2週間
状態プロトタイプ

なぜ作ったのか

作者自身がテトリス初心者で、Tスピン用のドネイト(穴を作る積み方)がなかなか組めませんでした。上級者に教わる代わりに「AIを教師役にする」という発想で開発を始めました。

できること

最善手のドット表示

Cold Clear 2が算出した最善手を、ミノを置くべき位置にドットで表示します。

開幕テンプレート4種

以下の4種類に対応しています。

  • 迷走砲
  • はちみつ砲
  • 山岳積み2号
  • オリーブ積み

動作の仕組み

  1. キャプチャボードでSwitchの映像をPCに取り込む
  2. ツールが画面から盤面とネクストを認識する
  3. 盤面をCold Clear 2に渡し、最善手を受け取る
  4. 最善手の位置にドットを描画する

既知の問題(プロトタイプ)

  • 既存のミノに干渉する(構造上置けない手を提示する)
  • イレギュラーが発生するとテンプレをやめようとする
  • 最善手ガイドを、すでに置いているミノと誤認する
  • 最善手が一意に定まらず、表示が振動する
  • 4列消しを軽視して3列消しを提示する
  • Tスピン用のドネイトを作ろうとしない
  • 2手目の方から置くと最善手を変えてしまう
  • 20段目あたりで挙動がおかしくなる