allianceauth-discordbot is a modular Discord bot designed to integrate deeply with Alliance Auth, a Django-based authentication system for EVE Online alliances. It provides features like user lookup, permissions management, and custom commands, leveraging Django's ORM and authentication. The current version is 5.0.0, and it maintains an active release cadence, often pushing minor updates and bug fixes.
pip install allianceauth-discordbotVerified import paths — ran on the pinned version, not inferred.
To quickly get started with allianceauth-discordbot, you need a running Alliance Auth (Django) project. This example shows how to define a simple custom cog within one of your Django applications. This cog provides two basic commands: `!myhello` (requires Alliance Auth 'basic_access' permission) and `!myping`. The bot is then run using `python manage.py runbot` after configuring `AABOT_TOKEN` and `AABOT_COG_PATH` in your Django `settings.py`.
Migrate your custom cogs to use an external ESI client library (e.g., PyESI) or implement your own OpenAPI client for ESI calls. The library now encourages users to roll their own client.
Review the official documentation and GitHub README for 4.0.0+ regarding 'Running Custom Bot Context Tasks' and 'Using AA-Discordbot from my Project' to adapt your code to the new helper functions and task mechanisms.
Ensure your environment uses Python 3.8 or a newer compatible version (e.g., Python 3.9, 3.10, 3.11).
Double-check your `settings.py`: `INSTALLED_APPS = ['aadiscordbot', 'your_app']` and `AABOT_COG_PATH = ['your_app.cogs']` (where 'your_app.cogs' is the Python import path to your cogs module/directory).