aa-killstats

What it is and what it does

aa-killstats is a Django extension for AllianceAuth that ingests EVE Online killmail data and presents aggregated statistics for corporations and alliances. It pulls kill and loss records, maps them to player characters and their alts, and generates leaderboards (top killers, most losses, monthly rankings) plus hall of fame and shame views. The module runs scheduled tasks to fetch killmails, stores them in a local database, and uses EVE SDE data to resolve item and character IDs to human-readable names.

Installation requires configuring AllianceAuth's Django settings, running database migrations, preloading EVE SDE data, and setting up Celery beat tasks to poll for new killmails. Permissions are role-based (basic_access vs. admin_access). The package targets EVE Online community managers and alliance leadership who want in-game statistics dashboards.

Use it for:

• Display monthly kill/loss rankings and top-killer leaderboards within an alliance's internal web portal
• Track corporation performance metrics across multiple allied groups with hall of fame/shame highlights
• Generate historical kill statistics for recruitment or performance reviews of player groups
• Monitor alliance-wide combat activity trends via graphical overviews updated by scheduled killmail ingestion
• Provide role-based access so only alliance leadership can view or modify killstat settings

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Django module for AllianceAuth that tracks and displays EVE Online killboard statistics, including corporation and alliance kill/loss records, rankings, and hall of fame/shame leaderboards.

Yes, if you run an AllianceAuth instance for an EVE Online alliance or coalition. The package is actively maintained, has no known vulnerabilities, installs cleanly, and solves a real need for in-game statistics dashboards. GPLv3 licensing is standard for AllianceAuth modules. Requires AllianceAuth v5 or later and familiarity with Django configuration and Celery task setup.

Install

aa-killstats on PyPI

pip install aa-killstats

uv add aa-killstats

poetry add aa-killstats

Installing aa-killstats

Before you install

Low install friction with a pure-Python wheel. Actively maintained with recent commits. Requires AllianceAuth v5 or later and depends on five runtime packages including django-esi and django-eveonline-sde for EVE data integration.

License in practice

Licensed under GPLv3 (copyleft). You must share modifications under the same license and provide source code to users; suitable for internal alliance use but redistribution requires GPL compliance.

Quickstart

pip install aa-killstats

# In AllianceAuth local.py:
INSTALLED_APPS = ["modeltranslation"] + INSTALLED_APPS
INSTALLED_APPS += ["eve_sde", "killstats"]

# Add scheduled task:
if "killstats" in INSTALLED_APPS:
    CELERYBEAT_SCHEDULE["Killstats :: Check for Killmails"] = {
        "task": "killstats.tasks.run_zkb_r2z2",
        "schedule": crontab(minute="*/1"),
    }

Requires AllianceAuth v5 or later; requires Django 4.2; requires Python 3.10 or later; requires EVE SDE data preloaded via manage.py esde_load_sde; requires Celery beat scheduler configured

Verify before relying

• Whether the package works with AllianceAuth versions newer than v5, or if there are known compatibility constraints
• Performance characteristics when handling large killmail volumes or many corporations/alliances
• Whether the Hall of Fame and Hall of Shame features are fully implemented or still in development

Package facts

Evidence: aa_killstats-3.0.1-py3-none-any.whl

Tags

More WWW/HTTP packages