Documentation
TK-Tarkov-BOT
Gritty slash-command bot for Escape from Tarkov squads. Tracks TKs, crowns champions, manages taunts, and feeds the neon dashboard.
Quick Start
- Visit the public dashboard at tktarkovbot.ca.
- Click Invite the Bot to open Discord’s OAuth screen with the required scopes and permissions.
-
In your server run:
/admin set_channelin the TK log channel/admin create_roles(or/admin set_roles)/admin add <user>if you want to delegate setup/admin set_summary ...for automated recaps/tk helpso everyone sees the commands
- Start logging TKs. No installs, no tokens—just invite and go.
Security Model
- Only the guild owner (or someone they delegate via
/admin add) can run/admin .... /tk undois limited to the owner, Discord admins, or the players directly involved.- Each guild stores data in its own folder—no cross-guild bleed.
- Automatic backups every 24 hours per guild.
Admin Commands
/admin add <user>— grant another member admin control./admin set_channel <#channel>— bind the TK channel./admin create_roles— auto-create Champion/Sponge roles./admin set_roles <champion> <sponge>— link existing roles./admin set_champion_role_name <text>//admin set_sponge_role_name <text>./admin set_summary enabled:<bool> interval_hours:<int> [daily_hour:<0-23>].
TK Tracking Commands
/tk log <killer> <victim>/tk leaderboard,/tk stats [user],/tk history [limit]/tk quote,/tk help,/tk undo,/tk reset confirm:true
Season Control
/season stats,/season end,/season start,/season history <n>
Support & Suggestions
- Run
/tk helpin your server for the full command list. - Support the bot: buymeacoffee.com/jordanrsha5.
Privacy
- Only guild metadata (IDs, role/channel IDs, display names) is stored.
- Everything lives on disk under each guild folder.
-
Removing the bot deletes that server’s data automatically, as does
/admin forget confirm:true. - Full detail in the Privacy Policy and Terms of Service.