Yume is a Discord bot built to make learning Korean more interactive inside your server. It focuses on daily practice, light competition, and small game loops that keep people coming back.
It’s designed to be simple to set up and easy to run in community servers.
Posts Korean words automatically in a chosen channel.
Users can:
- Answer in chat
- Earn XP and coins
- Build streaks
- Level up over time
You control how often words are posted and where they go.
/kminigame
Guess the Korean word based on an image.
/kflagminigame
Multi-round flag guessing game:
- Lobby system
- Adjustable rounds and answer time
- Placement-based scoring
- Results summary at the end
- XP and leveling system
- Coins for correct answers
- Shop with usable items (hints, streak freezes, etc.)
- Profiles and leaderboards
- Achievement tracking
Core commands:
/kprofile/kleaderboard/kwallet/kshop/kstreak
Server admins can:
/kstart— Enable daily word posting/kstop— Disable it/kinterval <minutes>— Set posting frequency/ksetchannel <channel>— Set word channel/ksetlevelchannel <channel>— Set level-up channel/kword add|list|import|export— Manage word bank
-
Copy
.env.exampleto.env -
Fill in:
TOKENCLIENT_ID- (Optional)
GUILD_IDfor faster local testing
-
Install dependencies:
npm install- Register commands:
npm run deploy-commands- Start the bot:
npm start- Per-server config:
storage/configs.json - SQLite database:
storage/game.db
Make sure these files are not committed publicly.
- Node.js 18+
Guild Membersintent enabled in the Discord Developer Portal
- Designed for community servers.
- Not intended for massive-scale deployment without modification.
- Uses SQLite for simplicity.
- Keep your bot token private.
If you run into issues or want to contribute, feel free to reach out.