asterism-games 0.19.1 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d10ded9e6550829d2169bb7be24ba662f11d69cec3eaf0fe676923104aa44727
-  data.tar.gz: '039b615f91c53f50c6bb10500b4e9516c7893bd213af57d1f7823c2bc67e84f5'
+  metadata.gz: e2b83742bc350a97c81593529368c69fd2143887ac42293d62c9459c28c47b91
+  data.tar.gz: d608f964a2f5356ebe84485ed7042558f66c150e530b34aa787a113a431f64fb
 SHA512:
-  metadata.gz: c2571c2374914e2f9bb3d299e0482cd3f2f43b9c6ebe7fb4f5423b5c37c121cd5b06c06eb058ee91ecb5b05ddd0d6db22ce89e9b8b06eaf40cd3ab6ac6081f65
-  data.tar.gz: 260165d7df98b105ec8070f0c850d80f783b220cf4cf819c3a17de189c0ed7b0ccb78f43dc7ce29fe8f31f08aa4d4793c0eca1a2e600a265e52c61c67833852e
+  metadata.gz: d50462655686680b282f50e3e68ceccbc0f761c9b9515013877f4e06e8c6828233ff5795c14c9c008e7bb5fa5b663ff39aea08d2dc96741616fee5f5bc6ca7e6
+  data.tar.gz: fbb3bbeee07f77a11c01e7d685b8a7f0a239b0ef17f8f8782b0f8e4adbf466fade43708eb6b5e1daa1389c8de93abccf5f39e2afee5e2a20c338ab411ce14aaa

data/CHANGELOG.md

@@ -3,6 +3,72 @@
 Versions before 0.11.1 are noted in the README where each feature is
 described ("games 0.10.0" and the like).
 
+## 0.21.0
+
+- **The commentary's sound** (README "The sound"): the page of
+  `commentate mahjong` plays Family mruby's mahjong app's BGM and effects,
+  the same sounds at the same moments as the app. The BGM follows the
+  app's scenes (the lobby, the game, the tense part, none at the end),
+  starts low (the app's levels: off, low, mid, high, **B** or the bar's
+  button) and goes down to half while the voice speaks. The effects (a
+  round's start, the jingles of the calls, riichi and the wins, the
+  winner's points, the draws, a discard, the fanfare at the end; as for
+  the app's spectator, no draw or turn sound) play beside the voice, sharing the APU's channels as in the
+  app; **E** turns them off and on; the page remembers both. Which sound
+  when is a pure function of two views (`commentate/mahjong_sounds.rb`);
+  each `state` event now carries `bgm` and `sounds`.
+- The files are in the gem (`commentate/assets/sounds/`, 3.6 MB: WAVs for
+  the effects, MP3s for the three tunes, `sounds.json`), made with Family
+  mruby's own APU emulator by fmruby-core's `tools/mahjong_sounds.rb`.
+  The effects are MIT here; the BGM is shiru8bit's under CC BY 3.0,
+  unchanged (`SOUNDS_LICENSE.txt`), credited in the page's corner. The
+  web server serves `/sounds/` (those files only) and
+  `/SOUNDS_LICENSE.txt`.
+
+## 0.20.1
+
+- `play mahjong`: an owner's command queued with `--commands` (`watch`,
+  `start`, `cpu` ...) while someone else holds the owner's role now says
+  so (「卓の主ではありません。卓の主の役が回ってくるのを待っています」)
+  instead of asking for a seat: since 0.20.0 an owner may be unseated.
+
+## 0.20.0
+
+- **Watch games** (README "Watch games"): the owner of a mahjong table
+  may start a game of CPUs and AI players only, and watch it with the
+  others at the table (and a commentary, `commentate mahjong`). The owner
+  need not be seated: a member that joins a table where nobody is seated
+  and there is no owner is the owner (`join`'s `"owner"`, the new `"mo"`
+  of the member's own view); once somebody sits the first seated is the
+  owner as before, so a game with people seated goes as it did. The new
+  method `watch(token)` starts it when the four seats are CPUs or AI
+  players, nobody is seated and at most one seat is Claude's (Jev may take
+  all four; `"human"`, `"ai limit"`, `"seats"`, `"not owner"` otherwise).
+  The lobby view's `"wc"` says whether it may start (1), is over the AI
+  limit (2) or not (0); views during it have `"wm" => 1` and the host's
+  `@status` `"watch" => true`. Nobody is seated, so the table's
+  abandoning does not apply; instead the game stops (unrecorded) when
+  every member has left. One game, then the lobby with the same seats.
+  The record is kept with `"watch" => true` (also on `records`' entries)
+  and counts in the stats for the CPU and the AI kinds only, never for a
+  person. The AI players' daily limits work as before.
+- **The game's AI decisions are each seat's own**: `ASTERISM_GAMES_AI_CALLS_PER_GAME`
+  (400) is now how many decisions each AI seat may ask in a game (mahjong
+  and othello, every game, watch games or not); a seat past it becomes a
+  CPU alone. Before, the seats of a game shared it, so a game with three
+  or four AI seats stopped them all part way through a tonpuu. A game's
+  most is now 400 times its AI seats; the daily limits are as before.
+- `play mahjong`: `W` (and the command `watch`) starts a watch game, for
+  the owner with or without a seat; `A` then a seat's number turns that
+  seat into a CPU, Claude, Jev and back (the kinds the lobby offers); the
+  owner's commands (`cpu`, `ai`, `watch`, `--commands`) work for an owner
+  without a seat; the lobby marks the owner among those watching and says
+  the AI limit when the seats are over it; a watch game is headed
+  `観戦対局`.
+- Family mruby's mahjong app (fmruby-core) has a `観戦で始める[W]` button
+  for the owner when the host says it may start (`"wc"`); with an older
+  host it is not shown.
+
 ## 0.19.1
 
 - The commentary tells where to get VOICEVOX when it finds no engine:

data/README.md

@@ -92,7 +92,7 @@ nothing else (othello, the drawing board), `bin/asterism-games` (with
 `play`, the terminal clients of othello and mahjong: a mahjong table needs
 riichi_engine, its client does not; and `commentate`, a mahjong table watched
 in the browser with commentary, with the tile sheets of Family mruby's
-mahjong app). It depends on
+mahjong app and its sound: the effects and the BGM, "The sound"). It depends on
 the asterism gem only (0.7.1 or later in
 0.x; what came after 0.7.1, such as `@status` and `on_app_join`, is used
 when there). Not in it: mahjong (`app/`, it needs the riichi_engine fork
@@ -476,7 +476,8 @@ asterism/games/games/@status
 
 `last` is the four in rank order as `[name, rank, score]`, by the names
 the table shows its members anyway (a table app shows them to whoever
-joins); it is there once a game has ended. The rooms' status file
+joins); it is there once a game has ended. During a watch game the
+table's entry has `"watch" => true` (games 0.20.0). The rooms' status file
 (`GET /status` of the rooms' host) stays counts only.
 
 `ais` counts the AI players' seats (they are counted in `cpus` too), and
@@ -701,6 +702,7 @@ connects again after 3 s; while a client of a router only reconnects
 | `stand` | token | `"ok"` or why not (lobby only) |
 | `cpu` | token, seat, on | the owner: a CPU into an empty seat (on) or out of it (a CPU or an AI player); seat -1 with on fills every empty seat; on as a name the lobby offers (`"claude"`, `"jev"`) puts that AI player in ("AI players"), `"no ai"` when it is not offered; on one seat that holds a CPU or an AI player of another kind, on turns it into the one asked for (games 0.12.1) |
 | `start` | token | the owner, once the four seats are taken and one is a member: the seats are drawn (who deals first) and the game starts |
+| `watch` | token | the owner: a watch game ("Watch games", games 0.20.0): the four seats CPUs or AI players, nobody seated, Claude in one seat at most; `"ok"` or why not (`"not owner"`, `"not waiting"`, `"seats"`, `"human"`, `"ai limit"`) |
 | `rule` | token, item, value | the owner, in the lobby: a local rule ("Local rules"); `"ok"` or why not (`"not owner"`, `"not waiting"`, `"no rule"`, `"value"`, `"no change"`) |
 | `view` | token, assist | the member's view (below), or `{"error" => "token"}`; assist: the help its screen shows (Assist, 0-3) |
 | `act` | token, sv, type, tiles | `"ok"`, or why not: `"token"`, `"not seated"`, `"stale"` (sv is not the current one), `"not offered"`, `"not playing"` |
@@ -712,8 +714,9 @@ connects again after 3 s; while a client of a router only reconnects
 
 - People join a table and wait in its lobby (`"st" => "wait"`): a member
   sits in a seat or watches. The first member who sat is the owner (when the
-  owner stands or leaves, the member seated longest takes over). The owner
-  fills empty seats with CPUs and starts. At the end of a game the owner's
+  owner stands or leaves, the member seated longest takes over). While
+  nobody is seated the owner may be a member without a seat (games 0.20.0,
+  "Watch games"). The owner fills empty seats with CPUs and starts. At the end of a game the owner's
   next (or `over_seconds`) brings the table back to the lobby with the same
   seats, for another game.
 - The node that calls is the caller in the call's key (`from:`, filled
@@ -973,6 +976,47 @@ going for everyone (the other away seats are played for as before). A
 table of CPUs only (`humans: 0`, the permanent spectator tables) is never
 abandoned.
 
+### Watch games
+
+A game of CPUs and AI players only, which the people at the table watch
+(games 0.20.0): the owner fills the four seats and starts it without
+sitting down, and a commentary (`commentate mahjong`, "Commentary") can
+follow it like any other table.
+
+- **The owner without a seat.** A member that joins a table where nobody
+  is seated and nobody is the owner is the owner (`join`'s `"owner"`, the
+  member's own view's `"mo"`). When somebody sits, the first to sit is the
+  owner as before: whenever a member is seated the role is where it always
+  was (the seated member who sat first, "Players that drop out"). An owner
+  who stands up with nobody else seated keeps the role; an owner who
+  leaves with nobody seated hands it to the member who joined first, of
+  those there. An older table app, which knows only `"ow"` (the owner's
+  seat), shows an owner without a seat as no owner, as it showed a lobby
+  without one before.
+- **Starting.** `watch(token)`, the owner, in the lobby: the four seats
+  are CPUs or AI players (`cpu`), no member is seated, and at most one seat
+  is Claude's (`WATCH_AI_MAX`: Claude 1, Jev 4). The lobby view's `"wc"`
+  tells the screens whether it may start (1), or the seats are all CPUs
+  and AI players but over the AI limit (2), or not (0); a host before
+  0.20.0 has no `"wc"`, and the screens offer no watch game then. The
+  seats are drawn as for `start`. The AI players' money is as for any
+  game ("AI players"): a kind past its day's limit becomes a CPU.
+- **During it.** Nobody is seated, so nobody is played for and the
+  table's abandoning does not apply ("Players that drop out"); the results
+  move on by themselves as at a table of CPUs (`result_seconds`), and the
+  end of the game after `over_seconds`. The members watch with the four
+  hands ("Spectators", the spectator delay too). Views have `"wm" => 1`
+  and the host's `@status` has `"watch" => true` for the table ("Status").
+  When every member has left the table (`leave`, or forgotten after being
+  away six times `away_seconds`) the game stops: back to the lobby, an
+  unfinished game not recorded. The log says `watch game started (...)`
+  and `watch game stopped: nobody at the table (not recorded)`.
+- **One game.** At the end the table goes back to the lobby with the same
+  seats; the owner starts another with `watch` again.
+- **Records.** The game is recorded as any other with `"watch" => true`
+  (in `records`' entries and in `record(id)`). Its seats count in the
+  stats for their kinds (CPU, Claude, Jev), never for a person ("Stats").
+
 ### Views
 
 A Hash (MessagePack); tiles are one byte each in binary strings (bin).
@@ -986,7 +1030,9 @@ A Hash (MessagePack); tiles are one byte each in binary strings (bin).
 | `sk` | the four seats: 0 empty, 1 a member, 2 a CPU (an AI player too) |
 | `ai`, `ak` | when an AI player sits: each seat's kind (`"claude"`, `"jev"`, `""` for the others); in the lobby, the AI players the owner may seat ("AI players") |
 | `aw` | the seats whose member is away, as bits |
-| `ow` | the owner's seat (-1: nobody seated) |
+| `ow` | the owner's seat (-1: nobody seated, or an owner without a seat) |
+| `mo` | the member's own view only: 1 when this member is the owner, seated or not (games 0.20.0, "Watch games") |
+| `wc`, `wm` | in the lobby, whether a watch game may start: 1 yes, 2 the seats are all CPUs and AI players but over the AI limit, 0 no; during a watch game `wm` 1 ("Watch games", games 0.20.0) |
 | `mb` | the members in the order they joined: `[name, seat (-1 none), flags (1 away, 2 owner)]` |
 | `r` | `[bakaze (0 east, 1 south, 2 west), kyoku, honba, riichi sticks, dealer seat, tiles left, seat to act, phase (0 draw, 1 discard, 2 calls, 3 end)]` |
 | `sc`, `ri` | the scores; riichi as bits |
@@ -1171,7 +1217,7 @@ assistant through `asterism mcp`).
 
 | Method | Arguments | Returns |
 |---|---|---|
-| `records` | from (optional, 0) | `{"records" => [...], "total", "next"}`: the games, newest first, from the from-th, as many as fit one message; `next` is the from of the next page (none: the end). Each: `id`, `at` (the host's local time, `"2026-10-18 21:05"`), `game` (`hanchan` / `tonpuu`), `names`, `ranks`, `scores` (in seat order) |
+| `records` | from (optional, 0) | `{"records" => [...], "total", "next"}`: the games, newest first, from the from-th, as many as fit one message; `next` is the from of the next page (none: the end). Each: `id`, `at` (the host's local time, `"2026-10-18 21:05"`), `game` (`hanchan` / `tonpuu`), `names`, `ranks`, `scores` (in seat order), `watch` (`true` for a watch game, "Watch games"; else absent) |
 | `record` | id | the game's head: `id`, `at`, `time` (Unix seconds), `table`, `game`, `rules` (as `look`'s), `names`, `kinds` (human / cpu / ai), `final` (`[[seat, rank, score, points x 10], ...]`), `reason` (as the view's `fr`), `rounds` (`[[wind, number, honba, kind, [four changes]], ...]`) |
 | `record` | id, round | round `round` (from 0) as below, with `id`, `round`, `of` (how many rounds), `part`, `parts` |
 | `record` | id, round, part | a round too big for one message comes in parts (`parts` > 1): part 0 has everything with the first moves, part k the moves from `move_from` on |
@@ -1331,7 +1377,9 @@ pipe or a file (and the tests) they read lines as before, and
 | `1`..`4` | the lobby: sit there (an empty seat or a CPU's) |
 | `S` | the lobby: stand |
 | `C` | the lobby, the owner: CPUs into the empty seats |
+| `A`, then `1`..`4` | the lobby, the owner: that seat's next player: an empty seat a CPU, a CPU the first AI player offered, an AI player the next one, the last back a CPU (games 0.20.0; another key gives it up) |
 | Enter | the lobby, the owner: start (four seats taken) |
+| `W` | the lobby, the owner (seated or not): a watch game, the four seats CPUs or AI players ("Watch games", games 0.20.0) |
 
 | Othello | |
 |---|---|
@@ -1460,6 +1508,7 @@ Typed (in a pipe or a file each line; on a terminal after `:`):
 | `cpu [1-4]`, `nocpu 1-4`, `ai 1-4 KIND` | the owner: CPUs into the empty seats (or one), a CPU out, an AI player in when the lobby offers one ("AI players") |
 | `tonpuu`, `hanchan`, `rule ITEM VALUE` | the owner: the game's length, any local rule ("Local rules") |
 | `start` | the owner: start |
+| `watch` | the owner, seated or not: a watch game ("Watch games", games 0.20.0); `--commands "cpu,ai 1 claude,watch"` from a client that does not sit |
 | `auto` | the client plays for you: wins when offered, passes calls, discards the drawn tile, OKs the results (again to stop) |
 | `tables`, `view`, `help`, `quit` | |
 
@@ -1519,7 +1568,8 @@ when it is taken), prints the address and opens it in the browser (macOS
   each, the newest at the bottom. Two seats to a row in a wide window, one
   in a narrow one (a phone). Keys: **Space** pauses (what comes meanwhile
   is held and shown when it goes on), **M** turns the voice off and on,
-  **H** hides the hands on that page (backs instead of the tiles, and the
+  **B** steps the BGM (off, low, mid, high), **E** turns the effects off
+  and on, **H** hides the hands on that page (backs instead of the tiles, and the
   lines that tell a hand left out). A table that several hosts put is
   chosen in the bar.
 - **The AI's one-liners.** Claude's short lines at the big moments,
@@ -1534,6 +1584,9 @@ when it is taken), prints the address and opens it in the browser (macOS
   Japanese voice when it has one (the bar says which voice, or that it has
   none). Browsers play sound only after the page has been clicked once:
   the page says so until then. "The voice" below.
+- **The sound.** The BGM and the effects of Family mruby's mahjong app,
+  at the moments the app plays them, the BGM low by default and lower
+  while the voice speaks. "The sound" below.
 - **The commentary.** Made by rules from the difference between one view
   and the one before (pure functions, `commentate/mahjong_events.rb` and
   `mahjong_phrases.rb`, so the host can take them over later), each event
@@ -1552,9 +1605,10 @@ when it is taken), prints the address and opens it in the browser (macOS
   game goes on as before. The delay of the table is the host's
   ("Spectators"); the page shows it and adds none.
 - **The web server.** HTTP by hand on the standard library's `socket`
-  (no gem): the page, its script and style, the two tile sheets and
-  `/events`, a stream of Server-Sent Events (`status`, `state`, `line`)
-  that pushes the table and the commentary. It listens on `127.0.0.1`
+  (no gem): the page, its script and style, the two tile sheets, the
+  sounds (`/sounds/`, the files of `assets/sounds/` only) and `/events`,
+  a stream of Server-Sent Events (`status`, `state`, `line`) that pushes
+  the table and the commentary. It listens on `127.0.0.1`
   only, answers GET (and HEAD) on those paths only, and refuses a request
   whose Host is not `127.0.0.1` or `localhost`. The page loads nothing from
   elsewhere.
@@ -1665,8 +1719,61 @@ your character before you publish anything; they can change):
   description too** (the page shows it in its corner).
 - Whoever you give generated voices to must follow the same terms, so
   they cannot be mixed into an MIT package. That is why this gem ships no
-  sound: each user makes the files with their own VOICEVOX, and they stay
-  on that machine.
+  voice: each user makes the files with their own VOICEVOX, and they stay
+  on that machine. (The sounds it does ship are the mahjong app's effects
+  and BGM, "The sound".)
+
+### The sound
+
+(games 0.21.0) The page plays the sound of Family mruby's mahjong app:
+its BGM for the scene and its effects and jingles for what happens, the
+same sounds at the same moments as the app. They are files in the gem
+(`lib/asterism_games/commentate/assets/sounds/`), made beforehand with
+Family mruby's own APU emulator from the app's notes and its NSF tunes
+(not played again by ear), and the page plays them with Web Audio after
+the first click (the browser's autoplay rule).
+
+- **The BGM** follows the app's scenes: the lobby (a table waiting, or no
+  table yet) "After The Rain", the game and its results "Spring Thing",
+  the tense part (a riichi on the table, or 10 tiles or fewer left)
+  "Encounter", nothing at the end of a game (the fanfare plays alone). A
+  tune starts from its beginning and repeats its loop without a seam.
+  **B** (or the bar's button) steps it off, low, mid, high: the app's
+  levels (low is 30 % of the tune's full level, mid 55 %, high 100 %, the
+  effects always at theirs), **low by default**.
+- **Ducking.** While the voice speaks (VOICEVOX or the browser's), the BGM
+  goes down to half its level, and back up a moment after the voice stops
+  (not between two lines). The effects are not lowered.
+- **The effects** come with each new view of the table, beside the voice
+  (never waiting in its queue): a round's start, the jingles of a call
+  (チー, ポン, カン), of a riichi, of a win (ロン, ツモ) followed by the
+  winner's points, a draw of the round and the abortive draws, a discard
+  (the app's sound for another player's discard, whoever made it), and
+  the fanfare at the end of the game (the app's spectator's: the
+  winner's). As for the app's spectator, a move sounds its discard only:
+  the player's own sounds (a draw, the turn coming) are not played. They
+  share the APU's four channels as in the app: a sound of a higher
+  priority still sounding keeps its channels, otherwise the newest wins.
+  A voice that would start on top of a jingle waits for most of it (at
+  most 0.6 s). **E** turns the effects off and on. The page remembers
+  both switches (the browser's local storage).
+- **Which sound, when** is a pure function of two views
+  (`commentate/mahjong_sounds.rb`), and each `state` event carries the
+  BGM's scene (`bgm`) and the effects (`sounds`, `[name, delay ms]`).
+- **The files.** The effects are WAVs (mono, 16-bit, the APU's 15720 Hz,
+  under 40 KB each); the three tunes are MP3s (24 kHz mono, 64 kbit/s,
+  about 1 MB each: the tune from its start through one pass of its loop,
+  115 to 154 s). `sounds.json` lists each with its SHA-256, the loop
+  points, the app's levels and scenes. They are made by fmruby-core's
+  `tools/mahjong_sounds.rb` (`ruby tools/mahjong_sounds.rb <dir>`;
+  `--check <dir>` makes them again elsewhere and says whether any differs).
+- **Their licenses** (`assets/SOUNDS_LICENSE.txt`): the effects are the
+  app's author's and are under the MIT License in this gem, by his
+  decision (fmruby-core keeps them under GPL-3.0). **The BGM is not MIT**:
+  the tunes are by shiru8bit under CC BY 3.0, unchanged (only played from
+  their NSF files and saved as MP3). The page shows
+  「BGM: shiru8bit (CC BY 3.0)」 in its corner while the BGM is on, beside
+  the voice's credit; put it in a stream's description too.
 
 ### The AI's one-liners
 
@@ -1825,9 +1932,12 @@ offered), and show the seat by its name (`Claude`, `Jev`, numbered when there ar
   reports, per day (the host's local date), in `state_dir/ai_usage.json`
   (shared by the rooms' hosts and the permanent tables; counts and money
   only). When today's total reaches `ASTERISM_GAMES_AI_DAILY_USD` (3.0) no
-  table offers an AI player any more and the seated ones become CPUs; a
-  game asks at most `ASTERISM_GAMES_AI_CALLS_PER_GAME` (400) decisions,
-  then its AI seats become CPUs. `bin/asterism-games status` prints the
+  table offers an AI player any more and the seated ones become CPUs; each
+  AI seat asks at most `ASTERISM_GAMES_AI_CALLS_PER_GAME` (400) decisions
+  in a game, then that seat becomes a CPU (games 0.20.0: the count is each
+  seat's own, so a game's most is 400 times its AI seats; before, the
+  seats of a game shared the 400 and every AI seat stopped together). A
+  tonpuu takes about 150-200 decisions a seat, a hanchan about twice that. `bin/asterism-games status` prints the
   day's decisions, tokens and money per kind; the host's `@status` has the
   totals (`ai_today`).
 - **A limit per kind** (games 0.15.0). `ASTERISM_GAMES_AI_DAILY_USD_CLAUDE`
@@ -1840,7 +1950,7 @@ offered), and show the seat by its name (`Claude`, `Jev`, numbered when there ar
   0.15.0. A value that is not a number of dollars (0 or more) is ignored,
   with a line in the log. The log says the limits at the start
   (`games: AI players: claude, jev (at most $10.0 a day for claude, $2.0
-  for jev, 400 decisions a game)`) and once for each kind that stops
+  for jev, 400 decisions a seat in a game)`) and once for each kind that stops
   (`today's limit for claude ($10.0) is reached`); a new day lets it play
   again. `ai_today` on `@status` then has `kinds` (README "Status").
 - **Prices.** USD per million tokens, settings with the published prices
@@ -1904,8 +2014,9 @@ game between two machines without a host is fmruby-core's
   "moves" => [{"n", "square", "turns", "text"}]}`; the answer is a move's
   `n`. One out of range, one that does not come in `ai_turn_seconds` (30 s)
   or a failure is played by the CPU, and the game goes on. When the day's
-  money is spent, or the game has asked `ASTERISM_GAMES_AI_CALLS_PER_GAME`
-  decisions, Jev's seat becomes the CPU. The table apps show Jev by its
+  money is spent, or the seat has asked `ASTERISM_GAMES_AI_CALLS_PER_GAME`
+  decisions in the game (each seat its own count, games 0.20.0), Jev's
+  seat becomes the CPU. The table apps show Jev by its
   name with `[AI]` and say when it is thinking; `dl` counts its time down.
 - Nothing in othello is hidden, so every member sees the same view: the
   table's view (the one the host puts on the state key) and `me`, the

data/VERSION

@@ -1 +1 @@
-0.19.1
+0.21.0

data/lib/asterism_games/commentate/assets/SOUNDS_LICENSE.txt

@@ -0,0 +1,63 @@
+The sounds in sounds/
+
+These are the sound of Family mruby's mahjong app (fmruby-core,
+flash/app/game/mahjong/mahjong_sound.rb), which the commentary page plays:
+the effects and jingles, and the BGM of its scenes. They were not played
+again by ear: fmruby-core's tools/mahjong_sounds.rb plays the app's notes
+and tunes with Family mruby's own APU emulator (components/apu_emu) and
+writes the files; sounds/sounds.json lists each file with its SHA-256 and
+what it was made from.
+
+1. The effects and jingles (sounds/*.wav)
+
+   discard, discard_other, draw, turn, round, yaku, points, riichi, pon,
+   chi, kan, ron, tsumo, kyuushu, ryuukyoku, fanfare1, fanfare2, fanfare3,
+   fanfare4
+
+   Written by Katsuhiko Kageyama, the author of Family mruby and of this
+   gem, as notes for the APU. In this gem they are under the MIT License,
+   the license of the gem (LICENSE), by the author's decision. In
+   fmruby-core they stay under that repository's license (GPL-3.0).
+
+   MIT License
+
+   Copyright (c) 2026 Katsuhiko Kageyama
+
+   Permission is hereby granted, free of charge, to any person obtaining a copy
+   of this software and associated documentation files (the "Software"), to deal
+   in the Software without restriction, including without limitation the rights
+   to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+   copies of the Software, and to permit persons to whom the Software is
+   furnished to do so, subject to the following conditions:
+
+   The above copyright notice and this permission notice shall be included in all
+   copies or substantial portions of the Software.
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+   AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+   LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+   OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+   SOFTWARE.
+
+2. The BGM (sounds/*.mp3): music by shiru8bit, CC BY 3.0
+
+   NOT under the MIT License. These three tunes are by shiru8bit and are
+   licensed under the Creative Commons Attribution 3.0 Unported license
+   (CC BY 3.0, https://creativecommons.org/licenses/by/3.0/), as the NSF
+   files Family mruby ships (fmruby-core, flash/usr/share/sounds/nsf/).
+
+     after_the_rain.mp3  "8-bit Chiptune - After The Rain" by shiru8bit
+                         https://opengameart.org/content/8-bit-chiptune-after-the-rain
+     spring_thing.mp3    "8-bit Chiptune - Spring Thing" by shiru8bit
+                         https://opengameart.org/content/8-bit-chiptune-spring-thing
+     encounter.mp3       "8-bit Chiptune - Encounter" by shiru8bit
+                         https://opengameart.org/node/100497
+
+   The music is not changed. Each file is the original NSF played by
+   Family mruby's APU emulator and saved as MP3: from the start of the tune
+   through one pass of its loop (and a second more); the page repeats the
+   loop as the NSF does. Whoever passes these files on, or plays them in a
+   stream or a recording, gives the same credit, for example
+   "BGM: shiru8bit (CC BY 3.0)" (the page shows it in its corner).

data/lib/asterism_games/commentate/assets/commentate.css

@@ -80,19 +80,24 @@ body.obs #captions { max-height: none; background: rgba(0, 0, 0, 0.55); }
 .cap.ai span { color: var(--ai); font-style: italic; }
 .cap.ai.old span { color: var(--dim); }
 #keys { padding: 0 12px 8px; color: var(--dim); font-size: 12px; }
-/* The voice's credit (VOICEVOX:<character>), in the corner, on a stream too. */
-#credit {
+/* The credits (VOICEVOX:<character>, the BGM's), in the corner, on a stream too. */
+#credits {
   position: fixed;
   right: 8px;
   bottom: 6px;
+  display: flex;
+  gap: 6px;
+  pointer-events: none;
+}
+#credits span {
   padding: 1px 6px;
   font-size: 12px;
   color: var(--dim);
   background: rgba(0, 0, 0, 0.45);
   border-radius: 3px;
-  pointer-events: none;
 }
-#credit[hidden] { display: none; }
+#credits span[hidden] { display: none; }
+#bar .btn { cursor: pointer; user-select: none; }
 @media (max-width: 600px) {
   #captions { font-size: 16px; }
   .cap.p3 span { font-size: 18px; }