Albion-Radar

KO | EN

gitlite — search

#video #php #electron #command-line #mcp #svg #privacy #redis #json #pdf

(★ 9)

Camel Radar is a local Albion Online radar and map utility for research, debugging, and desktop overlay experiments. It combines a React interface with an Express and WebSocket runtime to display Albion Online-related map, player, resource, chest, dungeon, fishing, and mist objective data.

파일 탐색기

ZIP 다운로드

- - bug_report.yml
  - config.yml
  - feature_request.yml
- PULL_REQUEST_TEMPLATE.md
- page-2026-07-03T19-52-58-424Z.yml
- page-2026-07-03T19-53-30-147Z.yml
- install.bat
- start.bat
- - BRIDGEWATCH.png
  - CAERLEON.png
  - FORTSTERLING.png
  - FRIENDLY.png
  - HOSTILE.png
  - LYMHURST.png
  - MARTLOCK.png
  - THETFORD.png
- - AVALONMINIONCHEST.png
  - blue.png
  - cage.png
  - corrupt.png
  - CRYSTALSPIDER.png
  - dungeon_0.png
  - dungeon_1.png
  - dungeon_2.png
  - dungeon_3.png
  - dungeon_4.png
  - EVENTEASTERCHEST1.png
  - EVENTEASTERCHEST2.png
  - FAIRYDRAGON.png
  - fiber_2_0.png
  - fiber_3_0.png
  - fiber_4_0.png
  - fiber_4_1.png
  - fiber_4_2.png
  - fiber_4_3.png
  - fiber_4_4.png
  - fiber_5_0.png
  - fiber_5_1.png
  - fiber_5_2.png
  - fiber_5_3.png
  - fiber_5_4.png
  - fiber_6_0.png
  - fiber_6_1.png
  - fiber_6_2.png
  - fiber_6_3.png
  - fiber_6_4.png
  - fiber_7_0.png
  - fiber_7_1.png
  - fiber_7_2.png
  - fiber_7_3.png
  - fiber_7_4.png
  - fiber_8_0.png
  - fiber_8_1.png
  - fiber_8_2.png
  - fiber_8_3.png
  - fiber_8_4.png
  - fish.png
  - green.png
  - GRIFFIN.png
  - group_0.png
  - group_1.png
  - group_2.png
  - group_3.png
  - group_4.png
  - hellgate.png
  - hide_1_0.png
  - hide_2_0.png
  - hide_3_0.png
  - hide_4_0.png
  - hide_4_1.png
  - hide_4_2.png
  - hide_4_3.png
  - hide_4_4.png
  - hide_5_0.png
  - hide_5_1.png
  - hide_5_2.png
  - hide_5_3.png
  - hide_5_4.png
  - hide_6_0.png
  - hide_6_1.png
  - hide_6_2.png
  - hide_6_3.png
  - hide_6_4.png
  - hide_7_0.png
  - hide_7_1.png
  - hide_7_2.png
  - hide_7_3.png
  - hide_7_4.png
  - hide_8_0.png
  - hide_8_1.png
  - hide_8_2.png
  - hide_8_3.png
  - hide_8_4.png
  - legendary.png
  - Logs_1_0.png
  - Logs_2_0.png
  - Logs_3_0.png
  - Logs_4_0.png
  - Logs_4_1.png
  - Logs_4_2.png
  - Logs_4_3.png
  - Logs_4_4.png
  - Logs_5_0.png
  - Logs_5_1.png
  - Logs_5_2.png
  - Logs_5_3.png
  - Logs_5_4.png
  - Logs_6_0.png
  - Logs_6_1.png
  - Logs_6_2.png
  - Logs_6_3.png
  - Logs_6_4.png
  - Logs_7_0.png
  - Logs_7_1.png
  - Logs_7_2.png
  - Logs_7_3.png
  - Logs_7_4.png
  - Logs_8_0.png
  - Logs_8_1.png
  - Logs_8_2.png
  - Logs_8_3.png
  - Logs_8_4.png
  - mist_0.png
  - mist_1.png
  - mist_2.png
  - mist_3.png
  - mist_4.png
  - ore_2_0.png
  - ore_3_0.png
  - ore_4_0.png
  - ore_4_1.png
  - ore_4_2.png
  - ore_4_3.png
  - ore_4_4.png
  - ore_5_0.png
  - ore_5_1.png
  - ore_5_2.png
  - ore_5_3.png
  - ore_5_4.png
  - ore_6_0.png
  - ore_6_1.png
  - ore_6_2.png
  - ore_6_3.png
  - ore_6_4.png
  - ore_7_0.png
  - ore_7_1.png
  - ore_7_2.png
  - ore_7_3.png
  - ore_7_4.png
  - ore_8_0.png
  - ore_8_1.png
  - ore_8_2.png
  - ore_8_3.png
  - ore_8_4.png
  - rare.png
  - rock_1_0.png
  - rock_2_0.png
  - rock_3_0.png
  - rock_4_0.png
  - rock_4_1.png
  - rock_4_2.png
  - rock_4_3.png
  - rock_5_0.png
  - rock_5_1.png
  - rock_5_2.png
  - rock_5_3.png
  - rock_6_0.png
  - rock_6_1.png
  - rock_6_2.png
  - rock_6_3.png
  - rock_7_0.png
  - rock_7_1.png
  - rock_7_2.png
  - rock_7_3.png
  - rock_8_0.png
  - rock_8_1.png
  - rock_8_2.png
  - rock_8_3.png
  - VEILWEAVER.png
- camel-logo.png
- screenshot-home.png
- screenshot-radar.png
- - PhotonCommand.ts
  - PhotonPacket.ts
  - PhotonPacketParser.ts
  - Protocol16Deserializer.ts
  - Protocol18Deserializer.ts
- - ChestsDrawing.ts
  - DungeonsDrawing.ts
  - FishingDrawing.ts
  - HarvestablesDrawing.ts
  - MapsDrawing.ts
  - MobsDrawing.ts
  - PlayersDrawing.ts
  - WispCageDrawing.ts
- - Protocol16Type.json
- - ChestsHandler.ts
  - DungeonsHandler.ts
  - FactionFlagInfo.ts
  - FishingHandler.ts
  - HandlerUtils.ts
  - HarvestablesHandler.ts
  - items.txt
  - ItemsInfo.ts
  - Map.ts
  - MobsHandler.ts
  - MobsInfo.ts
  - PlayersHandler.ts
  - WispCageHandler.ts
- - DrawingUtils.ts
  - EventCodes.ts
  - ItemsPage.ts
  - Settings.ts
  - Utils.ts
  - WebSocketConfig.ts
- tsconfig.json
- adapter-selector.ts
- index.ts
- player.mp3
- - utils.ts
- - globals.css
- App.tsx
- main.tsx
- vite-env.d.ts
- app.test.ts
- copy-runtime-assets.ts
.gitignore
.nvmrc
components.json
CONTRIBUTING.md
index.html
LICENSE
package-lock.json
package.json
README.id.md
README.md
tsconfig.json
tsconfig.legacy.json
tsconfig.node.json
tsconfig.server.json
vite.config.ts

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### Free, open-source **Albion Online radar** and map overlay. See nearby players, gatherable resources, enemies, chests, dungeons, and mists in real time.

Language: **English** | [Bahasa Indonesia](README.id.md)

[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://raw.githubusercontent.com/fizakbrr/Albion-Radar/main/LICENSE)
[![Platform: Windows](https://img.shields.io/badge/platform-Windows%2010%2F11-0078D6?logo=windows)](https://raw.githubusercontent.com/fizakbrr/Albion-Radar/main/)
[![Node.js](https://img.shields.io/badge/Node.js-20.20%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![Built with TypeScript](https://img.shields.io/badge/TypeScript-React-3178C6?logo=typescript&logoColor=white)](https://raw.githubusercontent.com/fizakbrr/Albion-Radar/main/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://raw.githubusercontent.com/fizakbrr/Albion-Radar/main/CONTRIBUTING.md)
[![Star this repo](https://img.shields.io/github/stars/fizakbrr/Albion-Radar?style=social)](https://github.com/fizakbrr/Albion-Radar/stargazers)

</div>

**Camel Radar** is a free, open-source **Albion Radar** for **Albion Online** — a local radar overlay and map tool that reads your own network traffic to show nearby players, gathering resources, mobs, enemies, chests, dungeons, fishing spots, and mist objectives in a clean browser-based UI. It runs entirely on your PC with passive packet capture (no injection, no memory reading, no third-party servers), and can also run in a no-capture demo mode for UI testing.

If you have been searching for an **Albion Online radar**, an **Albion gathering radar**, or an **Albion player radar** that is open source, actively maintained, and easy for non-technical players to install, this project is built for you.

> ⭐ **If this Albion radar is useful, please [star the repository](https://github.com/fizakbrr/Albion-Radar) — it helps other Albion Online players find it.**

---

## Screenshots

| Radar settings & filters | Live radar canvas |
| --- | --- |
| ![Albion Online radar settings UI showing player, resource, and enemy filters](https://raw.githubusercontent.com/fizakbrr/Albion-Radar/main/images/screenshot-home.png) | ![Albion radar live canvas overlay with local player marker and grid](https://raw.githubusercontent.com/fizakbrr/Albion-Radar/main/images/screenshot-radar.png) |

---

## Table of Contents

- [Why Camel Radar](#why-camel-radar)
- [Getting Started (No Coding Needed)](#getting-started-no-coding-needed)
- [Key Features](#key-features)
- [How It Works](#how-it-works)
- [Requirements](#requirements)
- [Installation](#installation)
- [Usage](#usage)
- [Configuration](#configuration)
- [FAQ](#faq-albion-radar)
- [Comparison with Other Albion Radars](#comparison-with-other-albion-radars)
- [Troubleshooting](#troubleshooting)
- [Contributing](#contributing)
- [Disclaimer](#disclaimer)
- [Credits](#credits)
- [License](#license)

---

## Why Camel Radar

- **Truly open source** — read every line of the packet parser and radar logic. No obfuscated binaries.
- **Passive & local** — captures your own UDP traffic on port `5056`. No game-client injection, no memory editing, no data leaves your machine.
- **Modern UI** — React + Tailwind interface instead of a cramped legacy overlay, with per-resource, per-tier, and per-enchant filters.
- **Beginner-friendly** — a step-by-step, no-coding setup guide plus double-click Windows scripts.
- **Actively maintained** — regular fixes, tests, and a clean TypeScript build pipeline.

## Getting Started (No Coding Needed)

This section is for players who just want to run this Albion Online radar while they play — no programming knowledge required. Follow the steps below in order. Each one only needs to be done once, except where noted.

### What you'll need

- A Windows 10 or 11 PC (the same PC you play Albion Online on).
- An internet connection.
- About 10 minutes for the first-time setup.

### Step 1 — Install Node.js

Node.js is the free program that lets Camel Radar run on your computer.

1. Go to [nodejs.org](https://nodejs.org) and download the **LTS** version (the button labeled
   "Recommended for Most Users").
2. Open the downloaded file and click **Next** through the installer using the default options.
3. Restart your computer once the install finishes.

### Step 2 — Download Camel Radar

1. Go to the [Camel Radar GitHub page](https://github.com/fizakbrr/Albion-Radar).
2. Click the green **Code** button, then click **Download ZIP**.
3. Find the downloaded ZIP file (usually in your `Downloads` folder), right-click it, and choose
   **Extract All...**. Pick a folder you'll remember, like your Desktop.

### Step 3 — Install Npcap (only needed to see live players/resources)

Camel Radar reads Albion Online's network traffic to show things on the radar. Npcap is the free
tool that lets it do that.

1. Go to [npcap.com/#download](https://npcap.com/#download) and download the Npcap installer.
2. Run the installer. When you reach the options screen, make sure **"Install Npcap in WinPcap
   API-compatible Mode"** is checked, then finish the install.

If you skip this step, Camel Radar will still open in your browser, but the radar will stay empty
since it can't read any game data.

### Step 4 — Install Camel Radar's components

1. Open the folder where you extracted Camel Radar.
2. Open the `bin` folder inside it.
3. Double-click **`install.bat`**.
4. A black window will open and show text scrolling by — this is normal, it's downloading
   everything Camel Radar needs. Wait until it says "Press any key to continue" and press any key
   to close it.

You only need to do this step once (or again later if you download a newer version of Camel Radar).

### Step 5 — Run Camel Radar

1. Go back to the `bin` folder.
2. Right-click **`start.bat`** and choose **Run as administrator** (Administrator access is needed
   so Camel Radar is allowed to read the game's network traffic).
3. The first time you run it, the black window will list your network connections with numbers next
   to them, like:
   ```text
   1. Wi-Fi          ip address: 192.168.1.25
   2. Ethernet        ip address: 192.168.1.30
   ```
   Type the number for the connection you use to play Albion Online (usually the only one with
   internet access) and press Enter. Camel Radar remembers your choice, so you won't be asked again.
4. Your web browser should open automatically to the Camel Radar page. Leave the black window open
   in the background — closing it stops Camel Radar.
5. Launch Albion Online and log in. The radar will start showing map data as you play.

### Every time after that

You don't need to repeat Steps 1–4. Just do **Step 5** again: right-click `start.bat` in the `bin`
folder and choose **Run as administrator**.

### Stopping Camel Radar

Close the browser tab, then close the black window (or click inside it and press `Ctrl+C`).

### If something doesn't work

- **Windows shows a blue "Windows protected your PC" screen** when installing Node.js or Npcap —
  this is normal for smaller, independent installers. Click **More info**, then **Run anyway**.
- **The radar page opens but stays empty** — Albion Online might not be running yet, or the wrong
  network connection was chosen in Step 5. Open the `bin` folder's parent folder, delete the file
  named `ip.txt` if you see one, and run `start.bat` again to choose the connection once more.
- **A firewall pop-up appears the first time you run it** — click **Allow access** so Camel Radar
  can talk to itself over your local network.
- **You want to try the interface without live game data** — open the Camel Radar folder (not the
  `bin` folder), and open a PowerShell window there (Shift + right-click inside the folder, then
  choose "Open PowerShell window here"), and run:
  ```powershell
  npm run start:no-capture
  ```

If you're comfortable with a terminal or want more control (custom ports, environment variables,
running tests, etc.), see the [Installation](#installation) and [Usage](#usage) sections below,
which cover the same setup using command-line steps instead of the helper scripts.

## Key Features

- **Albion Online player radar** — see nearby players with faction/flag coloring and optional alerts.
- **Albion gathering radar** — living and static resource overlays for fiber, hide, wood, ore, and rock, filterable by tier (T1–T8) and enchant (0–4).
- **Enemy & mob radar** — mobs, mini-bosses, bosses, mist bosses, drones, and event enemies with a minimum-health filter.
- **Chest, dungeon, fishing, and mist objective handlers** for full map awareness.
- Player list and equipment display when compatible data is available.
- Local **Express HTTP server with WebSocket streaming** for real-time updates.
- Modern **React, Vite, Tailwind CSS**, and shadcn-style UI components.
- Optional **passive packet capture** through Npcap and the native `cap` package — no injection.
- **No-capture mode** for development, demos, and UI testing without live Albion Online traffic.
- TypeScript build pipeline for the frontend, runtime scripts, server, and tests.

## How It Works

Camel Radar listens passively to the **Photon** UDP traffic (port `5056`) that Albion Online already
sends and receives on your own machine. It parses those packets locally (Protocol 16 and Protocol 18),
turns recognized events into map, player, resource, and objective data, and streams that to a local
browser UI over WebSocket. Nothing is injected into the game, no memory is read, and no data is sent
to any external server — the entire radar runs on `localhost`.

## Tech Stack

- TypeScript
- React
- Vite
- Tailwind CSS
- shadcn UI components
- Express
- WebSocket
- Node.js
- Npcap and `cap` for optional local packet capture
- Node test runner

## Requirements

- Windows 10/11
- Node.js `20.20.2` or newer
- npm `10.8.0` or newer

For live packet capture only:

- Npcap installed
- Visual Studio C++ build tools
- Administrator terminal
- Albion Online traffic on UDP port `5056`

The React UI, static routes, WebSocket tests, and parser fixture tests can run without packet capture.

## Installation

```powershell
git clone https://github.com/fizakbrr/Albion-Radar.git
cd Albion-Radar
npm ci
```

The native `cap` package is optional. If it cannot build on your machine, Camel Radar can still run as an Albion Online utility in no-capture mode.

## Usage

Run the Albion Online overlay UI without packet capture:

```powershell
npm run start:no-capture
```

Open:

```text
http://localhost:5001
```

Run with live local packet capture:

```powershell
npm start
```

On the first live-capture run, choose the network adapter used by Albion Online. The selected adapter IP is saved to `ip.txt`, which is ignored by git.

You can also pass the adapter directly:

```powershell
$env:CAMEL_RADAR_ADAPTER_IP = "192.168.1.25"
npm start
```

## Development Commands

Build the complete project:

```powershell
npm run build
```

Run the compiled Express backend after a build:

```powershell
npm run serve
```

Run the Vite frontend server for frontend iteration:

```powershell
npm run dev
```

Run tests:

```powershell
npm test
```

The test command builds the React frontend, compiles the TypeScript runtime and server, starts the server with capture disabled, verifies key UI/static/config routes, checks WebSocket payload shape, and exercises parser fixture buffers.

Windows helper scripts are available in `bin/`:

- `bin/install.bat`: runs `npm ci`
- `bin/start.bat`: runs `npm start`

## Configuration

Environment variables:

- `PORT`: HTTP UI port, default `5001`
- `WS_PORT`: WebSocket port, default `5002`
- `WS_HOST`: WebSocket host, default `localhost`
- `CAMEL_RADAR_CAPTURE`: `1` to attempt packet capture, `0` to disable it
- `CAMEL_RADAR_ADAPTER_IP`: IPv4 address of the capture adapter
- `CAMEL_RADAR_OPEN_BROWSER`: `1` to open the browser after start, `0` to skip it

Example:

```powershell
$env:PORT = "5101"
$env:WS_PORT = "5102"
$env:CAMEL_RADAR_CAPTURE = "0"
npm run serve
```

## FAQ: Albion Radar

**What is an Albion radar?**
An Albion radar is a tool that shows nearby players, gatherable resources, mobs, and other objects
from Albion Online on a separate map or overlay, giving you more awareness of your surroundings while
gathering, ganking, or avoiding PvP. Camel Radar is a free, open-source Albion Online radar you run
locally on your own PC.

**Is Camel Radar free?**
Yes. Camel Radar is completely free and open source under the ISC License. There is no paid tier,
subscription, or premium build.

**Does the Albion radar inject into the game or read memory?**
No. Camel Radar only passively reads the network traffic your own PC already sends and receives on
UDP port `5056`. It does not inject code into the Albion Online client, read game memory, or modify
any game files.

**Do I need to know how to code to use it?**
No. Follow the [Getting Started (No Coding Needed)](#getting-started-no-coding-needed) guide — it uses
double-click Windows scripts and takes about 10 minutes for first-time setup.

**Which operating systems are supported?**
Live packet capture is built and tested for Windows 10 and 11. The UI itself is browser-based, and the
no-capture demo mode can run anywhere Node.js runs.

**Why is my radar empty?**
The most common causes are that Albion Online isn't running, the wrong network adapter was selected,
or Npcap isn't installed. See [Troubleshooting](#troubleshooting).

**Can I get banned for using an Albion radar?**
Radar tools of this kind are against Albion Online's terms of service, and use is at your own risk.
Camel Radar is provided for educational and research purposes — see the [Disclaimer](#disclaimer).

## Comparison with Other Albion Radars

There are several open-source Albion Online radar projects (for example, ZQRadar, QRadar, and various
DEATHEYE forks). Camel Radar focuses on:

- A **modern React UI** with granular per-resource, per-tier, and per-enchant filters instead of a
  legacy overlay.
- A **beginner-friendly, no-coding setup guide** and double-click Windows scripts.
- A **clean, typed, tested codebase** (TypeScript, Node test runner) that is easy to read, fork, and
  extend.
- **Passive, local-only capture** with no injection and no external servers.

If you maintain another Albion radar and would like a fair, factual comparison entry here, open an
issue or pull request.

## Project Structure

```text
.
|-- server/                   # Express server, WebSocket server, adapter selection, and capture startup
|-- src/                      # React, Vite, Tailwind, and shadcn UI frontend
|-- scripts/
|   |-- Handlers/             # Albion Online entity, resource, map, player, and objective handlers
|   |-- Drawings/             # Canvas drawing helpers for radar and map overlays
|   |-- Utils/                # Runtime settings, event codes, WebSocket config, and browser entrypoints
|   |-- classes/              # Photon packet parser and protocol deserializers
|   `-- enumerations/         # Protocol type mappings
|-- tools/                    # Build-time asset copy utilities
|-- tests/                    # Node test runner coverage for server, WebSocket, parser, and resource data
|-- bin/                      # Optional Windows helper scripts
|-- images/                   # Local image assets used by the UI and overlay runtime
|-- sounds/                   # Audio assets used by radar alerts
|-- config/                   # Local runtime configuration, ignored by git
|-- tsconfig*.json            # TypeScript project configs
`-- package.json              # npm scripts, dependencies, and package metadata
```

Generated build output is written to `dist/`, `dist-runtime/`, `dist-server/`, and `dist-config/`.

## Troubleshooting

### UI starts but live data is empty

Confirm:

- Albion Online is running and connected to the world.
- The adapter IP in `ip.txt` matches the network adapter carrying Albion Online traffic.
- `CAMEL_RADAR_CAPTURE` is not set to `0`.
- No old Node process is occupying `5001` or `5002`.
- Npcap and the native `cap` package are installed correctly.

### Packet capture is unavailable

Use no-capture mode while you fix native dependencies:

```powershell
npm run start:no-capture
```

Then verify the native capture module:

```powershell
node -e "const { Cap } = require('cap'); console.log(Cap.deviceList())"
```

### Radar page opens but shows no player dots

Current Albion Online traffic can omit or protect exact live player coordinates. Camel Radar can still show supported identity, equipment, or entity data when packets are available, but it cannot draw exact dots without usable position data.

### TypeScript errors remain visible in the editor

Run `TypeScript: Restart TS Server` in VS Code. The repository uses separate TypeScript configs for the React app, legacy browser runtime, server runtime, and scripts folder.

## Contributing

Contributions are welcome and directly help this Albion radar improve and rank for more players to
find. See [CONTRIBUTING.md](CONTRIBUTING.md) for how to set up the project, run tests, and open a pull
request. Good first contributions include documentation improvements, new resource/enemy mappings, UI
polish, and bug fixes.

If you just want to help discoverability: **star the repo**, share it with your guild, and link to it
from Albion Online communities, wikis, and forums.

## GitHub Topics

This repository uses the following topics to help players discover it. Suggested topics:

- `albion-radar`
- `albion-online-radar`
- `albion-online`
- `albion-online-tools`
- `albion-online-utility`
- `albion-online-overlay`
- `albion-map-tool`
- `albion-gathering-radar`
- `radar`
- `game-utility`
- `desktop-utility`
- `open-source-game-tool`
- `typescript`
- `react`
- `websocket`
- `express`

## Disclaimer

This project is provided for educational and research purposes only. Using radar or overlay tools may
violate Albion Online's terms of service and can result in penalties, including account bans. Use it
responsibly and at your own risk, and respect the terms of service of any software, platform, or game
it interacts with. The maintainers are not responsible for misuse, account penalties, or violations of
third-party rules.

## Credits

Camel Radar is maintained by fizakbrr.

Original project work by Zeldruck. Additional upstream radar work by FashionFlora, legacy packet parsing work from `photon-packet-parser`, and Protocol 18 behavior cross-checked against AutoDruid's photon parser.

## License

This project is licensed under the ISC License. See the [LICENSE](LICENSE) file and the `license` field in `package.json`.

---

**Keywords:** Albion Radar · Albion Online Radar · Albion gathering radar · Albion player radar · Albion Online overlay · Albion map tool · free open-source Albion radar

If Camel Radar helped you, please [⭐ star the repository](https://github.com/fizakbrr/Albion-Radar) so more Albion Online players can find it.

</div>

Albion-Radar

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README