Skip to content

About

A Modern Art Board Game Companion

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

🎨 Modern Art Board Game Companion

English · 简体中文

Version Python Streamlit Theme

A digital companion for the Modern Art board game, with automatic scoring and a bilingual interface.

Features

  • Bilingual support: switch between Chinese and English with one click.
  • Bright gallery theme: a cool-white canvas, cobalt actions, and distinct colors for the five artists.
  • Built-in rules: a comprehensive rules dialog.
  • Automatic scoring: focus on the game rather than manual arithmetic.
  • Live leaderboard: current player rankings and assets.
  • Fifth-painting rule: handles the round-ending mechanism.
  • Accumulated artist values: tracks values across rounds.
  • Transaction history: records the game as it progresses.

Quick start

# Clone or download the project
cd Modern_Art

# Install dependencies
pip install -r requirements.txt

# Launch the app
./run.sh
# Or
streamlit run app.py

Open http://localhost:8501 in your browser.

Game flow

  1. Set up: add 3–5 players.
  2. Record transactions: enter each auction result.
  3. End the round: select the top three artists.
  4. Review payouts: the system calculates and distributes money.
  5. Continue: play four rounds.
  6. View final rankings: the highest total assets win.

Documentation

In-app tools

  • Undo the last action.
  • Save and load games as JSON.

Theme

A contemporary auction-catalogue visual system:

  • Cool-white grid canvas and pale blue-gray ledger sidebar.
  • Cobalt primary actions with coral red and yellow accents.
  • Dedicated artist color bars for quick table-side identification.
  • Responsive two-column desktop and single-column mobile layouts.

Five artists

  • 🟡 Manuel Carvalho: yellow.
  • 🔵 Sigrid Thaler: blue.
  • 🔴 Daniel Melim: red.
  • 🟢 Ramon Gamboa: green.
  • 🟠 Rafael Parra: orange.

Key rules

Fifth painting:

  • Revealing any artist's fifth painting ends the round immediately.
  • That painting is not auctioned and belongs to nobody.
  • It still counts toward that artist's ranking.

Value accumulation:

  • Artist values accumulate across all rounds.
  • First place adds $30, second adds $20, and third adds $10.

Technology

  • Python 3.9+
  • Streamlit 1.28+ for the web interface.
  • Altair + Pandas for value-history charts.
  • Custom CSS for the auction-catalogue visual system.

Interface overview

View Description
Main interface Editorial auction-catalogue masthead
Leaderboard Gold, silver, and bronze medals for the top three players
Artist market Color-coded artists with live value tracking
Game rules Comprehensive rules in a dialog

Powered by Streamlit · Built for the auction table

Back to top

About

A Modern Art Board Game Companion

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages