![]()
aa-dens
Mercenary dens plugin app for Alliance Auth.
AA-Dens
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
Screenshots

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).
You will also need the django-eveonline-sde 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'toINSTALLED_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 dens_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 |
No reviews yet...
Python Requirements
- allianceauth>=4.12
- django-eveonline-sde
- pyyaml>=6.0
Required Python packages to be installed and other Python requirement.
App Dependencies
Required apps:
-
Used by apps:
-
Dependencies to other apps registered in this app directory.
Classifiers
- Environment :: Web Environment
- Framework :: Django
- Framework :: Django :: 4.2
- Framework :: Django :: 5.2
- Intended Audience :: Developers
- License :: OSI Approved :: MIT License
- Operating System :: OS Independent
- Programming Language :: Python
- Programming Language :: Python :: 3.10
- Programming Language :: Python :: 3.11
- Programming Language :: Python :: 3.12
- Topic :: Internet :: WWW/HTTP
- Topic :: Internet :: WWW/HTTP :: Dynamic Content
Version
2.0.0
License
MIT License
Homepage
https://gitlab.com/r0kym/aa-dens
PyPI
https://pypi.org/project/aa-dens/
Last updated
2 weeks, 4 days ago
First published
1 year, 3 months ago
Category
Plugin Apps
Rating
-Authors
T'rahk Rokym
Maintainers
-
Please login to see more options.