aa-dens 1.3.1

Mercenary dens plugin app for Alliance Auth.

AA-Dens

While this app should be functional bugs are expected. Please report any of them in the issues or send me a PM on discord

Alliance Auth applications to handle mercenary dens

Features

• List mercenary dens
• Show other users mercenary dens depending on your roles
• Sends timers over to timberboard or structuretimers

TODO

• Notify user when a den is reinforced
  • Have an AA notification
  • Route notifications to discord if aa-discordbot is installed
• Kind of LP store on how to cash out den loots?

Screenshots

TODO

Installations

Step 1 - Check prerequisites

aa-dens 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).
The minimal supported version of Alliance Auth is 4.6.0.

You will also need the eveuniverse module to be properly installed.

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-dens

Step 3 - Configure Auth settings

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

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

CELERYBEAT_SCHEDULE['dens_update_owners'] = {
    'task': 'dens.tasks.update_all_den_owners',
    'schedule': crontab(minute='0', hour='*/2'),
    'apply_offset': True,
}

CELERYBEAT_SCHEDULE['dens_update_notifications'] = {
    'task': 'dens.tasks.update_all_owners_notifications',
    'schedule': crontab(minute='*/10'),
    'apply_offset': True,
}

CELERYBEAT_SCHEDULE['dens_send_daily_analytics'] = {
  'task': 'dens.tasks.send_daily_analytics',
  'schedule': crontab(minute='0', hour='5')
}

For the send_daily_analytics task refer to analytics

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.

Analytics

This application will send anonymous analytic data using Alliance Auth built-in analytics module. If you wish to disable the analytics for this application you can easily do so by removing the metenox_send_daily_analytics task.

The collected analytics are

• The number of den owners in your application
• The number of mercenary dens registered

Permissions

Permissions overview.

Name	Description
basic_access	Can access the application and add den owners
corporation_view	Can view all dens anchored by members of their corporation
alliance_view	Can view all dens anchored by members of their alliance
manager	Can view all dens regardless of affiliations

Settings

List of settings that can be modified for the application. You can alter them by adding them in your local.py file.

Name	Description	Default
DENS_ADMIN_NOTIFICATIONS_ENABLED	Decides if admin should be notified about important events like new owners and disabled owners.	True
DENS_FORWARD_TIMER_TO_TIMERBOARD	Decides if notifications will be forwarded to timerboard applications	True

Commands

The following commands can be used when running the module:

Name	Description
dens_update_owners.py	Will check all mercenary den owners and update their in space dens
dens_update_notifications.py	Will check all den owners and update their notifications