Numerous WebUI animations, improvements, AI fixes, opporitunity cost-based decision logic, etc.

.env.example

@@ -0,0 +1,86 @@
+# =============================================================================
+# Golf Game Server Configuration
+# =============================================================================
+# Copy this file to .env and customize as needed.
+# All values shown are defaults.
+
+# -----------------------------------------------------------------------------
+# Server Settings
+# -----------------------------------------------------------------------------
+
+# Host to bind to (0.0.0.0 for all interfaces)
+HOST=0.0.0.0
+
+# Port to listen on
+PORT=8000
+
+# Enable debug mode (more verbose logging, auto-reload)
+DEBUG=false
+
+# Logging level: DEBUG, INFO, WARNING, ERROR, CRITICAL
+LOG_LEVEL=INFO
+
+# -----------------------------------------------------------------------------
+# Database
+# -----------------------------------------------------------------------------
+
+# SQLite database for game logs and stats
+# For PostgreSQL: postgresql://user:pass@host:5432/dbname
+DATABASE_URL=sqlite:///games.db
+
+# -----------------------------------------------------------------------------
+# Room Settings
+# -----------------------------------------------------------------------------
+
+# Maximum players per game room
+MAX_PLAYERS_PER_ROOM=6
+
+# Room timeout in minutes (inactive rooms are cleaned up)
+ROOM_TIMEOUT_MINUTES=60
+
+# Length of room codes (e.g., 4 = "ABCD")
+ROOM_CODE_LENGTH=4
+
+# -----------------------------------------------------------------------------
+# Security & Authentication (for future auth system)
+# -----------------------------------------------------------------------------
+
+# Secret key for JWT tokens (generate with: python -c "import secrets; print(secrets.token_hex(32))")
+SECRET_KEY=
+
+# Enable invite-only mode (requires invitation to register)
+INVITE_ONLY=false
+
+# Comma-separated list of admin email addresses
+ADMIN_EMAILS=
+
+# -----------------------------------------------------------------------------
+# Game Defaults
+# -----------------------------------------------------------------------------
+
+# Default number of rounds (holes) per game
+DEFAULT_ROUNDS=9
+
+# Cards to flip at start of each round (0, 1, or 2)
+DEFAULT_INITIAL_FLIPS=2
+
+# Enable jokers in deck by default
+DEFAULT_USE_JOKERS=false
+
+# Require flipping a card after discarding from deck
+DEFAULT_FLIP_ON_DISCARD=false
+
+# -----------------------------------------------------------------------------
+# Card Values (Standard 6-Card Golf)
+# -----------------------------------------------------------------------------
+# Customize point values for cards. Normally you shouldn't change these.
+
+CARD_ACE=1
+CARD_TWO=-2
+CARD_KING=0
+CARD_JOKER=-2
+
+# House rule values
+CARD_SUPER_KINGS=-2         # King value when super_kings enabled
+CARD_TEN_PENNY=1            # 10 value when ten_penny enabled
+CARD_LUCKY_SWING_JOKER=-5   # Joker value when lucky_swing enabled