♜Lurker.tv

Lurker.tv Multi‑Platform Stream Bot

Features • Live Alerts: Single deduplicated rich embed per Twitch, Kick, YouTube session (stream session detection). • Role Control: Optional required streamer role + VIP override; auto live role assign/remove. • Points & Progression: Lurk activity tracking (2 modes), monthly rankings, level‑up & milestone notifications. • Watcher Stats: Real‑time aggregated watcher + guest counts powering locked voice stats channels. • Filtering & Gating: Role + point (lurk X days / min points) + VIP inclusion; ignore/allow roles; platform allow list. • Presence Fallback: Presence-based live detection only when no role + no point gating active. • Resilience: Redis cache (message mappings, recent deletions), restart reconstruction (channel scan, mapping rebuild). • Performance: Sharded, adaptive cycles, prioritized guilds, batched role ops, memory monitoring, stale mapping pruning. • Safety & Cleanup: Intelligent duplicate prevention, stale mapping cleanup post-cycle, time-limit filter (max streaming minutes). • Logging: Structured smart logger + targeted trace for selected guilds.

Tech Stack MySQL (points, config) • Redis (cross‑shard cache) • discord.js v14 (sharded) • Adaptive task scheduling.

Privileged Intents Used Members (mandatory for role/points logic) • Presences (for fallback detection). Message Content only if legacy prefix commands needed.

Why It’s Different Focus on clean, single notifications, strict gating, and automated recovery—minimal noise, maximum reliability.

Tags discord-bot • twitch-youtube-kick • live-stream-notifications • points-ranking • multi-platfor