# =============================================================================
# Puppy Stardew Server Configuration
# 小狗星谷服务器配置
# =============================================================================
#
# Quick Start:
# 1. Copy this file: cp .env.example .env
# 2. Edit .env and fill in your Steam credentials below
# 3. Run: docker compose up -d
#
# 快速开始：
# 1. 复制此文件：cp .env.example .env
# 2. 编辑 .env 并在下方填写您的 Steam 凭证
# 3. 运行：docker compose up -d
#
# =============================================================================

# =============================================================================
# Steam Credentials (REQUIRED) | Steam 凭证（必需）
# =============================================================================
# IMPORTANT: You MUST own Stardew Valley on Steam!
# 重要：您必须在 Steam 上拥有星露谷物语！
#
# Game files will be downloaded via your Steam account during first startup.
# 游戏文件将在首次启动时通过您的 Steam 账户下载。
#
# Your credentials are stored locally and NEVER sent anywhere except to Steam.
# 您的凭证仅存储在本地，除了 Steam 之外不会发送到任何地方。
# =============================================================================

# Your Steam username (NOT email, unless you use email to login)
# 您的 Steam 用户名（除非您使用邮箱登录，否则不是邮箱）
STEAM_USERNAME=your_steam_username

# Your Steam password
# 您的 Steam 密码
STEAM_PASSWORD=your_steam_password

# =============================================================================
# VNC Settings (OPTIONAL) | VNC 设置（可选）
# =============================================================================
# VNC is used for initial setup to create/load a save file.
# VNC 用于初始设置以创建/加载存档文件。
#
# After setup, you can disable VNC to save ~50MB RAM:
# 设置完成后，您可以禁用 VNC 以节省约 50MB 内存：
#   Set ENABLE_VNC=false and restart: docker compose up -d
#   设置 ENABLE_VNC=false 并重启：docker compose up -d
# =============================================================================

# Enable VNC remote access (true/false)
# 启用 VNC 远程访问（true/false）
ENABLE_VNC=true

# VNC password (max 8 characters due to VNC protocol limitation)
# VNC 密码（VNC 协议限制最多 8 个字符）
#
# ⚠️ IMPORTANT: Password will be truncated to 8 characters by VNC!
# ⚠️ 重要：VNC 会自动截断密码为 8 个字符！
#
# SECURITY WARNING: Change this default password!
# 安全警告：更改此默认密码！
VNC_PASSWORD=stardew1

# =============================================================================
# Advanced Options (OPTIONAL) | 高级选项（可选）
# =============================================================================
# Most users don't need to change these settings.
# 大多数用户不需要更改这些设置。
# =============================================================================

# Server timezone (default: UTC)
# 服务器时区（默认：UTC）
# Examples: America/New_York, Europe/London, Asia/Shanghai
# 示例：America/New_York, Europe/London, Asia/Shanghai
# TZ=UTC

# Log monitoring (default: true)
# 日志监控（默认：启用）
#
# Automatically monitors and categorizes game logs.
# 自动监控并分类游戏日志。
# Logs are rotated every 6 hours to prevent disk bloat.
# 日志每6小时轮转一次以防止磁盘占用过大。
#
# Retention: 7 days (detailed) + 30 days (compressed archives)
# 保留期：7天（详细日志）+ 30天（压缩归档）
#
# Set to false to disable log management (saves ~10MB RAM)
# 设置为 false 可禁用日志管理（节省约 10MB 内存）
ENABLE_LOG_MONITOR=true

# =============================================================================
# Troubleshooting | 故障排除
# =============================================================================
#
# Problem: "Disk write failure" when downloading game
# 问题：下载游戏时出现 "Disk write failure"
#
# Solution: Fix data directory permissions
# 解决方法：修复数据目录权限
#   mkdir -p data/{saves,game,steam}
#   chown -R 1000:1000 data/
#   docker compose restart
#
# ---
#
# Problem: Steam Guard code required
# 问题：需要 Steam 令牌代码
#
# Solution: Attach to container and enter code
# 解决方法：连接到容器并输入代码
#   docker attach puppy-stardew
#   (Enter Steam Guard code from your email/mobile app)
#   (输入来自邮箱/手机应用的 Steam 令牌代码)
#   (Press Ctrl+P Ctrl+Q to detach - NOT Ctrl+C!)
#   (按 Ctrl+P Ctrl+Q 分离 - 不是 Ctrl+C！)
#
# ---
#
# Problem: Players can't connect
# 问题：玩家无法连接
#
# Solution: Check firewall and ensure port 24642/udp is open
# 解决方法：检查防火墙并确保端口 24642/udp 已开放
#   Ubuntu/Debian: sudo ufw allow 24642/udp
#   CentOS/RHEL: sudo firewall-cmd --add-port=24642/udp --permanent
#
# ---
#
# For more help, see:
# 获取更多帮助，请查看：
#   - README.md
#   - https://github.com/truman-world/puppy-stardew-server/issues
#   - Docker Hub: https://hub.docker.com/r/truemanlive/puppy-stardew-server
#
# =============================================================================