bionickatana 887667af07
Build / Build source distribution (push) Failing after 1m31s
Build / Execute unit tests (push) Failing after 6s
Build / Upload Release Asset (push) Has been skipped
Build / upload_pypi (push) Has been skipped
Working on fixing crashing
2026-10-10 15:28:56 -06:00
2021-07-24 15:19:11 +02:00
2020-03-31 20:27:11 +02:00
2026-10-09 23:10:40 -06:00
2026-10-10 15:28:56 -06:00
2026-10-10 15:28:56 -06:00
2021-07-24 14:07:43 +02:00
2026-10-09 23:10:40 -06:00
2021-07-24 13:14:28 +02:00
2020-03-08 15:15:19 +01:00
2019-08-26 22:23:33 +02:00
2019-08-26 22:23:33 +02:00
2026-10-09 23:10:40 -06:00
2026-10-10 12:10:06 -06:00
2026-10-09 23:10:40 -06:00
2026-10-09 23:10:40 -06:00

Downloads

Powered by pyaoaddons & albion online addons

On Linux the app no longer depends on pyaoaddons: it ships a pure-Python Protocol18 decoder and captures packets directly through AF_PACKET (no libpcap needed). pyaoaddons is still used on Windows and macOS.

Discord

Albion Online Stats

Albion online stats is an extension to MMORPG game - Albion Online. It tracks network traffic and displays various statistics, such as damage and DPS meter calculated from in-game actions.

App preview

0.7.0

Youtube live preview

Video

How to use this app

Note

this section does not require any coding knowledge. Those simple two steps are required to use this software :)

Installation

Windows

  1. Make sure that WinPcap is installed in your system. Npcap 0.9983 installer for Windows Vista/2008, 7/2008R2, 8/2012, 8.1/2012R2, 10/2016 (x86 and x64) Make sure to install with the "Install Npcap in WinPcap API-compatible Mode"
  2. Install python all platforms installation instructions or via Microsoft Store.
  3. Download the latest launcher from https://github.com/mazurwiktor/albion-online-stats/releases/latest (albion-online-stats.bat).
  4. Enjoy :)

Linux / macOS

  1. Install python 3 and the venv module with your package manager. On macOS also install libpcap:

    # Debian / Ubuntu
    sudo apt install python3 python3-venv python3-pip
    # Fedora
    sudo dnf install python3 python3-pip
    # Arch
    sudo pacman -S python
    # macOS
    brew install libpcap
    
  2. Capturing network traffic requires elevated privileges. Either run the app with sudo, or grant the Python interpreter the capabilities it needs:

    sudo setcap cap_net_raw,cap_net_admin=eip "$(readlink -f "$(command -v python3)")"
    

    The app can do this for you from the Fix capture permissions button in its error dialog.

  3. Download the latest launcher from https://github.com/mazurwiktor/albion-online-stats/releases/latest (albion-online-stats.sh), make it executable and run it:

    chmod +x albion-online-stats.sh
    ./albion-online-stats.sh
    
  4. Enjoy :)

Note: on macOS (and Windows) the packet capture backend (pyaoaddons) only ships prebuilt wheels for CPython 3.6-3.10. If you use a newer Python, pyaoaddons is not installed automatically and the app will report that the backend is missing. Either use Python 3.10 (or older) or build pyaoaddons from source (requires a Rust toolchain). This does not affect Linux, where the built-in decoder is used.

Configuration

After first execution the app is going to create default configuration file named albion-online-stats.cfg. Feel free to edit it according to your needs.

Debugging

Start the app with --verbose (or set AOSTATS_VERBOSE=1) to enable detailed logging of the app and the packet capture backend:

aostats --verbose

This prints the backend initialization result, the capture-permission probe, and every received game event to the terminal. On Windows/macOS the capture backend also writes its own log to aoaddons.log in the current working directory.

On Linux the app uses its own AF_PACKET capture and Protocol18 decoder; every interface it listens on and every decoded event is logged with --verbose.

To collect packet-discovery data for decoding new features such as silver and item pickup tracking, pass a JSONL log path:

aostats --verbose --log-path /tmp/aostats-discovery.jsonl

This writes raw UDP payloads, decoded Photon messages, translated game messages, emitted app events, and possible item-id annotations to the JSONL file. If --verbose is also set, normal app logs are written to /tmp/aostats-discovery.jsonl.app.log.

On Linux, when the app has no permission to capture packets the backend still reports successful initialization; the app detects this and shows a "Fix capture permissions" button regardless.

Is This Allowed

  • Only monitors your own party
  • Does not modify our game client
  • Does not track players that are not within the player's view
  • Does not have an overlay to the game

Note

this traits of the application are true from version 0.9.0+.

Donate

Become a patron

Getting started

Prerequisites

  • Python installed (python3.6+). On Linux the built-in decoder requires no extra runtime. On Windows/macOS use CPython 3.6-3.10 to get the pyaoaddons capture backend as a prebuilt wheel; newer versions require building it from source.
  • Windows only prerequisites https://github.com/libpnet/libpnet#windows
  • macOS only prerequisites libpcap (brew install libpcap)

All platforms

  1. Clone repository:

    git clone https://github.com/mazurwiktor/albion-online-stats.git
    
  2. [optional] Create and activate python virtualenv

    python -m venv env
    [linux/mac] . env/bin/activate
    [windows powershell] .\env\Scripts\activate.ps1
    [windows cmd.exe] .\env\Scripts\activate.bat
    
  3. Install the package with pip (this also installs the dependencies). On Linux this is all you need. On Windows/macOS, use Python 3.6-3.10 to get the pyaoaddons capture backend automatically.

    python -m pip install .
    

    On Windows/macOS with Python 3.11+ the capture backend is not installed automatically. Either use a Python 3.6-3.10 interpreter, or build pyaoaddons from source first:

    pip install setuptools-rust
    pip install --no-build-isolation git+https://github.com/mazurwiktor/aoaddons-python.git
    python -m pip install ".[capture]"
    
  4. Run the application

    aostats
    

Contribution

Check out wiki page

License

Licensed under either of

at your option.

S
Description
No description provided
Readme 1.8 MiB
Languages
Python 97.8%
Shell 1.6%
Batchfile 0.6%