OpenRadar

Real-time radar for Albion Online
_{Passive network capture • Zero injection • Open source}

⚠️Dragonfire update of 08/31 broke detection on v2.2.3. Pre-release v2.2.4-beta1 restores it; report anything still off on #196.

I don't do a lot of updates recently, because I take some rest and working on something behind... that would be awesome 👀 🫣

Tired of farming blind in the Black Zone? OpenRadar shows the resources, mobs and players around you, in your browser.

It reads the network traffic between your PC and Albion's servers, decodes the Photon protocol, and draws what it finds. No client modification, no memory injection, no proxy. Passive listening only.

1. Install Npcap.
2. Download OpenRadar-windows-amd64.exe from Releases.
3. Run it. The startup banner prints a localhost URL and, when available, a http://<your-lan-ip>:5001 (LAN) one.
4. Open http://localhost:5001, or the LAN URL from a phone on the same network.
5. Launch Albion.

Interfaces are auto-selected. Change them from Settings -> Network in the browser.

# 1. libpcap and ALSA (PulseAudio or PipeWire is used first when present)
sudo apt install libpcap0.8 libasound2   # Debian, Ubuntu
sudo pacman -S libpcap alsa-lib          # Arch

# 2. Download
mkdir ~/albion-radar && cd ~/albion-radar
curl -L -o OpenRadar-linux-amd64 \
  https://github.com/Nouuu/Albion-Online-OpenRadar/releases/latest/download/OpenRadar-linux-amd64
chmod +x OpenRadar-linux-amd64

# 3. Capture without root
sudo setcap cap_net_raw=eip ./OpenRadar-linux-amd64

# 4. Run
./OpenRadar-linux-amd64

sudo ln -s /usr/lib/libpcap.so.1 /usr/lib/libpcap.so.0.8
# or, if that file does not exist
sudo ln -s /usr/lib/libpcap.so /usr/lib/libpcap.so.0.8

OpenRadar -version       # print version and exit
OpenRadar -ip X.X.X.X    # one-shot interface override by IP (does not write network.json)
OpenRadar -dev           # development mode (read assets from disk)

Interface selection persists in network.json next to the binary. Edit it from Settings -> Network, or by hand for headless setups.

ExitLag's default redirection method (WFP) intercepts Albion's traffic above the NDIS layer, so Npcap sees nothing. Wireshark sees nothing either. In ExitLag, open Settings -> Advanced -> Packet redirection method and pick NDIS (Legacy).

Expected, and the question asked most often. Albion encrypts live player positions, so no passive tool can place them on the map. The radar still detects them: open the Players page to see who is around, their guild, alliance, gear and item power. Threat alerts run off that detection. Details in PLAYER_POSITIONS_MITM.md.

Work down this list:

1. Npcap (Windows) or libpcap (Linux) installed, radar restarted afterwards.
2. Settings -> Network: at least one interface ticked and marked active.
3. ExitLag, a VPN or a proxy in the way. See the section above.
4. On Linux, setcap applied, or running as root.

Albion patches shift the wire protocol. When that happens every build stops decoding until the parser catches up. Check Releases for a newer version before opening an issue, and hard-refresh the page (Ctrl+F5) after upgrading.

Yes. Run the binary on the PC that plays Albion, then open the (LAN) URL from the startup banner on the other device. The threat alert sound comes out of the PC running the radar, not the device showing the page. Capture settings stay locked to the host for safety, so the second device gets a read-only view.

No official build. It might compile from source, nobody has tested it. Tracked in #151.

No. Use Issues or Discussions.

The radar only reads network traffic. It never modifies the game client, never injects into its memory, and never touches the connection. That said, it is still a third-party tool for an online game, and whether you use one is your call and your risk.

The alert gate depends on where you are:

Roads of Avalon always count as Black. A Mist counts as Black when you entered it through a lethal entrance or from a red zone, Yellow otherwise, which is what the game does. A triggered alert flashes the screen, pulses the radar border and plays a sound. Players on your ignore list never trigger it.

Players appear in the players list with their gear and item power. They are not drawn on the radar itself: Albion encrypts live positions, see Known limitations.

Picture-in-Picture: playing fullscreen? Pop the radar into a floating always-on-top window. One click, native browser PiP. Alerts mirror onto it.

Self-contained: fonts, icons and game data are bundled in the binary. Once Albion connects, the radar needs no internet.

Main radar view	Detecting resources and mobs
Zoom controls	PiP floating window
Settings page	Resource filtering
Terminal dashboard (TUI)

Albion patches shift the wire protocol regularly. When detection breaks after a game update, that is usually why, and the fix ships as a patch release.

• Player positions: Albion encrypts movement data. Players are detected and listed, but their live positions cannot be placed on the radar without a Photon MITM proxy, which is out of scope. See PLAYER_POSITIONS_MITM.md.
• Some Black Zone maps: background tiles are missing for zone IDs 4000+. Turn the map background off in settings.
• Event 46 timing: HarvestableChangeState can skip sizes or arrive late depending on server batching. The radar shows what the wire delivers. States the server skipped are unrecoverable.

Open bugs and feature requests live in Issues, the roadmap in TODO.md.

git clone https://github.com/Nouuu/Albion-Online-OpenRadar.git
cd Albion-Online-OpenRadar

make run              # run
make dev              # hot-reload (needs: make install-tools)
make test             # Go tests + Vitest
make build-windows    # Windows binary
make build-linux      # Linux binary, via Docker
make all-in-one       # both binaries + READMEs + checksums

├── cmd/radar/        # entry point, flags, app wiring
├── internal/
│   ├── capture/      # multi-interface manager + libpcap workers
│   ├── photon/       # Protocol18 parser, event/op codes, pcap fixtures
│   ├── photonscan/   # shared decode walk used by the pcap tools
│   ├── server/       # HTTP routes, WebSocket, network and settings APIs
│   ├── templates/    # Go templates + HTMX pages
│   ├── ui/           # Bubble Tea TUI dashboard
│   └── logger/       # JSONL structured logging
├── web/              # frontend, embedded in the binary
│   ├── scripts/      # JS modules (core, handlers, drawings, utils)
│   ├── styles/       # Tailwind + DaisyUI, fonts
│   ├── images/       # maps, item and spell icons
│   ├── sounds/       # alert audio
│   └── ao-bin-dumps/ # game data, minified JSON
├── tools/            # Go tools (anonymize-pcap, photon-dump, photon-strings,
│                     # gen-eventcodes, offset-validate) + TS asset scripts
└── docs/             # documentation

Full setup, build system and test strategy: DEV_GUIDE.md.

Found a bug? Open an issue. A network capture helps but is not required: a clear description of where you were and what you expected is already enough to aim the search.

Built by @Nouuu

Based on ZQRadar by @Zeldruck

_{⚠️ For educational purposes. Use at your own risk.}