aa-campaign 0.1.3

Z-Kill Campaigns for Alliance Auth

[!IMPORTANT] AA Campaign requires a working installation of Alliance Auth and django-eveuniverse. Ensure these are set up before proceeding with the installation.

AA Campaign

AA Campaign is a plugin for Alliance Auth that allows you to create and track Z-Kill campaigns. Whether you're monitoring a specific system, a whole region, or targeting a rival alliance, AA Campaign pulls data directly from ZKillboard to provide real-time intelligence and performance tracking.

Index

• AA Campaign
  • Core Requirements
  • Install Instructions
• Features
  • Campaign Dashboard
  • Leaderboards
  • Recent Killmails
  • Ship Class Statistics
• Permissions

Core Requirements

The following AllianceAuth plugins are required:

allianceauth >= 4.12
django-eveuniverse

Install Instructions

After making sure to add the above prerequisite applications.

source /home/allianceserver/venv/auth/bin/activate && cd /home/allianceserver/myauth/

pip install aa-campaign==0.1.1

vi myauth/settings/local.py

Add aacampaign to your INSTALLED_APPS. Ensure that eveuniverse is also present in INSTALLED_APPS.

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

restart the things exit your venv

sudo supervisorctl restart myauth:

[!TIP] You can manually trigger a data pull using: python manage.py aa_campaign_pull --days 30

Features

Campaign Dashboard

The AA Campaign dashboard provides a unified view of all active operations.

Track your progress with a suite of analytical tools and live data feeds. Selecting a campaign displays a detailed breakdown of performance.

• Campaign Stats
  • Instant overview of total kills, losses, ISK value, and overall efficiency.
• Location Tracking
  • Campaigns can be locked to specific Solar Systems, Constellations, or Regions, or set to Global for entity-wide tracking.
• Member vs Target Tracking
  • Define exactly which friendly characters, corporations, or alliances are participating and which hostile entities are the targets.

Leaderboards

Compete for the top spot with integrated character leaderboards.

• Tracks individual performance within each campaign.
• Ranks pilots by kill count and total ISK value.
• Highlights top performers with rank icons for the top 5.

Recent Killmails

A detailed feed of all activity associated with your campaign.

• Color-coded indicators for kills (green) and losses (red).
• Direct links to ZKillboard for detailed analysis.
• Summarized victim and final blow information for quick review.

Ship Class Statistics

Analyze the meta of your campaign.

• Breakdown of kills and losses by ship class.
• Helps identify what ships are being used effectively and where losses are occurring.
• Interactive data tables for easy filtering and sorting.

Permissions

Permission	Description
basic_access	Can access this app
manage_campaign	Can manage campaigns