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

  1. Visit the public dashboard at tktarkovbot.ca.
  2. Click Invite the Bot to open Discord’s OAuth screen with the required scopes and permissions.
  3. In your server run:
    • /admin set_channel in 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 help so everyone sees the commands
  4. 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 undo is 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

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.