Timer-Bot

A discord bot that should notify you when your Eve-Online structures have been attacked, or are running low on fuel. If you just want to know what is going on, without having to run a full Alliance Auth or SeAT just for this one feature.

Using the Public Instance of the Bot

Written Guide

If you want to set up this bot quickly, you can use the following invite link.

Type !help to see all commands and !auth to authorize a character. This character needs to have the Station Manager role to allow API access to his corporation's structures. (You can find it in game Corporation -> Administration -> Role Management -> Station Services) For any things regarding maintenance I will try to notify people on my community discord sever.

Video Guide

Setting up an Instance on your own Server

Since we need to connect to both ESI and discord, there is sadly still some things to do. TLDR: Create an env file and fill it in with the CCP and Discord info, then run with docker compose.

1. Clone this repository

   git clone https://github.com/14rynx/timer-bot.git

2. Copy the .env file from the example

   cp .env.example .env

3. Head over to the Discord Developers Website and create yourself an application.

   • Go to the "Bot" section and reset the token, then copy the new one. Put it in the .env file (DISCORD_TOKEN=).
   • Enable the "Message Content Intent" in the Bot section.
   • Invite your bot to your server in the "OAuth2" section. In the URL Generator, click on "Bot" and then further down "Send Messages" and "Read Mesasges/View Channels". Follow the generated URL and add the bot to your server.

4. Head over to the Eve onlone Developers Page and create yourself an application.

   • Under "Application Type" select "Authentication & API Access"
   • Under "Permissions" add esi-universe.read_structures.v1, esi-corporations.read_structures.v1, esi-characters.read_notifications.v1
   • Under "Callback URL" set https://yourdomain.com/callback/ (obviously replace your domain)

   Now view the application and copy the values CCP_REDIRECT_URI, CCP_CLIENT_ID and CCP_SECRET_KEY to your .env file.

5. Start the container If you run traefik as a reverse-proxy externally:

   docker-compose up -d --build

   Add the [email protected] to the .env file so that certbot can send you info about your certificates If you want to run this without any external things:

   docker-compose up -d --build -f docker-compose+traefik.yml