aa-campaign 0.1.0

Z-Kill Campaigns for Alliance Auth

AA Campaign

AA Campaign is a plugin for Alliance Auth (AA).

---

• AA Campaign
  • Features
  • Management Commands
    • Pull Killmails
    • Setup Periodic Tasks
  • Installation
    • Step 1: Install the Package
    • Step 2: Configure Alliance Auth
    • Step 3: Finalize Installation
  • Updating
  • Contribute

---

Features

• Create Z-Kill campaigns based on location (System, Region, Constellation) or global entity-based campaigns.
• Track friendly entities (Characters, Corporations, Alliances) against target entities.
• Automatically pull killmails from ZKillboard hourly.
• Integrated leaderboard and stats page.
• Efficiency calculation and kill/loss tracking.

Management Commands

Pull Killmails

Manually trigger a data pull from ZKillboard. By default, this only pulls data for the current day.

python manage.py aa_campaign_pull --days 30

Setup Periodic Tasks

Automatically setup the hourly background task for pulling data.

python manage.py aa_campaign_setup

Installation

Step 1: Install the Package

Install the app from GitHub:

pip install git+https://github.com/BroodLK/aa-campaign.git

Step 2: Configure Alliance Auth

Add aacampaign to your INSTALLED_APPS in local.py.

Step 3: Finalize Installation

Run migrations, collect static files, and setup periodic tasks:

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

Restart your Alliance Auth services.

Updating

To update your installation, run:

pip install -U git+https://github.com/BroodLK/aa-campaign.git
python manage.py migrate
python manage.py collectstatic --noinput

Restart your Alliance Auth services.

Contribute

If you've made a new app for AA, please consider sharing it with the rest of the community. For any questions on how to share your app, please contact the AA devs on their Discord. You find the current community creations here.