Loka Atlas

# Loka Waypoints

A client-side mod for Loka that brings a full interactive world map, live territory data, and an in-world waypoint system right into the game.

Press **M** to open the map for whichever continent you're currently on.

---

## Map Screen

- Full map for all **5 continents** — Kalros, Garama, Ascalon, Rivina, and Balak
- Continent tabs to switch between them instantly
- Zoom (scroll wheel) and pan (right-click drag)
- Search bar — find a territory by number, biome name, or town name
- Live cursor coordinates shown as you move your mouse over the map
- Middle-click anywhere to copy that spot's coordinates to your clipboard
- Manual refresh button (♻) to force-reload the current continent's data on demand 0(tuned for balak races)
- Clear on-screen message if Loka's map server is temporarily unreachable

Press Y to open a settings menu with a toggle to fully enable/disable the map — when disabled, M won't open the map and waypoints won't render at all

## Territory Info Panel

Click any tile to see:

- Biome name
- Conquest points
- Active mutator, with its real name and full description
- Active Balak buff, with its real name and description
- Modding/gathering item for that tile
- Infested / Red Infested status
- Which town or alliance controls that biome
- Owner, strength (or Balak Strength on Balak), and town level
- Live battle status — shows defender and attacker names and strength when a tile is under attack

## Map Icons

Every tile shows one clear icon, automatically picked by priority:

1. **Under Attack** — always shown first if a real battle is active
2. **Infested / Red Infested**
3. **Mutator icon** — unique art for every mutator currently in the game
4. **Balak buff icon** — unique art for every Balak buff
5. **Town home / Owned / Neutral** — otherwise

Docks and Resource Isles are also marked on the map with their own icons and real names, shown on hover.

## Ownership Overlay

- Territories are tinted with their owning town or alliance's real banner color
- Unclaimed tiles show a faint tint matching whichever town dominates that biome
- Follows all the rules biome control
- Refreshes automatically in the background

## Waypoints

- Every waypoint shows a real in-world beacon beam **and** a floating name + distance label, visible from anywhere on the continent — no render distance limit
- Right-click any territory tile to create a waypoint there — it uses the exact inhibitor location when available, and is automatically colored based on that tile's biome
- Right-click a Dock or Resource Isle to create a waypoint using its real name
- Right-click the same spot again to remove that waypoint
- `/testwaypoint <name>` — drop a quick waypoint at your current position, for testing
- `/lokawp clearwaypoints <continent>` — wipe all saved waypoints for a continent

---

More continents, mutators, and features get added as the server evolves — feedback and bug reports always welcome.