') + ')', 'gi'); if (regex.test(text)) { found = true; var frag = document.createDocumentFragment(); var parts = text.split(regex); parts.forEach(function(part, i) { if (i % 2 === 0) { frag.appendChild(document.createTextNode(part)); } else { var span = document.createElement('span'); span.className = 'userscript-highlight'; span.textContent = part; frag.appendChild(span); } }); node.parentNode.replaceChild(frag, node); } }); } else if (node.nodeType === 1 && node.childNodes) { // element var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT']; if (!skipTags.includes(node.tagName)) { Array.from(node.childNodes).forEach(highlight); } } } highlight(document.body); // Re-highlight on dynamic content var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1 || node.nodeType === 3) highlight(node); }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Strip utm_, fbclid, gclid, etc. from all links on page (function() { var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content', 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid', 'ref', 'ref_src', 'source', 'medium', 'campaign']; function cleanUrl(url) { try { var u = new URL(url, window.location.origin); var changed = false; trackingParams.forEach(function(p) { if (u.searchParams.has(p)) { u.searchParams.delete(p); changed = true; } }); return changed ? u.toString() : url; } catch (e) { return url; } } function cleanLinks() { document.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } cleanLinks(); var observer = new MutationObserver(function(mutations) { mutations.forEach(function(m) { m.addedNodes.forEach(function(node) { if (node.nodeType === 1) { if (node.tagName === 'A') cleanLinks(); node.querySelectorAll('a[href]').forEach(function(a) { var clean = cleanUrl(a.href); if (clean !== a.href) a.href = clean; }); } }); }); }); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Auto-enable theater mode on YouTube (function() { function tryTheater() { var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]'); if (btn && !btn.classList.contains('activated')) { btn.click(); } } // Try immediately tryTheater(); // Try after navigation (SPA) var lastUrl = location.href; setInterval(function() { if (location.href !== lastUrl) { lastUrl = location.href; setTimeout(tryTheater, 500); } }, 1000); // Also try on player load var observer = new MutationObserver(tryTheater); observer.observe(document.body, { childList: true, subtree: true }); })(); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + ', 'i'); if (__m === '*' || __re.test(location.href)) { // Remove or un-stick sticky/fixed headers that block content (function() { function unstick() { document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) { if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') { el.style.position = 'static'; el.style.top = 'auto'; el.style.zIndex = 'auto'; } }); } unstick(); var observer = new MutationObserver(unstick); observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] }); })(); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); })(); GitHub - ByteTheCookies/DiscordCTFHelper: A powerful and customizable bot to manage and organize CTF competitions on Discord. · GitHub
Skip to content
BranchesTags

Repository files navigation

DiscordCTFHelper

logo

A powerful and customizable bot to manage and organize CTF competitions on Discord.

Table of Contents

About

DiscordCTFHelper is a Go bot built with disgo designed to streamline CTF (Capture The Flag) management on Discord servers. The bot integrates with CTFTime and provides essential features for tracking events, managing participants, and sharing updates.

Features

  • Event Management: Automatically fetch and display upcoming events from CTFTime.
  • Participant Management: Track team members and roles within CTFs.
  • Notifications: Send reminders for upcoming events and important milestones.
  • Event Archive: Organize past event details for reference.
  • Customizable Status: Display real-time bot activity.

Installation

Prerequisites

Steps

  1. Clone this repository:

    git clone https://github.com/akiidjk/DiscordCTFHelper.git
cd DiscordCTFHelper

  2. Install dependencies:

    go mod download

  3. Set up your .env file: Create a .env file in the root directory and include the following variables:

    TOKEN=<discord_token>LOG_LEVEL=infoLOG_FORMAT=textLOG_SOURCE=false

  4. Run the bot:

    go run cmd/ctfhelper/main.go

    Optional flags (dev scope):

    • --sync-commands: Sync slash commands to Discord.
    • --clean-commands: Clean existing commands from Discord.

Usage

  • Invite the bot to your server using the generated OAuth2 link from the Discord Developer Portal.
  • A user with admin role can run the command /init for the bot setup.
  • Create a CTF with /create.

License

This project is licensed under the Apache License. See the LICENSE file for details.

Roadmap

  • Add final scraping for team stats
  • Add overall report generation
  • New handling of channel one channel only read width the banner show
  • Flag command
  • Reaction cookie and fire too each flag
  • Remove command
  • Creds command (command for store and show the creds of a ctf)
  • Send link to ctf message when channel is created
  • /chall command to add challenges
  • Migration to discordgo or disgo (not urgent)
  • /vote to vote next ctf (incomplete)

Contact

For support or questions, feel free to open an issue or contact us directly

About

A powerful and customizable bot to manage and organize CTF competitions on Discord.

Topics

ctfdiscordpython

Resources

Readme
Apache-2.0 license

Code of conduct

Code of conduct

Contributing

Contributing
Activity
Custom properties

Stars

3 stars

Watchers

1 watching

Forks

1 fork
Report repository

Releases

Packages

Used by

Contributors

Languages