🎨 现代艺术桌游辅助工具 / Modern Art Board Game Companion

一个美丽、功能完整的现代艺术桌游数字辅助工具

A beautiful, feature-complete digital companion for the Modern Art board game

English | 中文

---

中文

✨ 功能特色

• 🌐 完整双语支持 - 中文/英文一键切换
• 🎨 明亮画廊主题 - 冷白画布、钴蓝操作色与五位艺术家的高识别色
• 📖 详细游戏规则 - 内置完整规则说明弹窗
• 🎮 全自动计分 - 无需手动计算，专注游戏本身
• 📊 实时排行榜 - 动态显示玩家排名和资产
• 🎯 第5幅画规则 - 完美处理关键游戏机制
• 💰 价值累积系统 - 准确追踪跨回合的艺术家价值
• 📝 交易记录 - 完整的游戏历史记录

🚀 快速开始

# 克隆或下载项目
cd Modern_Art

# 安装依赖
pip install -r requirements.txt

# 启动应用
./run.sh
# 或者
streamlit run app.py

应用将在浏览器中打开 http://localhost:8501

🎯 游戏流程

1. 设置游戏 - 添加3-5名玩家
2. 记录交易 - 输入每次拍卖结果
3. 回合结束 - 选择前3名艺术家
4. 查看支付 - 系统自动计算并分配金钱
5. 继续游戏 - 重复4轮
6. 最终排名 - 总资产最高者获胜

📚 文档

• QUICK_START.md - 快速入门指南
• THEME.md - 主题设计文档
• UPDATES.md - 详细更新日志
• plan.md - 项目规划

🛠️ 实用工具 / In-App Tools

• ↩️ 撤销上一步 / Undo last action
• 💾 存档与读档 JSON / Save & load JSON

🎨 主题预览

采用现代艺术拍卖目录风格：

• 冷白网格画布与浅蓝灰账本侧栏
• 钴蓝用于主要操作，珊瑚红与亮黄用于艺术化强调
• 五位艺术家保持独立色条，便于桌边快速识别
• 桌面双栏与移动端单栏响应式布局

🏆 五位艺术家

• 🟡 Manuel Carvalho (黄色)
• 🔵 Sigrid Thaler (蓝色)
• 🔴 Daniel Melim (红色)
• 🟢 Ramon Gamboa (绿色)
• 🟠 Rafael Parra (橙色)

⚠️ 关键规则

第5幅画规则：

• 当任何艺术家的第5幅画被展示时，回合立即结束
• 这幅画不被拍卖，无人拥有
• 但它计入该艺术家的排名

价值累积：

• 艺术家的价值在所有回合中累积
• 第1名 +$30，第2名 +$20，第3名 +$10

🛠️ 技术栈

• Python 3.9+
• Streamlit 1.28+ - Web框架
• Altair + Pandas - 价值走势
• Custom CSS - 拍卖目录视觉系统

English

✨ Features

• 🌐 Full Bilingual Support - Switch between Chinese/English with one click
• 🎨 Bright Gallery Theme - Cool-white canvas, cobalt actions, and artist colors
• 📖 Detailed Game Rules - Built-in comprehensive rules modal
• 🎮 Fully Automatic Scoring - No manual calculation needed
• 📊 Live Leaderboard - Dynamic player rankings and assets
• 🎯 5th Painting Rule - Perfect handling of critical game mechanics
• 💰 Value Accumulation - Accurate tracking of artist values across rounds
• 📝 Transaction Log - Complete game history

🚀 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

The app will open in your browser at http://localhost:8501

🎯 Game Flow

1. Setup - Add 3-5 players
2. Record Transactions - Enter each auction result
3. End Round - Select top 3 artists
4. View Payouts - System auto-calculates and distributes money
5. Continue - Repeat for 4 rounds
6. Final Rankings - Highest total assets wins

📚 Documentation

• QUICK_START.md - Quick start guide
• THEME.md - Theme design documentation
• UPDATES.md - Detailed update log
• plan.md - Project planning

🎨 Theme Preview

Uses a contemporary auction catalogue visual system:

• Cool-white grid canvas and a pale blue-grey ledger sidebar
• Cobalt for primary actions, with coral and yellow graphic accents
• Dedicated artist color bars for instant table-side recognition
• Responsive two-column desktop and single-column mobile layouts

🏆 Five Artists

• 🔴 Manuel Carvalho (Red)
• 🟢 Sigrid Thaler (Green)
• 🟡 Daniel Melim (Yellow)
• 🔵 Ramon Gamboa (Blue)
• 🟣 Rafael Parra (Purple)

⚠️ Key Rules

5th Painting Rule:

• When the 5th painting of any artist is revealed, round ends immediately
• This painting is NOT auctioned and nobody owns it
• But it counts toward that artist's ranking

Value Accumulation:

• Artist values accumulate across ALL rounds
• 1st place +$30, 2nd place +$20, 3rd place +$10

🛠️ Tech Stack

• Python 3.9+
• Streamlit 1.28+ - Web framework
• Altair + Pandas - Value history charts
• Custom CSS - Auction catalogue design system

📸 Screenshots

主界面 / Main Interface Editorial auction catalogue masthead	排行榜 / Leaderboard Gold, silver, bronze medals for top 3 players
艺术家市场 / Artist Market Color-coded artists with live value tracking	游戏规则 / Game Rules Comprehensive rules in a beautiful modal

---

🎊 Made with ❤️ and 🎨

Powered by Streamlit | Built for the Auction Table

⬆ Back to Top