Hackcenter Tracker

A Discord bot that tracks challenges, leaderboards, and opponents on Hackcenter.

All bot commands work in DMs only — open a direct message with the bot (server channels are not supported).

If you run !top without an ID, the bot asks you to use !comps and pass a competition ID.

Every 10 minutes the bot checks active competitions for new challenges (for the configured site account’s teams). When a new challenge appears, it sends a DM embed to every user who opted in with !notif.

• First-time opt-in: run !notif in a DM with the bot; run !notif again to opt out.
• Subscribers are stored in track.json under challenge_notif_subscribers.

• !comps — active competitions (use the IDs with !top).
• !top 14 — top 10 teams with rank, name, and score for that competition.

• !challs / !challs <id> — paginated list with ◀ ▶ buttons (5 challenges per page).
• Shows name, category, and points (sorted ascending).

• !track starts setup in DMs: you enter your platform team name, confirm the match, then pick opponent team IDs from the paginated list (comma-separated, e.g. 1,4,5,6,7).
• Every 10 minutes the bot checks the active competition’s leaderboard; if a tracked opponent moves above you, you get a DM:
  ⚠️ name is now above you! (them: #12, you: #15).
• !tracking shows current tracking and remaining teams (with pagination).
• !addtrack 8,12 adds more opponents after setup.
• !untrack clears your tracking entry.

nix develop

1. Install dependencies

pip install -r requirements.txt

(discord.py, python-dotenv, requests, tzdata; black is optional for formatting.)

2. Configure .env

cp .env.example .env

Edit .env:

DISCORD_TOKEN=your_discord_bot_token
CHANNEL_ID=your_discord_channel_id
HC_API_URL=https://hackintro.di.uoa.gr/api
SITE_EMAIL=your_email
SITE_PASSWORD=your_password

The bot logs into the site API with SITE_EMAIL / SITE_PASSWORD (session cookies) to resolve teams and challenges. HC_API_URL should be the API base (same style as in .env.example).

3. Run the bot

python3 bot.py

Logs go to tracker.log and stdout.

These utilities send a single DM by Discord user ID using the same DISCORD_TOKEN as the bot. They do not edit track.json; users still opt in with !notif or complete setup with !track as usual.

Discord may refuse the DM (403) if the user does not share a server with the bot, has DMs from server members disabled, or has blocked the bot.

python3 -m utils.manual_add_notif <discord_user_id>
python3 -m utils.manual_add_track <discord_user_id>

tracker/
├── bot.py                 # Main Discord bot
├── requirements.txt       # Python dependencies
├── chall.json             # Seen challenge IDs (auto-generated)
├── track.json             # Tracking + notification subscribers (auto-generated)
├── tracker.log            # Log file (auto-generated)
├── .env                   # Environment variables (not committed)
├── .env.example           # Environment template
├── utils/
│   ├── manual_add_notif.py   # One-off DM: point users at !notif
│   └── manual_add_track.py   # One-off DM: point users at !track
├── flake.nix
├── flake.lock
└── README.md

• Python 3.8+
• See requirements.txt