Lucky is a fully self-hosted Discord bot — music, moderation, and a React dashboard in one monorepo.
Why self-hosted?Cloud bots disappear. 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
- Warn, mute (timed), kick, ban with case tracking
- Scheduled digest reports
- Auto-mod presets (word filter, link filter, spam detection)
- React 19 web UI — music controls, moderation overview, feature toggles
- Discord OAuth login, per-guild settings, RBAC
- Leveling system with XP + role rewards
- Starboard
- Last.fm scrobbling
- Twitch stream notifications
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.
ISC license — fork it, strip out what you don’t need, rename it, submit PRs. No restrictions.
