一覧に戻る

Trick or Take

友達と一緒にお菓子を盗む、60秒のハロウィンブラウザーゲーム。

Web / JavaScript中級zicojiao
Trick or Take Halloween characters stealing candy while Lily turns with a broom

実装ガイド

目次
Trick or Take

お菓子を取ろう。見つからないように。

ブラウザーで遊べる、小さなハロウィンのお菓子泥棒ゲーム。ひとりでも、友達とボイスチャットしながらでも。

今すぐ遊ぶ · デプロイガイド

English · 简体中文 · Español · Français · Deutsch · 日本語 · 한국어 · Português (Brasil)

Agora RTC License: MIT Node.js 22.13+ Cloudflare Workers

Trick or Take

ゲームについて

リリーはキッチンで大忙し。目の前にはお菓子がいっぱい。ひとつくらい、なくなっても気づかないよね?

長押しでお菓子を取り、離すと隠して知らんぷり。リリーが振り向いたときも取り続けていると、ほうきで叩かれてお菓子がすべてゼロになります。制限時間は60秒。どれだけ持ち帰れるでしょうか?

おばけ、かぼちゃ、コウモリ猫からキャラクターを選べます。ひとりで挑戦することも、6桁のルームコードを友達に送って対戦することもできます。ボイスチャットは任意です。

機能内容
ソロローカルの自己ベスト、一時停止、合成音によるBGM
マルチプレイ2〜6人、6桁のルームコード、準備確認、再戦
音声Agora RTCによるマイク通話、ミュート、再接続
ルーム更新Agora RTMの通知。利用できない場合は定期的な問い合わせで更新
共通のチャレンジランダムな間隔と明確な予告、全員に同じルール
ランキング共通のランキング。名前とスコアの公開はプレイヤーが選択
シェア検証済みの結果リンクとダウンロードできるスコアカード
モバイルタッチ操作、画面幅に応じたレイアウト、ホーム画面アイコン
ゲームの言語12言語の画面とメタデータ。OG画像は英語と簡体字中国語に対応

遊び方

  1. キャラクターを選びます。マルチプレイではルームを作成するか参加し、全員が準備できたら開始します。
  2. 大きなボタン、ゲーム画面、または スペースキー を押し続けるとお菓子を取れます。長く押すほど取る速度が上がります。
  3. リリーが振り向き始めたら離します。キャラクターはすぐに何もしていない表情に戻ります。
  4. 見つかると所持数はゼロになります。短い気絶時間のあと、また挑戦できます。
  5. 終了時は手に持っているお菓子も得点に含まれます。最も多い人が勝ち。同点は引き分けです。

1ラウンドは60秒。リリーは長短の間隔を織り交ぜ、振り向く前に0.55–1.90秒の予告を出します。難易度の選択はありません。

タイミングは毎回変わります。サーバーは警告が始まるまで次の振り向き時刻を公開しません。マルチプレイでは会話を妨げないようBGMを停止します。

ローカルで起動する

Node.js 22.13以降とnpmが必要です。ローカルのゲームとルーム機能は、CloudflareのアカウントやAgoraの認証情報なしで試せます。

bash
git clone https://github.com/zicojiao/trick-or-take.git
cd trick-or-take
npm ci
npm run db:migrate
npm run dev

http://localhost:5173 を開きます。別のタブから同じルームに参加し、両方のプレイヤーを準備完了にすれば、マルチプレイの流れを確認できます。実際の通話品質は2台の端末で確認してください。

wrangler.json のゼロで埋めたデータベースIDはローカル開発用の仮の値です。デプロイ前に自分のD1データベースIDへ置き換えます。

Agora RTCとRTMを有効にする

bash
cp .dev.vars.example .dev.vars

.dev.vars に AGORA_APP_ID と AGORA_APP_CERTIFICATE を設定し、開発サーバーを再起動します。AgoraプロジェクトでRTCとSignaling/RTMを有効にしてください。サーバーは認証済みのルーム参加者に有効期間の短いトークンを発行します。App Certificateはブラウザーに送信されません。

各プレイヤーは Join voice を選び、マイクへのアクセスを許可します。localhostまたはHTTPSが必要です。本番環境の設定は英語のデプロイガイドを参照してください。

任意のアクセス解析

解析は初期状態では無効です。自分の POSTHOG_PROJECT_TOKEN と POSTHOG_HOST を設定すると有効になります。/config.js は公開可能なイベント受信設定のみを返します。

PostHogはファーストパーティCookieとローカルストレージを使います。自動収集とセッション録画は無効です。イベントのURLからルームコード、チャレンジID、クエリパラメーターを取り除き、プレイヤー名は送信しません。運用に合わせてプライバシーページを見直してください。

仕組み

クライアントはJavaScriptとCanvas 2Dを使用します。Cloudflare Workerがページ、静的ファイル、API、OG画像を提供し、D1がルームと結果を保存します。音声はAgora RTC、ルーム更新の通知はRTMが担当します。

  • 共通ルール: public/party/engine.mjs をソロとサーバーの両方で使用します。
  • サーバーが管理する状態: バージョンを条件にした更新で同時操作の上書きを防ぎます。RTMの通知だけでゲーム状態は決まりません。
  • 結果の検証: ソロの入力履歴をサーバーで再現し、マルチプレイの得点はルーム状態から取得します。
  • 任意の公開: ゲーム終了だけでは名前や得点を公開しません。チャレンジリンクにも名前は含まれません。
  • ルールのバージョン管理: 難易度変更後も、対応する旧バージョンの記録を検証できます。

詳しくは英語のアーキテクチャ説明を参照してください。検証は不整合な得点を拒否しますが、自動操作を完全に防ぐものではありません。

ディレクトリ構成

text
public/party/    ゲーム、Canvas、操作、音声、翻訳、画像
public/          アイコン、マニフェスト、検索エンジン向けファイル
server/          ルーム、トークン、得点検証、OG画像
worker/          ルーティングと言語別HTML
drizzle/         D1マイグレーション
scripts/         アイコン生成と検証
tests/           自動テスト
docs/            英語のデプロイ・設計ドキュメント

ライセンス

MIT