A feature-rich Discord bot for Valheim PvP communities. Tracks kills, announces streaks with sound effects, manages roles, and provides rich player statistics.
⚠️ Requires integration with KillFeed messages from the Valheim PvP Tweaks mod (e.g. "Player A is killed by Player B"). Killfeed must be forwarded to a dedicated text channel via webhook.
- ✅ Automatic kill tracking and multi-kill recognition
- 🔥 Killstreaks + deathless streaks with voice + embed alerts
- 💀 Streak break detection (embed + dynamic
obezhiren.wavsound) - 🔊 Voice announcements with dynamic sound queueing
- 🖼️ Rich embeds with avatars, role-colored names, emojis
- 📊 Player stats:
/top,/mystats,/stats,/topmmr - 📈 Matchmaking rating (MMR) system with rating deviation (RD) and volatility
- 🧮 Manual and historical rating adjustment via
/mmr,/mmrsync,/mmrlog - 👑 Role assignment based on MMR or kill count
- ✍️ Fully configurable role thresholds via
/roleset,/mmrroleset - 🛠 Admin commands for linking, resetting, adjusting
- 💾 Lightweight SQLite backend
- 🧱 Self-contained build via Nuitka (
main.exe)
This bot uses an advanced matchmaking rating system based on Glicko-2 principles, including:
- Automatic updates after each frag
- Rating deviation and volatility per player
- Manual rating adjustments:
/mmr - Full history replay and resync:
/mmrsync - Role assignment based on rating:
/mmrroles,/mmrroleupdate - Transparent rating history:
/mmrlog
Two parallel systems are supported:
- Assign roles based on rating thresholds
- Commands:
/mmrroleset,/mmrroleupdate,/mmrroles,/mmrroleclear
- Based on total frags + manual bonus points
- Manual control:
/roleset,/roleupdate,/roles,/roleclear
-
Create your bot on Discord Developers
- Save the token in a
.envfile:DISCORD_TOKEN=your_token_here
- Save the token in a
-
Prepare database
- A new
frags.dbwill be created automatically if missing - Or place your own copy in the project root
- A new
-
Add sound effects
- WAV files (
48kHz PCM stereo) go in the/soundsfolder - Required filenames:
doublekill.wav, triplekill.wav, ultrakill.wav, rampage.wav, silent.wav, obezhiren.wav
- WAV files (
-
Run the bot
- Execute:
main.exe(after build)
- Execute:
- Python 3.13.5
- Nuitka 2.7+
opus.dll(already included)- Microsoft Visual Studio Build Tools (C/C++ compiler)
- PyNaCl (for voice playback)
Use build.bat to create a standalone executable (main.exe):
- Compiles all source files
- Includes
/sounds/andopus.dll - Excludes sensitive files (
.env,frags.db)
After build:
- Manually copy:
.envfrags.db(optional — will be auto-created)
- Launch:
main.exe
- Core Development: @ksn
- Coordination: @Gurney, @Gloom
- Engineering Support: ChatGPT 🤖