cyberBOT is a professional-grade, asynchronous Discord platform engineered for high-stakes Capture The Flag (CTF) competitions. It transforms a standard Discord server into an immersive, automated tactical environment where Agents compete for digital supremacy.
The core philosophy of cyberBOT is Immersion through Automation. Unlike standard CTF bots, cyberBOT focuses on a "Game-Master" aesthetic, providing players with high-resolution visual identities and administrators with a self-healing mission infrastructure.
- Visual Identity: Dynamic, high-resolution Agent Dossiers that evolve with player progress.
- Operational Stability: An asynchronous architecture built to handle high-concurrency submissions without lag.
- Autonomous Management: Self-healing mission posts and automated role promotion engines.
- Dossier System: Every player is assigned a unique, 1800x700 ID card (
/profile) featuring their rank, specialty tags, and clearance progress. - Real-time Intel: Interactive, paginated leaderboards (
/leaderboard) with millisecond-accurate tie-breaking. - Specialization Tracking: The system monitors recent solves to assign specialized HUD tags (WEB, CRYPTO, PWN, etc.) to Agent profiles.
- Dynamic Scheduling: Missions can be posted instantly or scheduled for future deployment with automated start/end times.
- Asset Management: Support for file attachments and external image URLs for every challenge.
- Recursive Economy: A smart refund system that restores points to players automatically if a hint or mission is deleted.
- Anti-Deletion Protocol: The bot monitors its own mission posts; if a challenge message is deleted, the bot immediately re-posts it to maintain competition integrity.
- Language: Python 3.10+
- Library: Discord.py (Slash Command Optimized)
- Database: SQLite 3 with
aiosqliteintegration. - Concurrency: Write-Ahead Logging (WAL) enabled for high-speed I/O.
- Imaging: PIL (Pillow) engine for dynamic 1800x700 canvas rendering.
/profile- Generate high-res Agent ID card./leaderboard- View global standings./about- Display system specs and credits./help- Access the field manual.
/create- Register a new mission in the database./post- Deploy a mission to a channel (Manual or Scheduled)./edit- Modify mission parameters (Flag, Points, Category)./delete- Remove a mission and process recursive refunds./list- View the status of all missions (Posted/Draft)./show- Reveal the capture flag and internal mission data.
/setup- Configure system channels and the Champion role./set_rank_role- Define auto-promotion point milestones./revoke- Manually remove a solve and deduct points./add_hint//remove_hint- Manage purchasable clues./ban_user//unban_user- Manage network access./export//import- Database backup and zero-downtime recovery./wipe_all- Complete data purge (Nuclear Option).
- Environment: Initialize a Python virtual environment and install dependencies via
requirements.txt. - Configuration: Create a
.envfile withDISCORD_TOKEN,GUILD_ID, andPREFIX=/. - Assets: Ensure
font.ttfis present in the root directory for profile generation. - Execution: Run
python main.pyto initialize thebot.dband start the engine.
Developed for SG-CTF. Managed by the ARCHITECT OF THE SIMULATION.