OpenRadar

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

⏸️ Project on pause

Hey. Taking a break from this for a while, personal health stuff.

I see the comments, the downloads, the messages. I built this for myself at first and seeing how many people actually use it is kind of wild. Thanks for that, really.

Haven't tested it in a while so if the game updated and things broke, I haven't seen it yet. I'll get back to it when I can.

Take care. ❤️

-- Nouuu

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

How does it work? The app listens to network traffic between your PC and Albion's servers, decodes the Photon
protocol, and displays everything on a web-based radar. No client modification, no memory injection. Just passive
reading.

Quick Start

Windows

1. Install Npcap (required for packet capture)
2. Download OpenRadar-windows-amd64.exe from Releases
3. Run it, pick your network adapter
4. Open http://localhost:5001 in your browser
5. Launch Albion and start playing

Linux

# Install libpcap
sudo apt install libpcap0.8  # Debian/Ubuntu

# Download and set permissions
chmod +x OpenRadar-linux-amd64
sudo setcap cap_net_raw=eip ./OpenRadar-linux-amd64

# Run
./OpenRadar-linux-amd64

CLI Options

OpenRadar -version       # Show version
OpenRadar -ip X.X.X.X    # Skip adapter selection
OpenRadar -dev           # Development mode (read files from disk)

What It Detects

Production-Ready

Player Threat Detection

Alert System: Screen flash + sound on hostile detection

Basic (Legacy)

Dungeons and chests are detected but not yet refactored. Coming in v2.2:

• Dungeons: Solo, Group, Corrupted, Hellgate entrances show on radar
• Chests: Loot chests visible, rarity classification planned

Radar Controls

Features

Picture-in-Picture

Playing fullscreen? Pop the radar into a floating window that stays on top. Native browser PiP, one click.

Zone-Aware Alerts

The radar knows where you are. Safe zone? Quiet. Black Zone? Every player is a threat. Visual flash + audio alert when
hostiles appear.

Self-Contained

Fonts, icons, everything bundled. Once Albion connects, the radar works without internet.

Roadmap

Check TODO.md for what's coming:

• v2.2: Dungeons, Chests, Mists, Fishing refactoring
• Future: Native desktop app (Wails v3), squad mode, session heatmaps

Screenshots

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

What's New in v2.1

This release is all about polish. Memory leaks hunted down, every frame squeezed, the whole thing feels snappier.

Performance

Event listener leaks fixed, LRU caching for images, server-side WebSocket batching, client-side event coalescing. The
radar now runs for hours without degradation.

UX Improvements

• SPA navigation: No more page reloads. Click around, everything stays smooth
• PiP mode: Native browser Picture-in-Picture, stays on top of your game
• Zone indicators: See at a glance if you're in safe, yellow, red, or black zone
• Smarter alerts: Only warns when there's actual danger
• Settings persistence: Config survives refresh and navigation

Under the Hood

• PageController orchestrates init/destroy cycles, no more orphan listeners
• WebSocketManager with auto-reconnect and visibility handling
• Image cache with LRU eviction (bye bye memory bloat)
• Server-side event batching every 16ms
• Client-side event coalescing for Move/Health updates
• All CDN dependencies removed (fonts, icons, HTMX bundled locally)

Smaller Binary

Asset optimization cuts embedded data massively:

The 84 MB localization file? Gone. Minified JSONs keep only what the radar needs.

Total embedded: ~210 MB → ~45 MB

For Developers

Requirements

Quick Start

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

make run   # Run directly
# or
make dev   # Run with hot-reload (requires: make install-tools)

Build

make build-win        # Windows binary
make build-linux      # Linux binary (via Docker)
make release-snapshot # Full release build (both platforms)

Project Structure

├── cmd/radar/        # Entry point + TUI
├── internal/         # Go packages
│   ├── capture/      # Packet capture (pcap)
│   ├── photon/       # Protocol parsing
│   ├── server/       # HTTP + WebSocket
│   └── templates/    # Go templates (.gohtml)
├── web/              # Frontend (embedded in binary)
│   ├── scripts/      # JavaScript modules
│   ├── images/       # Maps, items, spells icons
│   └── ao-bin-dumps/ # Game data (minified)
├── tools/            # Build & data scripts (Node.js)
└── docs/             # Documentation

Documentation

Known Limitations

• Player positions: Albion encrypts movement data. Players are detected but can't be shown on radar.
• Some Black Zone maps: Tiles for zone IDs 4000+ missing. Disable map background in settings as workaround.
• Resource charges: May differ from actual due to server-side harvest bonuses.

Contributing

Found a bug? Want to help? Open an issue or submit a PR.

Credits

Built by @Nouuu

Based on ZQRadar by @Zeldruck

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