A digital companion for the Modern Art board game, with automatic scoring and a bilingual interface.
- 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.
# Clone or download the project
cd Modern_Art
# Install dependencies
pip install -r requirements.txt
# Launch the app
./run.sh
# Or
streamlit run app.pyOpen http://localhost:8501 in your browser.
- Set up: add 3–5 players.
- Record transactions: enter each auction result.
- End the round: select the top three artists.
- Review payouts: the system calculates and distributes money.
- Continue: play four rounds.
- View final rankings: the highest total assets win.
- QUICK_START.md: quick-start guide.
- THEME.md: theme design.
- UPDATES.md: detailed update log.
- plan.md: project plan.
- Undo the last action.
- Save and load games as JSON.
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.
- 🟡 Manuel Carvalho: yellow.
- 🔵 Sigrid Thaler: blue.
- 🔴 Daniel Melim: red.
- 🟢 Ramon Gamboa: green.
- 🟠 Rafael Parra: orange.
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.
- Python 3.9+
- Streamlit 1.28+ for the web interface.
- Altair + Pandas for value-history charts.
- Custom CSS for the auction-catalogue visual system.
| 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