tonnoz / twitter-ctf-bot

A Twitter bot to manage a Capture The Flag competition

twitter-ctf-bot

A Twitter bot written in Java+MongoDB to manage the Sytac Capture The Flag competition at the #JFall2015.

Features

Manages the whole competition via Twitter, namely:

• registers new competitors and re-follow them
• automatically sends tweets or DMs to participants to better explain the rules of the game
• allows participants to attempt at solutions via DMs
• sends feedback on flag found / wrong flag attempts
• save all DMs, Tweet and Events (e.g. follow), to a MongoDB database, skip all the ctf non-related messages.

3rd Party libs

Fetching of all the user-related messages via HBC and the twitter Streaming API. The REST-API is accessed via twitter4j. (DMs, follows and tweets)

Install Requirements

• JDK 8
• Maven 3.x

Usage

1. Create a config file like the example here, specifying your application tokens.
2. launch MVN package to create the uber jar
3. from the terminal:
   java -jar twitter-ctf-bot-1.0.0-SNAPSHOT.jar path/to/properties.file

License

All the code and documentation in this repository are distributed under MIT license.