Lucky

Lucky is a fully self-hosted Discord bot — music, moderation, and a React dashboard in one monorepo.

Why self-hosted? Cloud bots disappear. Groovy, Rythm, and others were killed by enforcement. Lucky runs on your infrastructure, so nobody can take it down.

Music

• YouTube + Spotify + SoundCloud — multi-source, not locked to one provider
• Smart autoplay — builds a playlist from your server's actual listening history, not random tracks
• Session save/restore — queue survives bot restarts
• Lyrics — via slash command

Moderation

• Warn, mute (timed), kick, ban with case tracking
• Scheduled digest reports
• Auto-mod presets (word filter, link filter, spam detection)

Dashboard

• React 19 web UI — music controls, moderation overview, feature toggles
• Discord OAuth login, per-guild settings, RBAC

Engagement

• Leveling system with XP + role rewards
• Starboard
• Last.fm scrobbling
• Twitch stream notifications

Permissions The invite asks for seven, and each one is used:

• View Channels, Send Messages, Embed Links — reading commands and replying
• Connect, Speak — joining a voice channel to play audio
• Manage Messages — deleting messages the auto-mod filters catch
• View Audit Log — read-only, so moderation cases can be attributed to the right moderator

No Administrator. The moderation commands that need stronger permissions (kick, ban, timeout, manage roles) are not requested up front — grant them only if you use those features, and Lucky will tell you which one is missing instead of failing silently.

Self-host in one command

git clone https://github.com/LucasSantana-Dev/Lucky.git
cd Lucky && cp .env.example .env
docker compose up -d

Runs fine on a cheap VPS or alongside other homelab services. If a deploy fails its health checks it rolls back to the last good build automatically.

Or invite the public instance No setup, free: https://lucky.lucassantana.tech/invite

Open source ISC license — fork it, strip out what you don't need, rename it, submit PRs. No restrictions.