{"id":20885,"library":"aa-killstats","title":"AA KillStats","description":"Alliance Auth plugin for displaying killboard statistics such as Hall of Shame/Fame, top kills, and losses. Version 2.0.5 is the latest, requiring Python 3.10-3.12 and Django/AllianceAuth. Active development, with monthly releases.","status":"active","version":"2.0.5","language":"python","source_language":"en","source_url":"https://github.com/Geuthur/aa-killstats","tags":["alliance-auth","eve-online","killboard","django","esi"],"install":[{"cmd":"pip install aa-killstats","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core framework dependency","package":"allianceauth","optional":false},{"reason":"ESI client for Eve Online API","package":"django-esi","optional":false},{"reason":"Data models for Eve Universe","package":"django-eveuniverse","optional":false},{"reason":"Static data export (SDE) required from v2.0.0+","package":"eve_sde","optional":false},{"reason":"Utility library for Alliance Auth apps","package":"allianceauth-app-utils","optional":true}],"imports":[{"note":"Django auto-discovers apps; manual import is unnecessary and may cause duplicate registration.","wrong":"from killstats import KillstatsConfig","symbol":"KillstatsConfig","correct":"Your app config is auto-discovered; no manual import needed."}],"quickstart":{"code":"# local.py (Alliance Auth settings)\nINSTALLED_APPS += [\n    'eve_sde',  # required from v2.0.0+\n    'killstats',\n]\n\n# After adding, run:\n# python manage.py migrate\n# python manage.py collectstatic\n# Then restart your supervisor services.","lang":"python","description":"Enable the app and run migrations."},"warnings":[{"fix":"In local.py, replace 'aa-killstats' (or older app names) with 'eve_sde' and 'killstats'.","message":"v2.0.0 replaced app name from 'aa-killstats' to 'killstats' and requires adding 'eve_sde' to INSTALLED_APPS. Remove old app entry and add both 'eve_sde' and 'killstats'.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Ensure your ESI token has scopes: 'esi-killmails.read_killmails.v1' and 'esi-killmails.read_corporation_killmails.v1'.","message":"From v1.0.4 onward, killmails are fetched from ESI instead of zKillboard. Custom killmail processing may need updates.","severity":"breaking","affected_versions":">=1.0.4"},{"fix":"Upgrade to 1.0.1+ and remove any custom CSRF handling in templates.","message":"v1.0.1 removed 'csrf' arg from django-ninja. If you override templates, ensure no CSRF workarounds.","severity":"deprecated","affected_versions":"<1.0.1"},{"fix":"Run 'python manage.py collectstatic --noinput' and restart your uwsgi/gunicorn.","message":"After upgrading to v2.x, you must re-run 'python manage.py collectstatic' and restart the web server because static file paths changed.","severity":"gotcha","affected_versions":">=2.0.0"},{"fix":"If you need to extend functionality, use Django signals or custom management commands.","message":"The app does not provide any Python API; it's purely a Django app with views. Do not attempt to import models or functions directly from 'killstats' – use the provided admin/celery tasks.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"pip install eve-sde or add 'eve_sde' to INSTALLED_APPS and run pip install aa-killstats again (dependency will be installed automatically).","cause":"Missing required dependency for v2.0.0+","error":"ModuleNotFoundError: No module named 'eve_sde'"},{"fix":"Run 'python manage.py migrate killstats' and 'python manage.py migrate eve_sde'.","cause":"Migrations not run after adding the app","error":"django.core.exceptions.ImproperlyConfigured: The app 'killstats' uses migrations but the database table 'killstats_killmail' does not exist."},{"fix":"Run 'python manage.py collectstatic --noinput' and ensure the static directory is writable by the user running the web server.","cause":"Static files not collected or wrong permissions","error":"OSError: [Errno 13] Permission denied: '/path/to/static/killstats'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}