Session Mode Guide

How to create, join, and use sessions for score recording from start to finish.

Session mode is used to record and manage scores for in-person hanafuda matches. The host creates a session, and participants join using a join code or QR code.

Creating a Session

1

Select a Rule

On the "Session" page, choose which rules to use. In addition to the 4 official rules (Koi-Koi, Hanawase, Inobota-Chūshin, Hachihachi), you can also select custom rules you've created or bookmarked.

2

Link a Circle (Optional)

Linking a session to a circle means the results will appear in the circle's history and rankings.

3

Add Players (Optional)

Pre-add friends, circle members, or guests (by name). Players can also be added after the session starts.

4

Create Session

Press the create button to generate a join code and QR code. Share the join code with other participants.

No Login Required

You can create a session without logging in. If you're not logged in, a host name field will appear and an anonymous account will be automatically created in the background.

Existing Active Session

If you already have an active session, you'll be shown options to "Resume", "Abandon", or "Leave" it.

Joining a Session

How to Join

・Enter Join Code

Enter the join code shared by the host in the join section on the "Session" page.

・Scan QR Code

Scanning the QR code opens the page with the join code pre-filled.

Logged-in users join directly. If not logged in, enter a display name to join as a guest (an anonymous account is auto-created).


Session Screen

During an active session, three tabs are available:

Score InputRound-by-round score entry form (host only)
Score TableTable of all recorded rounds (host can edit)
ParticipantsPlayer list, scores, and guest claim options

Host Privileges

Only the host (session creator) can record/edit scores, end the session, and add players mid-session. Other participants can only view scores.

Score Input

Each rule has a dedicated input form. Scores are recorded round by round (month by month).

Koi-Koi

Select active players → select winner → check completed yaku → enter koi-koi count. The multiplier is automatically calculated based on the koi-koi count.

Hanawase

Select active players → check special yaku (Fuke, Ameshima-Nagashi, Oyanaka-Hacchou) → select each player's completed yaku → enter captured card points (direct input or category-based input).

Hachihachi

Multi-step wizard: retire selection → mizuten → oikomichin → field status (koba/oba/zetsuba) → hand yaku input → outcome determination. The most complex form, but following the steps results in automatic calculation.

Inobota-Chūshin

Enter honba (round count) → select yaku (Fuke, Akatan, Aotan, Shiko — each with different multipliers) → select winner → select active players.

Custom Rules

A generic multi-step input form is used. The input fields automatically adjust based on the custom rule's settings (available yaku, feature toggles).

Real-Time Sync

Session data syncs in real-time for all participants. When the host records a score, it instantly appears on everyone else's screen. Track progress via the cumulative score dashboard and score chart.


Ending a Session

End Screen

When the host presses "End Session", the session concludes. The end screen shows:

・Winner Display — The highest-scoring player shown with a 👑 crown

・Cumulative Score Chart — A graph showing score progression across all rounds

・Score Table — Complete table of all round scores

・Session ID — Used by guest participants to transfer their records later

・Circle Linking — Link (or unlink) the session to a circle after finishing

HP Rating

For sessions using an official rule (Koi-Koi, Hanawase, Inobota-Chūshin, or Hachihachi), HP (Houwow Point) rating changes are calculated for each participant when the session ends. At least 20% of 12 rounds (3 or more rounds) must be played for rating changes to apply.

Transferring Guest Records

If you participated as a guest, you can later create an account and enter the session ID in the "Match History" tab on the dashboard to transfer your guest records to your account.