aa-evescout 1.0.0

Example plugin app for Alliance Auth.

AA eve-scout

AA module that adds commands to the allianceauth-discordbot related to the eve-scout API.
EVE-Scout API documentation can be found here.

Shoutout to Sky Diamond for the API and EVE-Scout for the tireless scanning.

Features

• Automated pings when a connection open in system close to a pre-defined system
• Find connections close to a specific system
• Find drifter observatories close to a specific system

Screenshots

Installations

Step 1 - Check prerequisites

1. aa-evescout is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the official AA installation guide for details)

2. aa-evescout requires two Alliance Auth modules to function. Make sure it is properly setup before going on.

   • allianceauth-discordbot
   • django-eveuniverse

Step 2 - Install app

Make sure you are in the virtual environment (venv) of your Alliance Auth installation. Then install the newest release from PyPI:

pip install aa-evescout

Step 3 - Configure Auth settings

Configure your Auth settings (local.py) as follows:

• Add 'evescout' to INSTALLED_APPS
• Add below lines to your settings file:

CELERYBEAT_SCHEDULE['evescout_update_signatures'] = {
    'task': 'evescout.tasks.update_all_signatures',
    'schedule': crontab(minute='*/6'),
}

Step 4 - Finalize App installation

Run migrations & copy static files

python manage.py migrate
python manage.py collectstatic --noinput

Restart your supervisor services for Auth.

Step 5 - (OPTIONAL) Load eveuniverse data

This command isn't mandatory

If you want to speed up the application in the future you can decide to run

python manage.py eveuniverse_load_data map

This command will take some time to complete and consume a lot of database space. It isn't mandatory to run it so don't hesitate to skip it if you want to save database space.

Permissions

Permissions overview.

Name	Description
create_pinger	The user can use the /evescout initiate-pinger command in the alliance discord

Commands

The following commands can be used when running the module:

Name	Description
evescout_update_signagtures	Updates all signatures from the EVE-scout API
evescout_load_system	Manually loads a solar system to the database to use it in pingers