A comprehensive web-based scoring and player tracking platform for Guandan (掼蛋), a popular Chinese climbing card game. Features persistent player profiles, real-time room sharing, achievement system, and complete game progression tracking.
-
👤 Player Profile System ⭐ NEW in v10.0
- Persistent player identities with unique @handles
- Career statistics tracking (sessions + individual rounds)
- Time tracking: Total playtime, longest session, averages
- All 14 honors synced to profiles automatically
- 20 achievement badges with auto-unlock system
- Partner/rival relationship tracking with win rates
- Recent rankings history (last 10 sessions)
- Player browser with search and pagination
- Community voting integration (MVP/burden votes)
- Profile pages with 8 comprehensive stat sections
-
🏠 Room Browser ⭐ NEW in v10.0
- Browse all active and recent rooms
- Filter rooms by player handle (@fufu)
- Toggle between all rooms and favorites
- Room metadata: players, status, teams, last updated
- Click any room to join/view instantly
- Automatic test player exclusion
- Pagination support (20 rooms per page)
- Relative time display (5分钟前, 3小时前)
-
🤝 Enhanced Partner/Rival Display ⭐ NEW in v10.0
- Show ALL partners and opponents (not just best/worst)
- Sortable by win rate, games played, or total wins
- Click any partner/rival to view their full profile
- Win rate color coding (green ≥50%, red <50%)
- Highlighted best/worst with fun Chinese labels
- Smooth hover effects and transitions
-
🎮 Real-Time Room Sharing & Voting
- Create 6-digit room codes (e.g.,
A1B2C3) for live game sharing - Host mode: Full game control + auto-sync every 10 seconds + auth token protection
- Viewer mode: Real-time spectating + anonymous voting for MVP/burden each round
- Room favorites: ⭐ Mark important rooms for permanent storage (1-year default TTL)
- Modern pill-style navigation across all pages
- Create 6-digit room codes (e.g.,
-
👥 Smart Player Management
- 8 customizable players with 77+ animal & food emoji avatars (no insects)
- Profile integration: Search and add players by @handle
- Bulk name input with space-separated format (
John Mike Sara Lisa) - Quick start: Apply preset names with one click
- Drag-and-drop team assignment supporting desktop and mobile touch
- Smart reset: Preserve player setup while clearing game data
-
🎯 Game Scoring System
- Support for 4, 6, and 8 player modes
- Drag-and-drop ranking with automatic upgrade calculation
- Team level progression: 2→3→4→5→6→7→8→9→10→J→Q→K→A
- A-level rules: Strict mode (must win at own A-level) vs. Lenient mode
- 4-player only: 3 A-level failures (A1/A2/A3) → demote to level 2
- 6/8-player (since 2026-05): no failure counter, no demotion — keep playing until either side wins on their own A
- 8-player sweep bonus: Top 4 positions = 4 level upgrade
-
🏆 Comprehensive Honor System
- 14 data-driven honors with sophisticated algorithms and cultural references:
- 🥇 吕布: First place ratio (quality over quantity) + reliability threshold
- 😅 阿斗: Last place ratio + consecutive penalty system
- 🗿 石佛: Excellence + stability (top 25% with low variance)
- 🌊 波动王: Volatility + extreme range bonus (1st to last swings)
- 📈 奋斗王: Progressive 3-segment trend analysis
- 🛡️ 辅助王: Team support score (bottom-half during team wins)
- 🎪 翻车王: Dramatic drops from top 3 to last place
- 🎲 赌徒: High risk high reward (high first + high last rates)
- 👑 大满贯: Experience all ranking positions (completion rate)
- 🔥 连胜王: Longest consecutive top-half streak
- 🧘 佛系玩家: Closest to median ranking (middle way)
- 🛡️ 守门员: Protect teammates from last place when team loses
- 🐌 慢热王: Poor start but strong finish pattern
- ⚡ 闪电侠: Most frequent ranking changes between games
- Clickable explanations: Each honor shows detailed calculation and statistics
- Mode adaptive: All algorithms properly scale for 4/6/8 player modes
- 14 data-driven honors with sophisticated algorithms and cultural references:
-
🗳️ Community Voting System
- Anonymous viewer voting: Select MVP (最C) and burden (最闹) each round
- Host confirmation: Review community votes and make final decisions
- "人民的声音" panel: Track cumulative community MVP/burden recognition
- Real-time voting: Host sees live vote counts with 1-second updates
- Round-based organization: Separate voting for each completed game round
- Voting results sync to player profiles automatically
-
📤 Advanced Export & Sharing
- Real-time room codes: 6-digit codes with favorite/browsing system
- Room management: Favorite important rooms for permanent storage
- Mobile PNG: 600px width with player stats + 14 honors + game history
- Desktop PNG: Wide format (2200px) with complete data visualization
- Static snapshots: URL-encoded data for permanent preservation
- TXT/CSV export: Complete data analysis including honor calculations
-
🎨 Enhanced User Experience
- Modern ES6 modular architecture (20+ specialized modules)
- Modern pill-style navigation tabs with smooth transitions
- Player profile pages with comprehensive statistics
- Collapsible player setup interface for reduced clutter
- Optimized information hierarchy: setup → team status → ranking → results
- Mobile-first drag & drop with long-press touch support
- Clickable host banner for instant viewer link sharing
- Real-time voting updates and visual feedback systems
- Complete UTF-8 Chinese character support with cultural gaming terminology
🚀 Solo Play:
- Visit the live app URL
- Click "Generate Players" → "Quick Start" for instant setup
- Drag players to assign teams (4 players per team)
- Drag players to ranking positions after each round
- Game auto-calculates and applies results
- Continue until A-level victory and check honor rankings!
👤 With Player Profiles (NEW):
- Navigate to "👥 浏览玩家" tab
- Click "创建新玩家" to create your profile with @handle
- In game, search and add players by @handle
- Stats automatically sync after each A-level victory
- View detailed profiles with career stats and achievements
🏠 Room Browser (NEW):
- Navigate to "🏠 浏览房间" tab
- Browse all active rooms or toggle to favorites
- Filter by player handle (e.g., @fufu)
- Click any room to join/view instantly
- Favorite rooms you want to revisit
📺 Multiplayer Room:
- Host: Click "📺 创建房间" → Get 6-digit code to share with friends
- Viewers: Click "🔗 加入房间" → Enter code for real-time spectating
- Live Sync: Viewers see host's game updates in real-time (every 5 seconds)
- One-Click Share: Host clicks blue banner to copy viewer links instantly
⚡ Bulk Name Setup:
- Use space-separated names:
John Mike Sara Lisa Kate Tom Max Ben(8-player mode) - Quick start buttons provide example names for each mode (4/6/8 players)
The calculator supports customizable scoring rules:
- 4-player mode: Configure upgrade points for each ranking combination (1,2), (1,3), (1,4)
- 6/8-player mode: Configure point thresholds for 1, 2, or 3 level upgrades based on score differences
- A-level rules: Strict mode (must win at own A-level) vs. Lenient mode (can win at any level)
- A-level failure (4-player only): 3 strikes (A1→A2→A3) → reset to level 2; 6/8 modes have no counter and no demotion (since 2026-05)
- Special bonuses: 8-player sweep (positions 1,2,3,4) grants 4-level upgrade
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
-
👤 玩家档案系统 ⭐ v10.0 新功能
- 永久玩家身份识别 (@用户名系统)
- 职业生涯统计追踪（完整局数 + 单回合）
- 时间追踪：总游戏时长、最长局、平均时长
- 14项荣誉自动同步到档案
- 20个成就徽章自动解锁系统
- 队友/对手关系追踪与胜率统计
- 近期排名历史记录（最近10局）
- 玩家浏览器：搜索与分页功能
- 社区投票集成（MVP/闹王投票）
- 档案页面：8大综合统计版块
-
🏠 房间浏览器 ⭐ v10.0 新功能
- 浏览所有活跃和近期房间
- 按玩家用户名筛选 (@fufu)
- 全部房间/收藏房间切换
- 房间元数据：玩家、状态、队伍、最后更新
- 点击任意房间即可加入/观看
- 自动过滤测试玩家
- 分页支持（每页20个房间）
- 相对时间显示（5分钟前、3小时前）
-
🤝 增强的队友对手显示 ⭐ v10.0 新功能
- 显示所有队友和对手（不仅是最佳/最差）
- 可按胜率、场次或胜场排序
- 点击任意队友/对手查看完整档案
- 胜率颜色编码（绿色 ≥50%，红色 <50%）
- 最佳/最差队友特别标注（趣味中文标签）
- 流畅的悬停效果和过渡动画
-
🎮 实时房间分享
- 创建6位房间代码（如：A1B2C3）进行实时游戏分享
- 房主模式：完整游戏控制 + 自动同步（每10秒）
- 观看模式：实时观看他人比赛进展（每5秒更新）
- 安全认证：房主token保护，防止未授权控制
- 现代化药丸式导航标签
-
👥 智能玩家管理
- 8个可自定义玩家，77+动物&食物表情头像（无虫类）
- 档案集成：通过@用户名搜索添加玩家
- 批量姓名输入：空格分隔格式（
小 超 豪 姐 哥 帆 夫 达） - 快速开始：预设姓名一键应用
- 拖放式团队分配，支持桌面和移动端触摸
- 智能重置：保留玩家设置，清空比赛数据
-
🎯 游戏计分系统
- 支持4人、6人和8人模式
- 拖放式排名系统，自动计算升级结果
- 团队级别进程：2→3→4→5→6→7→8→9→10→J→Q→K→A
- A级规则：严格模式（必须自己A级获胜）vs 宽松模式
- 8人横扫奖励：前4名位置 = 升4级
-
🏆 荣誉提名系统
- 基于真实数据的14项特殊荣誉：
- 🥇 吕布：最多第一名（传说战力）
- 😅 阿斗：最多垫底（需要保护）
- 🗿 石佛：排名最稳定（稳如磐石）
- 🌊 波动王：排名波动最大（不可预测）
- 📈 奋斗王：排名稳步提升（越战越勇）
- 🛡️ 辅助王：团队胜利时自己垫底最多（无私奉献）
- 🎪 翻车王：从前三名跌至垫底
- 🎲 赌徒：高风险高回报
- 👑 大满贯：体验所有排名位置
- 🔥 连胜王：最长连续上半区排名
- 🧘 佛系玩家：最接近中位排名
- 🛡️ 守门员：团队失败时保护队友免于垫底
- 🐌 慢热王：开局不佳但强势收尾
- ⚡ 闪电侠：排名变化最频繁
- 可点击说明：每项荣誉显示详细计算和统计
- 模式自适应：所有算法适配4/6/8人模式
- 基于真实数据的14项特殊荣誉：
-
📤 多格式导出分享
- 实时房间代码：6位代码即时分享观看
- 静态快照：URL编码数据永久保存
- 手机版PNG：600px宽度移动优化，大字体易读
- 桌面版PNG：宽屏格式完整数据展示
- TXT/CSV导出：数据分析和记录保存
-
🎨 用户体验优化
- 现代ES6模块化架构（20+专业模块）
- 现代药丸式导航标签与流畅过渡
- 玩家档案页面与综合统计数据
- A级胜利庆祝动画和音效
- 实时同步通知和视觉反馈
- 可点击房主横幅快速分享观众链接
- 响应式设计，完美适配手机和桌面
- UTF-8完整中文字符支持
🚀 本地游戏：
- 访问线上应用
- 点击 "生成玩家" → "快速开始" 即时设置
- 拖拽玩家分配队伍（每队4人）
- 拖拽玩家到排名位置，自动计算和应用结果
- 继续游戏直到A级胜利，查看荣誉提名！
👤 使用玩家档案（新功能）：
- 导航至 "👥 浏览玩家" 标签
- 点击 "创建新玩家" 创建 @用户名 档案
- 在游戏中，通过 @用户名 搜索添加玩家
- A级胜利后统计数据自动同步
- 查看详细档案和职业生涯统计
🏠 房间浏览器（新功能）：
- 导航至 "🏠 浏览房间" 标签
- 浏览所有活跃房间或切换到收藏
- 按玩家用户名筛选（例如：@fufu）
- 点击任意房间即可加入/观看
- 收藏想要重访的房间
📺 多人房间：
- 房主：点击 "📺 创建房间" → 获得6位代码分享给朋友
- 观众：点击 "🔗 加入房间" → 输入代码实时观看
- 实时同步：观众看到房主游戏的实时更新（每5秒）
- 一键分享：房主点击蓝色横幅即可复制观众链接
⚡ 批量设置：
- 使用空格分隔姓名输入：
豪 姐 哥 帆 夫 塔（6人模式） - 各模式都有快速开始按钮提供示例姓名
计算器支持自定义计分规则：
- 4人模式：配置排名组合升级分数，如(1,2)、(1,3)、(1,4)对应的升级级数
- 6/8人模式：基于分差配置升1、2或3级的分数阈值
- A级规则：严格模式（必须在自己的A级获胜）vs 宽松模式（任何级别都可获胜）
- 特殊奖励：8人横扫（占据1,2,3,4名位置）可获得4级升级
- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+
- Modern ES6 Modules: 20+ specialized modules with clean dependencies
- Vite Build System: Fast development server and optimized production builds
- Vanilla JavaScript: No framework dependencies, pure web standards
- UTF-8 Support: Complete Chinese character processing throughout
- Modern UI: Pill-style navigation tabs with smooth transitions
- Backend APIs: 7 Edge Functions for profile CRUD operations
- KV Storage: Persistent player data with Vercel KV (Upstash Redis)
- Auto-Sync: Stats sync automatically after A-level victories
- Dual Metrics: Session-level + round-level statistics
- Social Tracking: Partner/rival relationships with win rates
- Achievement System: 20 badges with auto-unlock logic
- Vercel KV (Upstash Redis): Ultra-fast room data storage (<1ms reads)
- Edge Functions: Serverless API routes for global room management
- Auto-Synchronization: Host games sync automatically every 10 seconds
- Live Polling: Viewers poll for updates every 5 seconds with smart change detection
- TTL Management: Automatic 24-hour room expiration and cleanup
- Room Index: Global index for room browsing (last 100 rooms)
- Room Creation:
POST /api/rooms/create→ Generate 6-digit code → Store in KV - Game Updates: Host actions → Auto-sync to KV →
PUT /api/rooms/{code} - Live Viewing: Viewers poll →
GET /api/rooms/{code}→ Update UI when changed - Profile Sync: A-level victory →
PUT /api/players/{handle}→ Update career stats - Data Persistence: LocalStorage for individual users + KV for shared rooms + profiles
- Sub-second sync: Real-time game state updates
- Global CDN: Vercel edge network for worldwide low-latency access
- Smart polling: UI updates only when data actually changes
- Optimized builds: Vite bundling and minification for production
- Token efficiency: 58K → 3K tokens with player profile system
MIT License - see LICENSE file for details
Contributions are welcome! Please feel free to submit issues or pull requests.
Created with ❤️ for Guandan players worldwide
Note: Guandan (掼蛋) is a climbing card game popular in Jiangsu and Anhui provinces of China. This calculator helps manage the complex scoring and level progression system of the game.