bop-chess · PyPI

Skip to main content<br>Switch to mobile version

Warning

You are using an unsupported browser, upgrade to a newer version.

Warning

Some features may not work without JavaScript. Please try enabling it if you encounter problems.

Search PyPI

Search

bop-chess 0.1.1

pip install bop-chess

Copy PIP instructions

Latest release

Released:<br>Jun 2, 2026

Balance of Power Chess - a CLI strategy card game (BoP) where chess flavor meets a 52-card deck.

Navigation

Verified details

These details have been verified by PyPI<br>Maintainers

silversummitco

Meta

Author: SilverSummitCo LLC

Unverified details

These details have not been verified by PyPI<br>Project links

Homepage

Issues

Source

Meta

License Expression: CC-BY-NC-ND-4.0

SPDX<br>License Expression

Tags

card-game

cli

chess

strategy

balance-of-power

bop

Requires: Python >=3.9

Provides-Extra:<br>dev

Classifiers

Development Status

3 - Alpha

Environment

Console

Intended Audience

End Users/Desktop

Operating System

MacOS

Microsoft :: Windows

POSIX :: Linux

Programming Language

Python :: 3

Python :: 3 :: Only

Python :: 3.9

Python :: 3.10

Python :: 3.11

Python :: 3.12

Topic

Games/Entertainment

Games/Entertainment :: Board Games

Games/Entertainment :: Turn Based Strategy

Report project as malware

Project description

Balance of Power Chess (bop)

"King is the father, Queen the mother, the two is the child — and the child<br>grows into a King. So the cycle of power begins again."

Balance of Power Chess (BoP Chess, or just bop ) is a two-player<br>trick-taking card game that maps a 52-card deck onto chess pieces and a<br>"balance of power" cycle in which even the smallest card can topple the King<br>under the right conditions. This package is the free, open-source<br>command-line implementation of the game by its designer, SilverSummitCo LLC ,<br>intended as a strategy sandbox for testing lines of play before they reach<br>the kitchen-table or commercial versions.

Install

From PyPI (when published)

pipx install bop-chess # recommended<br># or<br>pip install --user bop-chess

After installation, the bop console script is on your $PATH:

bop

The PyPI package name is bop-chess (bop was taken). The bop<br>console script command is unchanged — you still just type bop to play.<br>See the publish runbook for the full release steps.

From source (development install)

git clone https://github.com/silversummitco/balance-of-power-chess.git<br>cd balance-of-power-chess/BalanceOfPowerGame<br>python3 -m venv .venv<br>.venv/bin/pip install -e .[dev]<br>.venv/bin/bop # or: .venv/bin/python -m bop

Optional: desktop launcher (Linux)

bop --install-desktop

Writes a .desktop file under ~/.local/share/applications/ so the game<br>shows up in your applications menu. macOS / Windows print a graceful<br>message instead — launch the game from a terminal on those platforms.

Usage

bop # Play a Game to 64 cumulative Procession points.<br>bop --exhibition # Play a single Match.<br>bop --difficulty easy|hard # Set the AI strength up front.<br>bop --target-score N # Custom target score (default 64).<br>bop --seed N # Reproducible shuffle - same N gives the same deal.<br>bop --name LEE # Skip the name/color/icon setup wizard.<br>bop --no-intro # Skip the opening lore crawl.

bop --rules # Print the full canonical rules and exit.<br>bop --credits # Author, license, tip-jar.<br>bop --leaderboard # Show local stats (per-name win/loss tracking).<br>bop --install-desktop # Add an applications-menu launcher (Linux).<br>bop --version<br>bop --help # Full command sitemap.

While playing, at any "Play number" prompt you can also type:

Token<br>What it does

Play the listed card with that number

h, help<br>Show in-game help

r, rules<br>Show the full rules without leaving the game

t, tricks<br>Show the full Trick History played so far

q, quit<br>Exit cleanly

Environment variables

Var<br>Effect

NO_COLOR<br>Disable all ANSI colors (per the no-color.org convention).

BOP_FORCE_COLOR<br>Force colors on even when stdout isn't a TTY.

BOP_NO_STATS<br>Skip leaderboard persistence for this run.

BOP_STATS_PATH<br>Override the leaderboard file location.

BOP_NO_SOUND<br>Silence the intro chime (terminal bell).

The game in 30 seconds

Chess flavor. King = K, Queen = Q, Bishop = A , Knight = J ,<br>Rook = 10 . Cards 3-9 are pawns. The 2 is the special "en-passant pawn."

Two phases per match.

Battle Round — classic trick-taking. Each trick has a Board Card<br>drawn from the deck which sets the round suit. Must follow suit if<br>able. Higher suit beats lower suit; same suit, higher rank wins.<br>Special plays: en passant (a declared 2 of same-or-higher suit<br>beats a King) and castle (10 + K of the same suit played together,<br>supreme within its suit).

Procession Round — the final battle. Captured face/10/2 cards from<br>the Battle become each player's "power-card" hand. Players play their<br>cards in their own ascending order (suit ladder ♣ → ♦ → ♠ → ♥). A<br>standing card on the Battle Board stays until outranked. Any Queen<br>entering the board (natural or a kept 2 played as a...