magmacrunch-backgammon 0.1.0__tar.gz

magmacrunch_backgammon-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+# The link tools/link-shared.mjs makes to the website's arcade/shared/.
+/shared
+__pycache__/
+*.pyc
+.pytest_cache/
+node_modules/
+.DS_Store

magmacrunch_backgammon-0.1.0/LICENSE

@@ -0,0 +1,75 @@
+Required Notice: Copyright 2026 magmacrunch media (https://magmacrunch.com)
+
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose.  However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license to distribute copies of the software.  Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else.  These terms do not imply any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice.  Otherwise, all your licenses end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
+
+**You** refers to the individual or entity agreeing to these terms.
+
+**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization.  **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the software under these terms.
+
+**Use** means anything you do with the software requiring one of your licenses.

magmacrunch_backgammon-0.1.0/NOTICE

@@ -0,0 +1,30 @@
+backgammon
+Copyright 2026 magmacrunch media
+
+
+THE LICENCE
+
+Everything in this repository -- the game in web/, its terminal version in
+tui/, its tests, the tools and the documentation -- is licensed under the
+PolyForm Noncommercial License 1.0.0, in the LICENSE file beside this one.
+
+Read it, learn from it, build on it, play with it. Any noncommercial purpose is
+permitted, and that includes personal projects, teaching and research. What is not
+permitted is commercial use: selling the game or a derivative of it, shipping it inside
+a product, or running it as part of a business.
+
+Backgammon is a traditional game and nobody's property; this licence does not pretend
+otherwise. What is licensed is this implementation: the rules engine, the board
+renderer, the server and the arcade's presentation of them.
+
+What is reserved: the magmacrunch name and marks and the visual design of the arcade.
+If you want to use any of it, ask.
+
+
+THIRD-PARTY COMPONENTS
+
+Fonts are loaded from Google Fonts under the SIL Open Font License 1.1 rather than
+shipped here as files.
+
+The page loads adenosine-multiplayer.js, arcade-base.css, board-game-template.js, mp-server.js from the website's arcade/shared/, and the server imports server_base from arcade/shared/multiplayer/.
+Those are part of the magmacrunch.com repository and adenosine, and are not copied here.

magmacrunch_backgammon-0.1.0/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.5
+Name: magmacrunch-backgammon
+Version: 0.1.0
+Summary: Backgammon against the computer. Terminal version.
+Project-URL: Homepage, https://magmacrunch.com/arcade/backgammon/
+Author: magmacrunch media
+License-Expression: PolyForm-Noncommercial-1.0.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: arcade,backgammon,board,games,terminal,tui
+Requires-Python: >=3.10
+Requires-Dist: magmacrunch>=0.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: websockets>=14.0; extra == 'dev'
+Provides-Extra: online
+Requires-Dist: websockets>=14.0; extra == 'online'
+Description-Content-Type: text/markdown
+
+# Backgammon (terminal)
+
+Backgammon against the computer, in a terminal. It is the second version of
+the game, beside `web/`. It runs on the
+[magmacrunch](https://github.com/magmacrunch-media/magmacrunch) engine's
+terminal backend, either as a cabinet in the magmacrunch arcade or as its own
+command, and plays the same either way.
+
+```
+pipx install magmacrunch-backgammon
+backgammon
+```
+
+For working on it, from this folder:
+
+```
+pip install -e ".[dev]"
+python -m backgammon
+```
+
+## Keys
+
+| key | |
+|---|---|
+| `←` `↑` `↓` `→` (or `h` `j` `k` `l`) | move the cursor along the points, and between the top and bottom rows |
+| `ENTER` | pick up the checker under the cursor; on a marked point, play that step |
+| `Esc` | put the checker back; then take back the last step; then go to the title (and from there, the arcade) |
+| `D` | double, before you move |
+| `R` | new game |
+| `Q` | quit |
+
+You play cyan, `███`, moving down the board from 24 to 1 and bearing off at the
+bottom right. The computer plays pink, `▒▒▒`. The two differ by shape as well
+as colour, so they stay apart under `NO_COLOR` and `--ascii` (`###` and `+++`).
+The points you can move from have green numbers. Once a checker is picked up,
+a `✦` marks where each die can take it: green for a plain step, yellow for a
+hit. The cursor is an arrow in the middle of the board as well as a shade. The
+panel shows the dice still to play, the cube, both pip counts and the last few
+moves. The computer answers after a second, as it does on the page.
+
+## Moving one step at a time
+
+Each die is played as its own step. When you put a checker down, the screen
+asks for the next die. The move is sent once no further step can follow, so you
+play as much of the roll as the rules allow. `Esc` takes a step back.
+
+This is how the page plays online. The page's single-player game does
+something else: a click plays the *first whole move* in its list that includes
+that step. With a 6-1, clicking 8 to 7 can also move a different checker from
+8 to 2. The rules are the same; only the way you pick among the moves differs.
+
+## Playing a person online (a prototype)
+
+PLAY ONLINE on the title, or `backgammon --online`, connects to the arcade's
+own multiplayer server, the one behind the page's PLAY ONLINE button, so a
+terminal and a browser can share a room. Type a name, then press `C` to create
+a room and read its four-letter code to your opponent, or `J` to join one. The
+host starts the game. Each of you sees your own checkers in cyan, moving down
+to the bottom right: the second player's board is turned round, as the page
+does. You move exactly as against the computer, a step at a time. `D` offers a
+double; when one is offered to you, `Y` takes and `N` passes. `X` then `Y`
+resigns.
+
+```
+pip install "magmacrunch-backgammon[online]"     # websockets, only for this
+backgammon --online
+backgammon --online --server ws://127.0.0.1:8771  # a web/server.py on this machine
+```
+
+The server keeps the rules, and this client needs none of them. Every state
+the server sends lists the mover's legal moves in full, and a move goes back
+as an index into that list. The screen builds your move one step at a time from
+that list, then sends its index. `backgammon/online.py` holds the protocol,
+split into `Table` (the server's state, turned to your seat, with no I/O) and
+`Connection` (the WebSocket, on its own thread). `online_scenes.py` reuses the
+computer game's screen: it gets the server's state in place of a local game.
+
+`tests/test_online.py` runs `web/server.py` in-process on a free port and
+plays it over real sockets. It covers:
+
+- **a whole game from both seats.** After every move, both boards must be
+  mirror images, match a shadow board kept with `rules.py`, and offer exactly
+  the moves `rules.py` gives for each player's own view. The game includes
+  hits, entries from the bar, bearing off and turns passed;
+- the passes the server reports, the fallback for a server that doesn't, and
+  a game that ends without a winner, read without a socket;
+- **the cube** offered, taken, redoubled and passed;
+- out-of-turn and out-of-range moves, which the server ignores;
+- a wrong room code;
+- an opponent leaving;
+- **two complete terminal sessions**, through the lobby, a move from each seat
+  and a resignation, using keys alone.
+
+It never contacts the live server. By hand, the real page in headless Chromium
+has played a terminal client in the second, mirrored seat through a whole game
+to the last checker borne off. The two boards matched, with no page errors.
+
+What a prototype has not done yet:
+
+- **Nobody has played the live server from a terminal**, only a copy of it run
+  locally. The default address is `wss://magmacrunch.duckdns.org/backgammon`,
+  which is what `mpServerFor('backgammon', 8771)` gives the public site.
+- **No reconnect.** A dropped connection says so, and the game is lost.
+- **No chat**, which the browser has.
+- **States can be large.** With doubles early in a game, the list of legal
+  moves runs to thousands, and one state measured 1.9 MB. That is past
+  websockets' default limit of 1 MiB a frame, so this client raises its limit.
+  The browser has no limit. Any other client of this server will need the
+  same.
+- **Passes come from the server now, but not yet from the live one.** When
+  a side has no move, the server rolls for the other side at once. It now
+  lists those passes in the state, and this client logs them with their dice.
+  The live server will only do this once this branch is synced. Until then
+  the client falls back to noticing that the turn came straight back to the
+  side that just moved. The browser doesn't show passes either way.
+
+## It is the browser's game, and the browser's opponent
+
+`backgammon/rules.py` is `web/js/board.js`, `dice.js`, `ai.js` and `game.js`,
+ported function for function. Three tests hold it to the other versions:
+
+- **`tests/test_oracle.py`.** `tools/js_oracle.mjs` loads those files
+  unmodified, with `Math.random` replaced by a seeded generator. It plays 120
+  games through `Game`'s own API: half against a random player, half against
+  a careful one who wins about half of its games. The test replays every game
+  through the port with the same seed and requires the same state after each
+  of about 10,000 moves: whose turn, the dice, every place on the board, every
+  legal move in the page's order, and the cube.
+- **`tests/test_server_parity.py`.** It compares the port's move generator
+  with `web/server.py`'s for every roll and both sides, in positions from
+  played games, so single-player and online offer the same moves.
+- **`tests/test_rules.py`.** It sets up by hand the cases the oracle only
+  reaches by chance.
+
+## Two bugs fixed in both, and the quirks kept
+
+**Entering onto a blot used to remove both checkers.** `board.js` typed every
+entry from the bar as an ordinary entry, even onto the other side's blot. The
+blot was never sent to the bar: the entering checker cancelled it out and
+both left the game. A side short of 15 checkers can never bear off 15, so 188
+of 200 random games could not end. This is fixed in `web/js/board.js` and here
+together. `web/server.py` already got it right, so online play was unaffected.
+
+**The computer used to judge its moves on a board with one sign wrong.** It
+scores each step of a move on a scratch board, applying the steps before it.
+`ai.js` put its own checker down there in the other side's colour. So after
+entering onto its blot on 5 to make a point, it saw 5 as empty, and spent the
+next die breaking the point it had just made. One decision in thirteen was
+judged this way. Fixed in `web/js/ai.js` and here together, the computer beats
+its old self in 63% of 2,000 games.
+
+These quirks are kept, because the oracle requires them:
+
+- **The opening is a roll-off of two dice each**, and the winner moves with
+  its own pair. Standard backgammon rolls one die each and moves with both.
+- **The rules never insist on the larger die** when only one die can be
+  played. With doubles they offer moves of one to four steps. Here you are
+  asked for every step you can play anyway.
+- **The cube can be turned after the roll**, before you move. The computer
+  always takes and never doubles. A game is worth the cube, and there are no
+  gammons.
+
+There is no high-score table, because the page keeps none for backgammon.
+
+Needs a 74x17 terminal.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0, as for the rest of this repository. See `LICENSE`
+and `NOTICE`.

magmacrunch_backgammon-0.1.0/README.md

@@ -0,0 +1,170 @@
+# Backgammon (terminal)
+
+Backgammon against the computer, in a terminal. It is the second version of
+the game, beside `web/`. It runs on the
+[magmacrunch](https://github.com/magmacrunch-media/magmacrunch) engine's
+terminal backend, either as a cabinet in the magmacrunch arcade or as its own
+command, and plays the same either way.
+
+```
+pipx install magmacrunch-backgammon
+backgammon
+```
+
+For working on it, from this folder:
+
+```
+pip install -e ".[dev]"
+python -m backgammon
+```
+
+## Keys
+
+| key | |
+|---|---|
+| `←` `↑` `↓` `→` (or `h` `j` `k` `l`) | move the cursor along the points, and between the top and bottom rows |
+| `ENTER` | pick up the checker under the cursor; on a marked point, play that step |
+| `Esc` | put the checker back; then take back the last step; then go to the title (and from there, the arcade) |
+| `D` | double, before you move |
+| `R` | new game |
+| `Q` | quit |
+
+You play cyan, `███`, moving down the board from 24 to 1 and bearing off at the
+bottom right. The computer plays pink, `▒▒▒`. The two differ by shape as well
+as colour, so they stay apart under `NO_COLOR` and `--ascii` (`###` and `+++`).
+The points you can move from have green numbers. Once a checker is picked up,
+a `✦` marks where each die can take it: green for a plain step, yellow for a
+hit. The cursor is an arrow in the middle of the board as well as a shade. The
+panel shows the dice still to play, the cube, both pip counts and the last few
+moves. The computer answers after a second, as it does on the page.
+
+## Moving one step at a time
+
+Each die is played as its own step. When you put a checker down, the screen
+asks for the next die. The move is sent once no further step can follow, so you
+play as much of the roll as the rules allow. `Esc` takes a step back.
+
+This is how the page plays online. The page's single-player game does
+something else: a click plays the *first whole move* in its list that includes
+that step. With a 6-1, clicking 8 to 7 can also move a different checker from
+8 to 2. The rules are the same; only the way you pick among the moves differs.
+
+## Playing a person online (a prototype)
+
+PLAY ONLINE on the title, or `backgammon --online`, connects to the arcade's
+own multiplayer server, the one behind the page's PLAY ONLINE button, so a
+terminal and a browser can share a room. Type a name, then press `C` to create
+a room and read its four-letter code to your opponent, or `J` to join one. The
+host starts the game. Each of you sees your own checkers in cyan, moving down
+to the bottom right: the second player's board is turned round, as the page
+does. You move exactly as against the computer, a step at a time. `D` offers a
+double; when one is offered to you, `Y` takes and `N` passes. `X` then `Y`
+resigns.
+
+```
+pip install "magmacrunch-backgammon[online]"     # websockets, only for this
+backgammon --online
+backgammon --online --server ws://127.0.0.1:8771  # a web/server.py on this machine
+```
+
+The server keeps the rules, and this client needs none of them. Every state
+the server sends lists the mover's legal moves in full, and a move goes back
+as an index into that list. The screen builds your move one step at a time from
+that list, then sends its index. `backgammon/online.py` holds the protocol,
+split into `Table` (the server's state, turned to your seat, with no I/O) and
+`Connection` (the WebSocket, on its own thread). `online_scenes.py` reuses the
+computer game's screen: it gets the server's state in place of a local game.
+
+`tests/test_online.py` runs `web/server.py` in-process on a free port and
+plays it over real sockets. It covers:
+
+- **a whole game from both seats.** After every move, both boards must be
+  mirror images, match a shadow board kept with `rules.py`, and offer exactly
+  the moves `rules.py` gives for each player's own view. The game includes
+  hits, entries from the bar, bearing off and turns passed;
+- the passes the server reports, the fallback for a server that doesn't, and
+  a game that ends without a winner, read without a socket;
+- **the cube** offered, taken, redoubled and passed;
+- out-of-turn and out-of-range moves, which the server ignores;
+- a wrong room code;
+- an opponent leaving;
+- **two complete terminal sessions**, through the lobby, a move from each seat
+  and a resignation, using keys alone.
+
+It never contacts the live server. By hand, the real page in headless Chromium
+has played a terminal client in the second, mirrored seat through a whole game
+to the last checker borne off. The two boards matched, with no page errors.
+
+What a prototype has not done yet:
+
+- **Nobody has played the live server from a terminal**, only a copy of it run
+  locally. The default address is `wss://magmacrunch.duckdns.org/backgammon`,
+  which is what `mpServerFor('backgammon', 8771)` gives the public site.
+- **No reconnect.** A dropped connection says so, and the game is lost.
+- **No chat**, which the browser has.
+- **States can be large.** With doubles early in a game, the list of legal
+  moves runs to thousands, and one state measured 1.9 MB. That is past
+  websockets' default limit of 1 MiB a frame, so this client raises its limit.
+  The browser has no limit. Any other client of this server will need the
+  same.
+- **Passes come from the server now, but not yet from the live one.** When
+  a side has no move, the server rolls for the other side at once. It now
+  lists those passes in the state, and this client logs them with their dice.
+  The live server will only do this once this branch is synced. Until then
+  the client falls back to noticing that the turn came straight back to the
+  side that just moved. The browser doesn't show passes either way.
+
+## It is the browser's game, and the browser's opponent
+
+`backgammon/rules.py` is `web/js/board.js`, `dice.js`, `ai.js` and `game.js`,
+ported function for function. Three tests hold it to the other versions:
+
+- **`tests/test_oracle.py`.** `tools/js_oracle.mjs` loads those files
+  unmodified, with `Math.random` replaced by a seeded generator. It plays 120
+  games through `Game`'s own API: half against a random player, half against
+  a careful one who wins about half of its games. The test replays every game
+  through the port with the same seed and requires the same state after each
+  of about 10,000 moves: whose turn, the dice, every place on the board, every
+  legal move in the page's order, and the cube.
+- **`tests/test_server_parity.py`.** It compares the port's move generator
+  with `web/server.py`'s for every roll and both sides, in positions from
+  played games, so single-player and online offer the same moves.
+- **`tests/test_rules.py`.** It sets up by hand the cases the oracle only
+  reaches by chance.
+
+## Two bugs fixed in both, and the quirks kept
+
+**Entering onto a blot used to remove both checkers.** `board.js` typed every
+entry from the bar as an ordinary entry, even onto the other side's blot. The
+blot was never sent to the bar: the entering checker cancelled it out and
+both left the game. A side short of 15 checkers can never bear off 15, so 188
+of 200 random games could not end. This is fixed in `web/js/board.js` and here
+together. `web/server.py` already got it right, so online play was unaffected.
+
+**The computer used to judge its moves on a board with one sign wrong.** It
+scores each step of a move on a scratch board, applying the steps before it.
+`ai.js` put its own checker down there in the other side's colour. So after
+entering onto its blot on 5 to make a point, it saw 5 as empty, and spent the
+next die breaking the point it had just made. One decision in thirteen was
+judged this way. Fixed in `web/js/ai.js` and here together, the computer beats
+its old self in 63% of 2,000 games.
+
+These quirks are kept, because the oracle requires them:
+
+- **The opening is a roll-off of two dice each**, and the winner moves with
+  its own pair. Standard backgammon rolls one die each and moves with both.
+- **The rules never insist on the larger die** when only one die can be
+  played. With doubles they offer moves of one to four steps. Here you are
+  asked for every step you can play anyway.
+- **The cube can be turned after the roll**, before you move. The computer
+  always takes and never doubles. A game is worth the cube, and there are no
+  gammons.
+
+There is no high-score table, because the page keeps none for backgammon.
+
+Needs a 74x17 terminal.
+
+## Licence
+
+PolyForm Noncommercial 1.0.0, as for the rest of this repository. See `LICENSE`
+and `NOTICE`.

magmacrunch_backgammon-0.1.0/backgammon/__main__.py

@@ -0,0 +1,31 @@
+"""``python -m backgammon`` -- play backgammon against the computer in a terminal."""
+
+from __future__ import annotations
+
+import argparse
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="backgammon", description="Backgammon against the computer.")
+    parser.add_argument("--play", action="store_true", help="skip the title screen")
+    parser.add_argument("--online", action="store_true",
+                        help="go straight to PLAY ONLINE (needs the [online] extra)")
+    parser.add_argument("--server", metavar="URL",
+                        help="the multiplayer server for PLAY ONLINE, e.g. "
+                             "ws://127.0.0.1:8771 for a web/server.py on this machine")
+    parser.add_argument(
+        "--ascii", action="store_true", dest="ascii_only",
+        help="draw with plain ASCII instead of block and box glyphs. Detected "
+             "automatically from the terminal's encoding; this forces it. "
+             "MAGMACRUNCH_ASCII=1 says the same for every cabinet.",
+    )
+    args = parser.parse_args()
+
+    from backgammon.app import run
+
+    run(args.play, args.ascii_only, server=args.server, online=args.online)
+
+
+if __name__ == "__main__":
+    main()

magmacrunch_backgammon-0.1.0/backgammon/app.py

@@ -0,0 +1,73 @@
+"""Wiring -- how the screens reach each other.
+
+Everything that draws lives in :mod:`backgammon.scenes`; everything that
+decides lives in :mod:`backgammon.rules`. **The terminal is not owned here**:
+it belongs to a ``TuiHost``, which is what lets this run as its own command or
+be seated by the arcade. There is no score table: the page keeps none for
+backgammon.
+"""
+
+from __future__ import annotations
+
+import random
+from collections.abc import Callable
+from typing import Any
+
+from backgammon.arcade import INFO
+from backgammon.scenes import GameScene, TitleScene
+
+
+class BackgammonApp:
+    def __init__(self, host: Any, rand: Callable[[], float] | None = None,
+                 server: str | None = None):
+        self.host = host
+        #: Where PLAY ONLINE connects; None for the arcade's public server.
+        self.server = server
+        #: Stands in for the page's Math.random. Tests pass a seeded one.
+        self.rand = rand or random.random
+        self.root_scene = TitleScene(self)
+
+    @property
+    def renderer(self):
+        return self.host.renderer
+
+    def start_game(self) -> None:
+        self.host.push_scene(GameScene(self))
+
+    def play_online(self) -> None:
+        from backgammon.online import DEFAULT_SERVER
+        from backgammon.online_scenes import OnlineLobbyScene
+
+        self.host.push_scene(OnlineLobbyScene(self, self.server or DEFAULT_SERVER))
+
+    def show_rules(self) -> None:
+        from backgammon.scenes import RulesScene
+
+        self.host.push_scene(RulesScene(self))
+
+    def to_title(self) -> None:
+        self.host.pop_scene()
+
+    def leave(self) -> None:
+        self.host.pop_scene()
+
+    @property
+    def scene(self):
+        return self.host.scene
+
+
+def run(skip_title: bool = False, ascii_only: bool = False, server: str | None = None,
+        online: bool = False) -> None:
+    """Play backgammon as its own command."""
+    from magmacrunch.engine.core.tui_host import TuiHost
+    from magmacrunch.engine.ui.glyphs import Glyphs
+
+    host = TuiHost(title=INFO.title, fps=INFO.fps, hold_ms=INFO.hold_ms,
+                   glyphs=Glyphs.detect(ascii_only=ascii_only))
+    app = BackgammonApp(host, server=server)
+    host.push_scene(app.root_scene)
+    if online:
+        app.play_online()
+    elif skip_title:
+        host.push_scene(GameScene(app))
+    host.run()

magmacrunch_backgammon-0.1.0/backgammon/arcade.py

@@ -0,0 +1,39 @@
+"""What the arcade needs to know to launch this game. Kept tiny: a menu loads
+one of these per installed game just to draw a card."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from magmacrunch.engine.arcade import GameInfo
+
+from backgammon import theme
+
+INFO = GameInfo(
+    key="backgammon",
+    title="Backgammon",
+    blurb="Against the computer, with the doubling cube.",
+    # Turn-based: the frame rate paces the computer's one-second pause and
+    # the cursor, nothing else. Edge input, so one arrow is one point.
+    fps=20,
+    hold_ms=0,
+    min_cols=theme.MIN_COLS,
+    min_rows=theme.MIN_ROWS,
+    accent=theme.PLAYER,
+)
+
+
+class BackgammonGame:
+    """Satisfies :class:`magmacrunch.engine.arcade.ArcadeGame`."""
+
+    info = INFO
+
+    def start(self, host: Any) -> Any:
+        from backgammon.app import BackgammonApp
+
+        return BackgammonApp(host).root_scene
+
+
+GAME = BackgammonGame()
+
+__all__ = ["GAME", "INFO", "BackgammonGame"]