# ---- Matrix Connection ----
HOMESERVER_URL=https://matrix.example.com
BOT_USER_ID=@gogobee:example.com
BOT_PASSWORD=your_password_here
BOT_DISPLAY_NAME=GogoBee

# Which rooms the bot posts scheduled content to (comma-separated room IDs)
BROADCAST_ROOMS=!roomid:example.com

# Admins who can run admin-only commands (comma-separated Matrix user IDs)
ADMIN_USERS=@yourmxid:example.com

# ---- Runtime ----
DATA_DIR=./data
LOG_LEVEL=info

# ---- External API Keys (all optional) ----
RAWG_API_KEY=
WORDNIK_API_KEY=
CALENDARIFIC_API_KEY=
HOLIDAY_COUNTRIES=US,GB,CA,AU,PT,IN,JP,DE,FR,BR,MX,IT,ES,KR,NL,SE,NO,IE,NZ,ZA,PH
OPENWEATHER_API_KEY=
FINNHUB_API_KEY=
BANDSINTOWN_API_KEY=
TMDB_API_KEY=
SERPAPI_KEY=              # SerpAPI key for image fetching (esteemed members)

# ---- Self-Hosted Services (optional) ----
LIBRETRANSLATE_URL=
OLLAMA_HOST=
OLLAMA_MODEL=
LLM_SAMPLE_RATE=0.15  # 0.0-1.0, fraction of non-keyword messages to classify (1.0 = all)

# ---- Feature Flags ----
FEATURE_URL_PREVIEW=
FEATURE_SHADE=
FEATURE_TRIVIA=true  # set to "false" to disable trivia
FEATURE_ESTEEMED=    # set to anything to enable satirical esteemed member posts
ESTEEMED_ROOM=       # room ID for esteemed member posts (separate from broadcast rooms)

# ---- Games & Economy ----
GAMES_ROOM=                    # room ID where game commands work (trivia, hangman, blackjack, flip)
EURO_COOLDOWN_SECONDS=30       # cooldown between passive euro earning
EURO_DEBT_REMINDER=true        # weekly DM reminder if in debt
EURO_STARTING_CAP=2500         # max starting balance from corpus
HANGMAN_MAX_WRONG_GUESSES=6
HANGMAN_SOLUTION_BONUS_MULTIPLIER=2
HANGMAN_PHRASE_FILE=           # path to newline-delimited phrase file
BLACKJACK_TIMEOUT_SECONDS=60   # auto-play timeout per player turn
BLACKJACK_AUTOPLAY_THRESHOLD=15
BLACKJACK_MIN_BET=1
BLACKJACK_MAX_BET=500
BLACKJACK_DEBT_LIMIT=1000      # max debt before betting disabled
UNO_MIN_BET=10                 # minimum wager in euros (solo)
UNO_POT_TAUNT_THRESHOLD=500   # pot size at which GogoBee starts taunting
UNO_MULTI_MIN_BET=25           # minimum ante for multiplayer UNO
UNO_MULTI_MAX_BET=500          # maximum ante for multiplayer UNO
UNO_MULTI_LOBBY_TIMEOUT=300    # lobby expiry in seconds (default 300 = 5min)
UNO_MULTI_TURN_TIMEOUT=30      # auto-play timeout in seconds (default 30)
UNO_MULTI_MAX_AUTOPLAY=3       # consecutive auto-plays before forfeit

# ---- Space Groups (automatic room grouping for community-wide leaderboards) ----
SPACE_GROUP_THRESHOLD=50       # % of smaller room's members that must overlap (1-100, default 50)

# ---- Missing Members (!haveyouseenthem / !missing) ----
MISSING_THRESHOLD_DAYS=14     # days of inactivity before considered missing
MISSING_MAX_DAYS=90           # days after which they're considered gone, not missing
MISSING_MIN_MESSAGES=10       # minimum lifetime messages to be eligible
MISSING_EXCLUDE_USERS=        # comma-separated user IDs to never list as missing

# ---- Encryption ----
QUOTE_ENCRYPTION_KEY=         # Base64-encoded 32-byte AES-256 key (required for !quote)

# ---- Moderation (disabled by default) ----
FEATURE_MODERATION=            # set to "true" to enable the moderation system
MOD_WORDLIST=                  # path to newline-delimited word list file
MOD_WORDLIST_VARIATIONS=true   # check leetspeak/spaced variants
MOD_STRIKE_EXPIRY_DAYS=30      # strikes expire after N days
MOD_MUTE_DURATION_MINUTES=60   # temp mute duration on strike 2
MOD_MAX_STRIKES=3              # strikes before permanent ban
MOD_FLOOD_MESSAGE_COUNT=5      # messages within window = flood
MOD_FLOOD_MESSAGE_WINDOW_SECONDS=10
MOD_FLOOD_IMAGE_COUNT=3        # images/files within window = flood
MOD_FLOOD_IMAGE_WINDOW_SECONDS=30
MOD_MAX_MESSAGE_LENGTH=2000    # max chars per message (0 = disabled)
MOD_REPEAT_COUNT=3             # same message N times = strike
MOD_REPEAT_WINDOW_SECONDS=60
MOD_REPEAT_SIMILARITY_THRESHOLD=0.85
MOD_MENTION_MAX=5              # max unique @mentions per message
MOD_MENTION_FLOOD_COUNT=3
MOD_MENTION_FLOOD_WINDOW_SECONDS=30
MOD_LINK_RATE_NEW_MEMBER=3     # max links per window (new members only)
MOD_LINK_RATE_WINDOW_SECONDS=60
MOD_INVITE_MAX_PER_HOUR=5
MOD_JOIN_LEAVE_COUNT=3         # join/leave cycles = flag (no auto-strike)
MOD_JOIN_LEAVE_WINDOW_MINUTES=10
MOD_NEW_MEMBER_DAYS=14         # accounts newer than N days = stricter thresholds
MOD_NEW_MEMBER_FLOOD_MULTIPLIER=0.5
MOD_ADMIN_ROOM=                # dedicated admin room for mod notifications
MOD_DM_ON_ACTION=true          # DM users when action is taken

# ---- Rate Limits (per user per day) ----
RATELIMIT_WEATHER=5
RATELIMIT_TRANSLATE=20
RATELIMIT_CONCERTS=10