友達とこいこいをオンライン対戦

部屋を作る

ログインすると、トップページがロビーになります。「部屋を作る」の欄では、次の項目を選べます。2つの部屋の設定は、前回選んだものがこの端末に保存されます。

「部屋を作成」を押すと、「ABC234」のような6文字の部屋コードが決まり、相手を待つ画面になります。部屋は1人1つまでで、新しく作ると前の部屋は閉じられます。部屋を開いたままロビーに戻ると「作成した部屋ABC234がまだ開いています」と表示され、「部屋に戻る」か「部屋を閉じる」を選べます。その部屋で対戦中のときは「作成した部屋ABC234で対戦中です」と表示され、代わりに「対戦に戻る」か「投了して閉じる」を選べます。新しい部屋を作れるのは、その対戦が終わってからです。離れている間に終わった対戦は「部屋ABC234の対戦は、あなたが離れている間に終わりました」と表示され、「結果を見る」を押すと、その対戦を開いて端末が結果を確認します。部屋での前回の対戦相手が、対戦が終わったときに離れていて、まだ結果を確認していない場合は、ロビーや待機画面から部屋を閉じる前と、新しい部屋を作る前に確認が表示されます。対戦がどう終わったかは、その相手のために部屋に残っているためです。

招待リンクを送る

待機画面には部屋コードが大きく表示され、その下にhttps://hanafuda.lemme.dev/#join=ABC234の形の招待リンクがあります。「招待リンクをコピー」でクリップボードにコピーでき、共有に対応したスマホやタブレットでは「共有」から共有メニューを開けます。部屋コードを押すと、コードだけをコピーできます。

部屋コードを口頭で伝えてもかまいません。友達はロビーの「コードで参加」に入力します。部屋コードは英大文字と2〜9の数字でできていて、見間違えやすいI・O・0・1は使いません。小文字や全角で入力しても、スペースが入っても、招待リンクをそのまま貼り付けても受け付けます。

友達が参加する

リンクを開くとトップページが表示され、ボタンの上に「部屋 ABC234 に参加するには、ログインしてください」と出ます。ログインすると参加ページに移り、ホストの名前、回戦数、パスワードの有無、2つの部屋の設定が表示されるので、友達は条件を確かめてから参加できます。パスワードを入力して「参加を申請」を押せば完了です。

申請はあなたの端末が自動で承認するので、ホストは何もしなくてかまいません。例外は、以前あなたとの対戦を途中で抜けたプレイヤーで、そのときだけ「入室させる」か「12時間入室禁止」かを選ぶよう求められます（対戦のあと）。部屋に入れるのは2人だけなので、友達が入ったあとはほかの人は参加できません。

対戦開始

両方の画面に「安全な接続を確立しています」と表示され、2人の端末だけが持つ鍵を取り決めます。続いて、どちらの端末も結果を操作できないコイントスで最初の親（おや）を決め、2人の端末が協力して札を切り、裏向きのまま配ります（全7段階）。あとはコンピュータとの対戦と同じです。ルールも卓の画面も同じで、部屋の設定も2人に共通です。

札の切り方と配り方

各回の始めに、2人の端末が順番に札を切り、それぞれ自分だけの秘密の鍵で全部の札に鍵をかけます。「メンタルポーカー」と呼ばれる方法です。札を読めるのは、その札の2人分の鍵がそろったときだけです。自分の手札の鍵は自分の端末に届くので、手札を見られるのは自分だけで、出した札はそのとき初めて相手にも開かれます。どちらのプレイヤーも配り方を操作できず、サーバーは鍵を一つも持っていません。

札を切ったり鍵をかけたりする手順には、一つ一つゼロ知識証明が付いています。新しい札の順番も鍵も明かさずに、その手順が正しく行われたこと（同じ札を並べ替えて鍵をかけ直しただけであること）を示す証明です。相手の端末はこの証明を確かめてから手順を受け付けるので、細工された山札はその場で拒否され、そこから札を知られることはありません。細工をした側も特定されます。回が終わると、両方の端末が鍵を公開し、お互いの手順をもう一度検証します。回の途中で対戦が終わった場合も、勝った側の端末がその回の鍵を公開し、相手の端末はそれを検証してから結果を確認します。

一手ごとの確認

手は自分の端末で暗号化し、この対戦のためだけに作った鍵で署名して、ひとつ前の手とつなげてから送ります。友達の端末は同じルールエンジンでその手を再現し、ルールどおりなら署名し返します。手が確定するのはそのときです。一度相手の端末に送った手は取り消せません。拒否された手はそのまま送り直され、同じ手が2度拒否されたときや、不正がはっきりしたときは、対戦は「異議あり」で止まり、どちらにも記録されません。どの手にも2人の署名が付くので、あとから打った手を否定したり書き換えたりすることもできません。

技術的には、鍵の取り決めに耐量子の鍵交換X-Wing（ML-KEM-768とX25519の組み合わせ）、手の暗号化にXChaCha20-Poly1305、署名にEd25519を使い、パスワード付きの部屋ではscryptで強化したパスワードも鍵に組み込みます。手への応答、接続情報、対戦の終わりとその結果など、2人の端末がやり取りするほかのものも、同じように暗号化して署名します。途中で第三者が割り込んでいないことを確かめたいときは、卓の鍵のアイコンを押し、5つの絵文字でできたセキュリティコードを、別の手段で友達と見比べてください。両方の画面で同じなら問題ありません。

サーバーに見えるもの

直接接続。どの対戦でも2人のブラウザが直接つながり（WebRTC）、同じ暗号化・署名済みの手がサーバーを通らずにやり取りされます。そのため、お互いのIPアドレスが相手に見えます。自分のIPアドレスを隠すには、「設定」で「自分のIPアドレスを隠す」をオンにします。オンにすると、あなたの側は中継サーバーだけを経由してつながり、中継サーバーがない場合はゲームのサーバー経由になります。直接の接続ができるまでの間と、接続が切れている間は、暗号化・署名されたままサーバー経由で届き、直接の接続は自動でつなぎ直されます。手がどの経路で届いているかは、卓の鍵のアイコンの横にある稲妻のアイコンでわかります。

このしくみにもできないことがあります。相手に手を打たせること（そのために手番の時計があります）と、相手に結果を確認させることです。ランキングには、両方のプレイヤーの端末が同じ結果を確認した対戦だけが反映され、2人がそろって確認しなかった対戦は、どちらにも記録されません。

接続が切れたとき・再読み込み

相手の接続が切れると、戻るまでの残り時間が「Hanaの接続が切れました・戻るまであと2:41」のように表示されます。猶予は3分間で、サーバーの時計で計ります。時間内に戻れば、対戦はそのまま続きます。過ぎたあとは、残った側が「勝ちを申告」を押すか、もう少し待つかを選べます。自動で勝ちになることはありません。勝ちが記録されるのは、戻ってきた相手の端末が申告を確認したときなので、相手が戻らなければ、どちらにも記録されません。

ページを再読み込みしても、タブやアプリを閉じても、端末を再起動しても大丈夫です。対戦の鍵は暗号化して最長7日間この端末に保存され、同じブラウザで次にゲームを開くと部屋に戻り、続きから遊べます。ただし鍵はほかの場所には保存されないので、あるブラウザで始めた対戦を別のブラウザや別の端末で続けることはできません（iPhoneやiPadでは、Safariとホーム画面のアプリも別扱いです）。そこでは投了しか選べず、投了するとどちらにも記録されません。同じ部屋を2つ目のタブで開くと「ここでプレイ」が表示され、押すと対戦がそのタブに移ります。ログアウトすると、保存した対戦はこの端末から消えます。

対戦のあと

対戦が終わると、2人とも結果が表示されます。ホストが「部屋を開けておく」を押すと、同じ部屋コードのまま相手を待つ画面に戻るので、友達がもう一度招待リンクを開けば次の対戦を始められます。「部屋を閉じる」を押すと部屋はなくなります。ただし、対戦が終わったときに友達が離れていて、まだ結果を確認していない場合は、ロビーから部屋を閉じるか別のプレイヤーを入室させるまで、対戦がどう終わったかを友達のために残したまま、部屋を対戦相手なしで開いておきます。途中でやめたいときは、ツールバーの「投了」（旗のアイコン）を押します。2人の端末が確認すると、友達の勝ちとして記録されます。対戦中に部屋を出たりログアウトしたりした場合も、確認のあとで投了になります。ログアウトすると保存した対戦も端末から消えます。その前に数秒だけ結果の確認を待ちますが、それまでに確認されなかった投了はどちらにも記録されません。

結果の下には、記録の状況が表示されます。「両者が結果を確認しました」、「Hanaの確認を待っています（確認されると記録されます）」、または理由とともに「記録されません」です。部屋を出たあとも、次にゲームを開いたときも、あなたの端末は最長7日間、この手続きを続けます。

途中で対戦を抜けた相手（切断して戻らなかった、投了した、離席して勝ちを申告された、異議を唱えて対戦を止めた、あなたの端末が確認しなかった勝ちを申告した）は、あなたのブラウザの中だけにある一覧に記録されます。その人があとであなたの部屋に参加を申請すると、何があったかが表示され、「入室させる」か「12時間入室禁止」かを選べます。