discord.py-based bot created for the Folk ARPS Discord server. Bot is configurable, so it can be used with other communities.

FAbot Currently allows for the following commands:

• !help - Gives a list of commands.
• !github - Gives the github URL for the bot
• !armaserver - Gives the address of the main Arma Server
• !testserver - Gives the address of the test / mission maker Arma Server
• !tsserver - Gives the hostname and port number for the main ARMA server, test ARMA server and Teamspeak server
• !nextevent - Lists the next scheduled Folk ARPS session
• !status - Reports the game status on the main Folk ARPS ARMA server
• !ping - Reports the ping time to the main Folk ARPS ARMA server
• !info - Reports information on the main Folk ARPS ARMA server including map name, player count, game state and game type
• !players - Reports the player count on the main server and a list of the players
• !insurgency - Reports information on the Folk ARPS Insurgency server
• !f3 - Gives the address to latest f3 framework download
• !f3wiki pagename - Searches the f3 Wiki
• !biki pagename - Searches the Bohemia Interactive Wiki

If you're using virtualenv (you should) create it in subfolder .venv (it's gitignored). To install (it should take care of dependencies):

python setup.py develop

Copy file config.ini.sample and rename duplicate to config.ini Inside config file, fill out email and password, and if you want to test on your own server, change channels.

To add new commands, you'll need to write a new function to do the actual command, taking two arguments:

• message The actual discord message object which contains things like the channel, the author, the content and so on; and
• args Any arguments that follow the actual command itself (so in "!foo bar", args would be 'bar'

Your function must return String, that will be sent as a response, or return nothing.

If you want your function to show up once someone writes !help, in the first line of the function write documentation for it. Documentation is just a line of text starting and ending with """. Keep it formatted like documentation of other functions.

Once your function is written, you must add @command decorator to it. Just write @decorator('command') before it's declared.

Save that file to folder commands. If you want to create new file inside that folder, you'll need to import it. Open file commands/init.py and append code import filename

Example of new function:

@command("foo")
def bar(message, args):
    """!foo : display bar"""
    client.send_message(message.channel, "bar")