menymo / eptbot

A discord bot used during CTFs by the EPT team.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

EPTbot

This bot is still work in process. It is a fork of igCTF, which is again a fork of NullCTF.

Install

Firstly, edit the /bot/config.py. Most important is to fill inn the bot token.

develop

The /bot folder is mounted into the container, so you just need to restart to get your updated changes.

docker-compose build
docker-compose up # ctrl-c to stop and run up again to restart

start

docker-compose up --build -d

How to Use

The main use for eptbot is to easily set up a CTF for your discord server to play as a team. The following commands listed are probably going to be used the most.

  • !help Display the main help commands.

  • !create "ctf name" This is the command you'll use when you want to begin a new CTF. This command will make a text channel with your supplied name. The bot will also send a message in chat where members can react to join the CTF. enter image description here

  • !add <challenge name> This will create a new channel for a given challenge. enter image description here

  • !done [@users ...] Mark a challenge as done. Needs to be done inside the challenge channel. Optionally specify other users who also contributed to solving the challenge, space separated without the @s. enter image description here

  • !ctf archive Mark the ctf as over and move it to the archive categories (specified in /bot/config.py).


The following commands use the api from ctftime

  • !ctftime countdown/timeleft Countdown will return when a selected CTF starts, and timeleft will return when any currently running CTFs end in the form of days hours minutes and seconds. countdown

  • !ctftime upcoming <number> Uses the api mentioned to return an embed up to 5 upcoming CTFs. If no number is provided the default is 3. upcoming

  • !ctftime current Displays any currently running CTFs in the same embed as previously mentioned.

  • !ctftime top <year> Shows the ctftime leaderboards from a certain year (dates back to 2011). enter image description here

  • !ctftime team [team name/id] Display the top 10 events a team have gotten points for this year. enter image description here

Have a feature request? Make a GitHub issue.

About

A discord bot used during CTFs by the EPT team.

License:GNU General Public License v3.0


Languages

Language:Python 99.4%Language:Dockerfile 0.6%