mcpField
R
record-promo

record-promo

github.com/playableintelligenceマーケティング・グロース350847 回インストール22 週間前に更新
リポジトリ

record-promo について

record-promoは、Phaserゲームのプレイ映像を自動録画し、プロモーション動画に変換するスキルです。環境確認、ゲームに合わせた録画スクリプトの作成、プレビュー確認を案内します。

主な機能

  1. 01開発サーバーと録画依存関係の確認
  2. 02ゲーム専用Playwright録画スクリプトの生成
  3. 03失敗処理の無効化とゲーム操作のシミュレーション
  4. 04FFmpegによる録画のMP4変換
  5. 05サムネイルの作成とプレビュー

活用シーン

  1. 01SNS投稿用のゲーム映像を録画する
  2. 02手動操作なしでゲーム映像を繰り返し収録する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/playableintelligence/game-creator --skill record-promo

インストール後、Claude Code で/record-promoを入力して読み込まれたか確認します。

詳細

プロモーション動画を録画する

Phaser ゲームの滑らかな高 FPS ゲームプレイ映像を自動で撮影します。TikTok、Reels、Moltbook、X にすぐ投稿できます。録画中に人が操作する必要はありません。

手順

$ARGUMENTS に指定したゲームのプロモーション動画を録画します（パスが指定されていない場合は、現在のディレクトリを使用します）。

1. 事前確認

次の項目が利用可能であることを確認します。

  • 開発サーバー：すでに実行中か確認します（curl -s http://localhost:3000/）。実行中でない場合は、バックグラウンドで npm run dev を起動します。ポート番号を記録してください。
  • Playwright：npx playwright --version。インストールされていない場合：npm install -D @playwright/test && npx playwright install chromium
  • FFmpeg：ffmpeg -version | head -1。見つからない場合は、ユーザーにインストールするよう伝え（macOS の場合は brew install ffmpeg）、終了します。
2. キャプチャスクリプトを生成する

手法の詳細を参照するため、promo-video スキルを読み込みます。

ゲームのソースファイルを読み、次の内容を把握します。

  • src/scenes/GameScene.js — 無効化する死亡／失敗メソッドを確認します
  • src/core/EventBus.js — イベントの流れを確認します
  • src/core/Constants.js — 入力キーとゲームの寸法を確認します
  • src/main.js — __GAME__ と __GAME_STATE__ グローバルが公開されていることを確認します

このゲームに合わせて scripts/capture-promo.mjs を作成します。

  • すべての死亡／失敗コードパスを無効化します
  • ゲームの実際の操作方法に合わせた入力シーケンスを生成します
  • イントロアニメーションのための一時停止（1～2 秒）を含めます
  • デフォルトのビューポート：1080 × 1920（9:16 のモバイル縦向き）
  • デフォルトの長さ：ゲーム時間で 13 秒
3. 変換スクリプトをコピーする
cp <plugin-root>/skills/promo-video/scripts/convert-highfps.sh <project-dir>/scripts/
chmod +x <project-dir>/scripts/convert-highfps.sh
4. キャプチャを実行する
mkdir -p output
node scripts/capture-promo.mjs --port <port>
bash scripts/convert-highfps.sh output/promo-raw.webm output/promo.mp4 0.5
5. 確認してプレビューする

5 秒時点のサムネイルを抽出し、ユーザーに表示します。

ffmpeg -y -ss 5 -i output/promo.mp4 -frames:v 1 -update 1 output/promo-thumbnail.jpg

サムネイル画像を読み込み、表示します。長さ、フレームレート、ファイルサイズを報告します。

使用例

/record-promo examples/flappy-bird

結果：死亡を無効化 → ゲームの操作方法に合わせた入力シーケンスを生成 → 1080x1920（9:16）で 13 秒間の自動ゲームプレイをキャプチャ → 50 FPS の MP4 に変換 → TikTok／Reels にすぐ投稿できる output/promo.mp4 が完成します。

ユーザーには次のように伝えます。

プロモーション動画を録画しました！50 FPS、モバイル縦向き（1080×1920）です。

ファイル：output/promo.mp4

ゲームへのアクセスを増やすため、TikTok、Reels、X に投稿してください。

コメント

Markdown 対応